iOS App Einrichtung

Die OpenClaw iOS App ist kein kleines Gateway, das man einfach ins iPhone stopft. Sie ist eher ein mobiles Einsatzkit. Dein eigentliches Gateway bleibt auf einem Mac, Linux-Rechner oder Windows-System mit WSL2. Das iPhone verbindet sich mit diesem Gateway und bringt Sensoren und Oberflächen mit, die ein Desktop nicht in der Hosentasche trägt.

Genau diese Unterscheidung spart dir den falschen Setup-Plan. Wenn du erwartest, dass das Telefon die komplette Laufzeit übernimmt, wird es schnell unerquicklich. Wenn du es als vertrauenswürdigen Node mit mobilen Fähigkeiten behandelst, ergibt das Design plötzlich Sinn.

Was die iOS App tatsächlich ergänzt

Ein brauchbares Bild dafür ist dieses: Dein Gateway ist die Leitstelle, dein iPhone ist der Späher. Es kann sich bewegen, sehen, zuhören, dich wecken und aus Situationen berichten, in die dein Server niemals selbst gelangt.

• Canvas-Rendering auf dem Telefon
• Screen-Snapshots
• Kamera-Erfassung
• Standort-Signale
• Talk Mode und Voice Wake
• Node-Status und Presence-Updates zurück ans Gateway

Genau deshalb ist die App nützlich, obwohl sie das Gateway nicht selbst hostet. Sie erweitert OpenClaw in die physische Welt auf eine Art, die dein Serverregal schlicht nicht leisten kann.

Was du vor dem Start brauchst

• Ein funktionierendes OpenClaw Gateway auf macOS, Linux oder Windows mit WSL2
• Einen iPhone-Build der OpenClaw App, entweder aus interner Verteilung oder aus deinem eigenen Source-Build
• Einen Netzwerkpfad zwischen Telefon und Gateway
• Ein paar freie Minuten und ein Gerät, auf dem du Pairing freigeben kannst

Für das Netzwerk hast du realistisch drei Optionen:

1. Dasselbe LAN mit Discovery
2. Tailnet mit unicast DNS-SD
3. Manuelle Eingabe von Host und Port als Fallback

Wenn du neu bei OpenClaw bist, ist dasselbe LAN der am wenigsten nervige Einstieg.

Schritt 1: Starte zuerst das Gateway

Das Telefon kann sich nicht mit heißer Luft koppeln. Starte oder prüfe das Gateway auf dem Host-Rechner, bevor du die App anfasst.

openclaw gateway --port 18789

Dieser Standard-Port ist wichtig, weil viele spätere Beispiele davon ausgehen. Du kannst ihn ändern, musst dann aber überall konsequent bleiben.

Schritt 2: Entscheide, wie das iPhone das Gateway findet

Option A: Discovery im selben LAN

Das ist der glatte Weg. Wenn iPhone und Gateway im gleichen Netzwerk sind, kann die App das Gateway automatisch entdecken.

Option B: Tailnet

Das ist für die meisten Nutzer der bessere Remote-Weg. Du bekommst stabile Konnektivität, ohne das Gateway offen ins Internet zu hängen. Sauberer als heldenhafte Port-Forwarding-Experimente, die sich erst schlau anfühlen und später unerquicklich werden.

Option C: Manuelle Host- und Port-Eingabe

Nutze das, wenn Discovery scheitert oder dein Netzwerk etwas spezieller ist. Aktiviere in den iOS-App-Einstellungen Manual Host und trage Gateway-Host plus Port ein. Standard ist 18789.

Schritt 3: Koppel das iPhone mit dem Gateway

Sobald die App das Gateway sieht, wähle es in den Einstellungen aus. Die App fordert dann Pairing an. Die Freigabe passiert auf dem Gateway-Host, nicht auf dem Telefon.

openclaw devices list
openclaw devices approve <requestId>

Eine kleine Stolperfalle: Wenn die App mit geänderten Auth-Details erneut anfragt, kann die alte offene Anfrage durch eine neue ersetzt werden. Wenn die Freigabe scheitert, führe openclaw devices list erneut aus und nimm die frische Request-ID statt einer veralteten.

Schritt 4: Prüfe, ob der Node wirklich verbunden ist

Verlass dich nicht auf Bauchgefühl. Prüfe den Node von der Gateway-Seite aus.

openclaw nodes status
openclaw gateway call node.list --params "{}"

Du willst sehen, dass das iPhone als Node mit aktiven Fähigkeiten auftaucht. Wenn es fehlt, hast du noch kein funktionierendes Setup, sondern nur Hoffnung.

Was heute schon gut funktioniert

Im Moment ist die iOS App am stärksten, wenn du sie im Vordergrund hältst und als aktiven Device-Node nutzt. Das deckt mehr ab, als viele erst vermuten:

• Chat und Operator-Session-Zugriff
• Canvas-Präsentation und Navigation
• Kamera-Snapshot oder Clip-Erfassung
• Screen-Tools
• Standortgetriebene Automationssignale
• Share-Extension-Übergabe in eine verbundene Session

Damit entstehen schon heute echte Workflows. Dein Agent kann sehen, was die iPhone-Kamera erfasst, bei Ankunft an einem Ort ein Standortsignal bekommen oder direkt auf dem Gerät eine Canvas-Oberfläche anzeigen.

Die Grenzen, die du kennen solltest, bevor du zu viel versprichst

iOS kümmert sich intensiv um Akku, Privatsphäre und die Frage, ob eine App im Hintergrund weiter existieren darf. Das heißt: Einige OpenClaw-Verhalten sind heute Best-Effort, nicht garantiert.

• Vordergrundnutzung ist aktuell der zuverlässige Modus
• Hintergrund-Sockets können suspendiert werden
• canvas.*, camera.*, screen.* und talk.* sind im Hintergrund eingeschränkt
• Hintergrund-Standort braucht Always-Berechtigung
• Eine Neuinstallation der App kann den Pairing-Status löschen und erneutes Koppeln erzwingen

Nützliche Testbefehle nach dem Pairing

Sobald der Node sichtbar ist, kannst du vom Gateway-Host aus einen kleinen Canvas-Test fahren.

openclaw nodes invoke --node "iOS Node" --command canvas.navigate --params '{"url":"http://<gateway-host>:18789/__openclaw__/canvas/"}'

openclaw nodes invoke --node "iOS Node" --command canvas.snapshot --params '{"maxWidth":900,"format":"jpeg"}'

Wenn Befehle mit Hintergrundfehlern scheitern, hol die App in den Vordergrund und versuche es erneut. Das ist kein Bedienfehler von dir, sondern die momentane Betriebsrealität.

Fehlerbehebung

Der Pairing-Prompt scheint nie fertig zu werden

Prüfe offene Anfragen direkt auf dem Gateway-Host mit openclaw devices list. Die App kann eine neuere Anfrage erzeugt haben als die, die du zuerst gesehen hast.

Der Node taucht kurz auf und verschwindet wieder

Das deutet oft auf Netzwerk-Erreichbarkeit oder iOS-Hintergrund-Suspendierung hin. Teste zuerst im selben LAN. Wenn das sauber läuft, liegt dein eigentliches Problem eher im Remote-Pfad.

Canvas meldet, dass kein Host konfiguriert ist

Dann hat das Gateway die Canvas-Host-URL meist nicht korrekt beworben. Prüfe die Canvas-Plugin-Host-Konfiguration auf dem Gateway.

Reconnect scheitert nach Neuinstallation der App

Eine Neuinstallation kann das Keychain-Pairing-Token löschen. Koppel das iPhone neu, statt zu versuchen, den alten Vertrauenszustand zu reanimieren.

Standort-Automationen feuern im Hintergrund nicht

Bestätige, dass die App Always-Standortberechtigung hat und dein Ablauf auf echten Bewegungsereignissen basiert, nicht auf Dauer-Polling.

Best Practices

• Starte mit Pairing im selben LAN, bevor du Remote-Zugriff versuchst
• Halte das Gateway auf einem stabilen Host und behandle das Telefon als Node, nicht als Kernlaufzeit
• Prüfe Pairing und Node-Status per CLI, nicht nur über die App-Oberfläche
• Plane zuerst Workflows, die im Vordergrund gut funktionieren
• Nutze Tailnet-artige Netzwerke, wenn du entfernte Erreichbarkeit ohne öffentliche Exponierung willst

Zusammenfassung

Die OpenClaw iOS App ist spannend, weil sie deinem Agenten einen Telefonkörper gibt, nicht weil sie das Gateway ersetzt. Koppel sie mit einem stabilen Host, halte deine Erwartungen zum Hintergrundverhalten realistisch und konzentriere dich auf Workflows, bei denen ein mobiler Node etwas liefert, das dein Server nie liefern kann.

Wenn du so startest, wirkt die App weniger wie eine fragile Preview und mehr wie ein ziemlich fähiger Späher. Das ist ein guter Anfang.