Dein OpenClaw, auch unterwegs. Bereite einen vom iPhone erreichbaren Zugang vor und kopple Miracles mit deinem Gateway. Für private Setups empfehlen wir Tailscale.
Miracles ist der native iPhone-/iPad-Client für deinen vorhandenen OpenClaw-Gateway; ein gehosteter Gateway oder KI-Account ist nicht enthalten. Die Verbindung und normale Chats benötigen kein Miracles Pro.
Das brauchst du
Ein iPhone oder iPad mit iOS beziehungsweise iPadOS 26 oder neuer und der kostenlosen Miracles-App.
Ein eigener laufender OpenClaw-Server (Gateway) mit einem Agenten. Er kann ein lokales Modell, zum Beispiel über Ollama, oder einen von dir gewählten KI-Anbieter nutzen. Ein kostenpflichtiger KI-Anbieter ist nicht erforderlich; lokale Modelle benötigen geeignete Hardware.
Eine vom iPhone erreichbare HTTPS/WSS-Adresse mit gültigem, vertrauenswürdigem TLS-Zertifikat. Tailscale ist empfohlen, aber nicht erforderlich.
Prüfe die unterstützten Funktionen deiner installierten OpenClaw-Version. Der Gateway-Rechner muss eingeschaltet und erreichbar bleiben.
DEIN WEG ZUM GATEWAY
Mehrere Wege. Eine sichere Verbindung.
Tailscale ist unsere Empfehlung, keine Voraussetzung. Miracles verbindet sich über HTTPS/WSS mit deinem OpenClaw-Gateway — über den Netzwerkweg, der zu dir passt.
Privat · auch unterwegs
Dein Gateway bleibt privat.
Der einfachste Einstieg für dein persönliches Setup: Tailscale verbindet dein iPhone oder iPad und den Gateway-Rechner in einem privaten Netzwerk. Die Geräte müssen nicht im selben WLAN sein — die Verbindung funktioniert auch unterwegs. Tailscale Serve stellt die sichere Gateway-Adresse bereit — ohne Router-Portfreigabe und ohne öffentlichen Gateway.
Installiere Tailscale auf deinem iPhone beziehungsweise iPad und auf dem Rechner, auf dem OpenClaw läuft. Verbinde beide Geräte mit demselben privaten Tailscale-Netzwerk („Tailnet“); dessen Zugriffsregeln müssen die Verbindung erlauben.
Tailscale Serve mit gültiger HTTPS-Adresse zum richtigen Gateway-Port. Der Gateway kann auf Loopback gebunden bleiben.
Halte Tailscale auf deinem Mobilgerät verbunden, solange du diesen privaten Zugang nutzt — auch im selben WLAN wie der Gateway-Rechner. Miracles installiert oder aktiviert Tailscale nicht selbst. Der Personal-Tarif ist für private Nutzung gedacht; für geschäftliche Nutzung gelten andere Bedingungen.
Ohne VPN · für verwaltete Setups
Deine eigene sichere Internetadresse.
Ein öffentlich erreichbarer Gateway kann ohne Tailscale genutzt werden. Ein passend eingerichteter Reverse Proxy oder Cloudflare Tunnel stellt die HTTPS/WSS-Adresse bereit. Das erfordert einen bewusst abgesicherten Gateway-Betrieb.
Das muss passen
Gültiges TLS-Zertifikat und durchgängige WebSocket-Unterstützung bis zum Gateway.
Gateway-Authentifizierung und Gerätekopplung beibehalten; keine anonyme Freigabe. Proxy-Vertrauen nach der installierten OpenClaw-Dokumentation konfigurieren.
Die Adresse muss für den nativen Client direkt erreichbar sein: kein vorgeschalteter Browser-Login, keine zusätzlichen Access-Service-Token-Header.
Privat · vorhandenes Netzwerk
Nutze den Zugang, den du schon hast.
Auch ein anderes VPN kann den Netzwerkweg bereitstellen, zum Beispiel ein vorhandenes WireGuard-Setup. Miracles verwendet die erreichbare Gateway-Adresse, nicht eine bestimmte VPN-App.
Das muss passen
Das VPN auf dem iPhone muss DNS und Routing zum Gateway bereitstellen; Firewallregeln müssen den Zugriff erlauben.
Zusätzlich zum VPN brauchst du HTTPS/WSS mit einem auf dem iPhone vertrauenswürdigen, zum Hostnamen passenden Zertifikat.
Gateway-Anmeldung und Gerätefreigabe bleiben erforderlich. Die konkrete VPN-Konfiguration muss separat geprüft werden.
Zu Hause · im selben Netz
Verbinde dich in deinem eigenen Netzwerk.
Ohne Tailscale oder ein anderes VPN kannst du Miracles im selben lokalen Netzwerk verwenden, wenn dort ein eigener sicherer HTTPS/WSS-Zugang zum Gateway eingerichtet ist. Dasselbe WLAN allein genügt dafür nicht und ersetzt keine Tailscale-Verbindung zu einer privaten Tailscale-Serve-Adresse. Außerhalb dieses Netzwerks brauchst du einen der anderen Wege.
Das muss passen
iPhone und Gateway müssen sich im Netz erreichen können. Lokalen Netzwerkzugriff in iOS erlauben, falls danach gefragt wird.
Eine HTTPS/WSS-Adresse mit gültigem, vom iPhone vertrauenswürdigem Zertifikat; auch im LAN wird unverschlüsseltes WS abgelehnt.
Ein nur an localhost gebundener Gateway ist vom iPhone nicht direkt erreichbar. Nutze einen passend begrenzten TLS-Proxy oder eine bewusst konfigurierte Netzfreigabe — mit Authentifizierung.
Für jeden Weg gilt
Dein Gateway muss vom iPhone erreichbar sein und das von Miracles unterstützte OpenClaw-Protokoll sprechen. Die Adresse braucht ein gültiges, vom Gerät vertrauenswürdiges TLS-Zertifikat. HTTPS wird als WSS verwendet; unverschlüsseltes HTTP/WS wird nicht akzeptiert. Ein VPN ersetzt diese TLS-Verbindung nicht.
Netzwerk und Anmeldung sind zwei verschiedene Dinge.
Der Netzwerkweg bringt dich zum Gateway. Anmelden kannst du dich mit Einrichtungscode, Gateway-Token oder Passwort — passend zu seiner Konfiguration. „Tailscale-Identität“ ist eine separate Anmeldeoption, die der Gateway ausdrücklich unterstützen muss; Tailscale allein ersetzt weder Anmeldung noch Gerätefreigabe. Diese Zugangsdaten melden dein Gerät am Server an. Sie sind keine API-Schlüssel eines KI-Anbieters und schalten keine kostenpflichtigen Miracles-Funktionen frei. Nach der Kopplung verwendet Miracles seinen eigenen Gerätetoken.
Miracles richtet kein VPN und keinen Tunnel ein. Vorgeschaltete Browser-Logins, etwa eine interaktive Cloudflare-Access-Anmeldung, und zusätzliche Proxy-Authentifizierung sind kein unterstützter Einrichtungsweg. Bei einem TLS-Proxy gehört dessen Betreiber zum Datenweg; beachte seine Zugriffs- und Datenschutzeinstellungen.
01
Deinen Netzwerkweg vorbereiten
Wähle oben den passenden Verbindungsweg. Wenn du neu anfängst, empfehlen wir Tailscale auf iPhone und Gateway-Rechner mit Tailscale Serve. Ein vorhandener geeigneter HTTPS-Zugang, ein anderes VPN oder dein LAN kann ebenfalls verwendet werden.
Prüfe, dass die HTTPS/WSS-Adresse vom iPhone erreichbar ist und ein gültiges TLS-Zertifikat verwendet. Miracles richtet die Netzwerkinfrastruktur nicht selbst ein. Dein Netzwerkweg und die folgende Gateway-Anmeldung sind unabhängig voneinander.
02
Dein iPhone koppeln
Tippe in Miracles auf „Miracles einrichten“, dann auf „Los geht’s“. Nach der Vorbereitung führt „Ich habe meine Zugangsdaten“ zur Eingabe oder zum QR-Scanner. Öffne deine OpenClaw Web UI → Settings → Devices → Pair device und wähle Full access, dann Create setup code. Lass diese Seite geöffnet. Scanne den QR-Code oder verwende die manuelle Eingabe.
Der geführte Ablauf übernimmt die Adresse aus einem gültigen QR- oder Einrichtungscode. Prüfe sie und tippe auf „Sicher verbinden“. Bestätige anschließend die Verbindungsfreigabe für diesen Gateway; sie ist von der späteren KI-Datenweitergabe getrennt. Die manuelle Eingabe steht im selben Einrichtungsschritt bereit: Einrichtungscode, Gateway-Token, Passwort oder ausdrücklich unterstützte Tailscale-Identität. Die Erklärung findest du getrennt unter „Anleitung zur Einrichtung“.
In älteren OpenClaw-Versionen heißt der Einstieg möglicherweise „Pair mobile device“. Mit „New code“ ersetzt du einen vorhandenen Code. Zeigt deine Version nur Gateway-Adresse und Token oder Passwort, gib diese mit der passenden Anmeldeart manuell ein.
03
Freigeben. Hallo sagen.
Falls der Gateway eine Gerätefreigabe verlangt, zeigt Miracles eine eigene Warteseite. Prüfe in OpenClaw die Miracles-Anfrage und den Gerätefingerabdruck und bestätige dein Gerät. Miracles prüft automatisch erneut, solange die App geöffnet ist. Manche Einrichtungscodes bestätigen die Kopplung bereits direkt.
Nach bestätigter Verbindung öffnet sich die KI-Datenweitergabe. Prüfe die Angaben und entscheide ausdrücklich über das Senden von Inhalten. Erst dann öffnet sich dein Gesprächsraum. Wähle einen Agenten und ein Gespräch und prüfe eine harmlose Testnachricht sowie die Wiederverbindung.
Dein Agent kann dir helfen.
Kopiere diesen Auftrag in die private Unterhaltung mit deinem OpenClaw-Agenten. Er soll den tatsächlichen Zustand prüfen und dir die zu deiner Installation passenden Schritte nennen.
Miracles ist ein nativer iPhone-/iPad-Client für Chats und Sprachgespräche mit Agenten auf meinem eigenen OpenClaw-Gateway. Die App verbindet sich direkt damit; sie stellt weder einen Gateway noch einen KI-Account bereit. Hilf mir bei der Verbindung.
Prüfe anhand der installierten Dokumentation die aktive Gateway-Instanz, Version, Anmeldung und den vorhandenen Netzwerkweg. Miracles braucht vom iPhone erreichbares HTTPS/WSS mit gültigem, vertrauenswürdigem TLS-Zertifikat, ohne Browser-Login oder zusätzliche Proxy-Auth-Header. Nutze einen geeigneten vorhandenen Zugang; für einen neuen privaten Zugang ist Tailscale Serve empfohlen. Besprich nötige Netzwerkänderungen mit mir, bevor du sie umsetzt; erhalte Authentifizierung und bestehende Routen und sichere geänderte Einstellungen. Prüfe bei Einrichtungscodes auch die darin enthaltene erreichbare Gateway-Adresse und, falls unterstützt, plugins.entries.device-pair.config.publicUrl.
Führe mich durch Devices → Pair device → Full access → Create setup code oder die passende Anmeldung mit Gateway-Token oder Passwort, je nach Version. Zugangsdaten gebe ich nur in Miracles ein, nicht in den Chat. Ordne eine ausstehende Gerätefreigabe meinem Versuch und Fingerabdruck zu. Danach prüfe ich in Miracles die KI-Datenweitergabe und bestätige sie selbst. Teste mit mir eine harmlose Nachricht und die Wiederverbindung. Fehlt dir Zugriff, erkläre die konkreten manuellen Schritte.
KI-Datenweitergabe in Miracles
Nach der bestätigten Gateway-Verbindung öffnet die geführte Einrichtung automatisch die KI-Datenweitergabe. Du kannst die Angaben später unter Einstellungen → KI-Datenweitergabe erneut prüfen. Miracles ruft die Gateway-Konfiguration ab und zeigt mögliche KI-Anbieter und konfigurierte Serveradressen. Keine Empfängerdatei und keine zusätzliche Gateway-Installation sind nötig. Erst deine gesonderte Zustimmung erlaubt das Senden. Fotos und Dateien bleiben bis zum Senden im lokalen Entwurf.
Was die Angaben leisten
Die Anzeige beschreibt mögliche Routen aus Konfiguration und Modellkatalog, nicht den vollständigen Empfängerkreis jeder Nachricht. Werkzeuge, Erweiterungen und Weiterleitungsdienste können weitere Empfänger verwenden. Bei eigenen Endpunkten kann Miracles Betreiber und Bedingungen nicht automatisch verifizieren. Prüfe die Dienste deines Gateways vor sensiblen Inhalten. Erkannte Änderungen der angezeigten Routen erfordern neue Zustimmung; externe Änderungen sind nicht vollständig erkennbar. Ohne abrufbare Konfiguration bleibt das Senden gesperrt.
Ist alles bereit?
Sende eine harmlose Testnachricht und prüfe, ob dein Agent antwortet. Kehre nach einem kurzen App-Wechsel zurück und prüfe die Wiederverbindung.
Wenn du Miracles unterwegs nutzen möchtest, teste den Zugang auch ohne dein Heim-WLAN. Bei einem privaten Tailscale-Zugang muss Tailscale weiterhin verbunden sein.
Ein abgelaufener oder unvollständiger Einrichtungscode braucht einen neuen Code. Eine nicht erreichbare Adresse dagegen braucht einen funktionierenden Netzwerkweg – erneutes Koppeln allein hilft nicht.
Miracles