Hoppa till huvudinnehåll

​
iOS-app (Node)

Tillgänglighet: intern förhandsgranskning. iOS-appen distribueras inte offentligt ännu.

​
Vad den gör

  • Ansluter till en Gateway via WebSocket (LAN eller tailnet).
  • Exponerar nodfunktioner: Canvas, skärmbild, kamerainspelning, plats, samtalsläge, röstväckning.
  • Tar emot node.invoke-kommandon och rapporterar nodstatushändelser.

​
Krav

  • Gateway som körs på en annan enhet (macOS, Linux eller Windows via WSL2).
  • Nätverksväg:
    • Samma LAN via Bonjour, eller
    • Tailnet via unicast DNS-SD (exempeldomän: openclaw.internal.), eller
    • Manuell värd/port (reserv).

​
Snabbstart (para + anslut)

  1. Starta Gateway:
openclaw gateway --port 18789
  1. I iOS-appen öppnar du Inställningar och väljer en upptäckt gateway (eller aktiverar Manuell värd och anger värd/port).
  2. Godkänn parkopplingsförfrågan på gateway-värden: 
openclaw nodes pending
openclaw nodes approve <requestId>
  1. Verifiera anslutningen:
openclaw nodes status
openclaw gateway call node.list --params "{}"

​
Upptäcktsvägar

​
Bonjour (LAN)

Gateway annonserar _openclaw-gw._tcp på local.. iOS app listar dessa automatiskt.

​
Tailnet (över nätverk)

Om mDNS är blockerad, använd en unicast DNS-SD-zon (välj en domän; exempel: openclaw.internal.) och Tailscale split DNS. Se Bonjour för CoreDNS-exemplet.

​
Manuell värd/port

I Inställningar aktiverar du Manuell värd och anger gateway-värd + port (standard 18789).

​
Canvas + A2UI

iOS nod renderar en WKWebView canvas. Använd node.invoke för att köra den: 
openclaw nodes invoke --node "iOS Node" --command canvas.navigate --params '{"url":"http://<gateway-host>:18793/__openclaw__/canvas/"}'
Noteringar:
  • Gatewayns canvas-värd serverar /__openclaw__/canvas/ och /__openclaw__/a2ui/.
  • iOS-noden navigerar automatiskt till A2UI vid anslutning när en canvas-värd-URL annonseras.
  • Återgå till den inbyggda stommen med canvas.navigate och {"url":""}.
  • Återgå till den inbyggda stommen med canvas.navigate och {"url":""}.

​
Canvas eval / ögonblicksbild

openclaw nodes invoke --node "iOS Node" --command canvas.eval --params '{"javaScript":"(() => { const {ctx} = window.__openclaw; ctx.clearRect(0,0,innerWidth,innerHeight); ctx.lineWidth=6; ctx.strokeStyle=\"#ff2d55\"; ctx.beginPath(); ctx.moveTo(40,40); ctx.lineTo(innerWidth-40, innerHeight-40); ctx.stroke(); return \"ok\"; })()"}'

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

​
Röstväckning + samtalsläge

  • Röstväckning och samtalsläge är tillgängliga i Inställningar.
  • iOS kan pausa bakgrundsljud; behandla röstfunktioner som bästa möjliga när appen inte är aktiv.

​
Vanliga fel

  • NODE_BACKGROUND_UNAVAILABLE: ta iOS-appen till förgrunden (canvas-/kamera-/skärmkommandon kräver det).
  • A2UI_HOST_NOT_CONFIGURED: Gateway annonserade ingen canvas-värd-URL; kontrollera canvasHost i Gateway-konfiguration.
  • Parkopplingsprompten visas aldrig: kör openclaw nodes pending och godkänn manuellt.
  • Återanslutning misslyckas efter ominstallation: parkopplingstoken i nyckelringen rensades; para om noden.

​
Relaterad dokumentation