Przejdź do głównej treści

​
Aplikacja iOS (Węzeł)

Dostępność: wewnętrzna wersja preview. Aplikacja iOS nie jest jeszcze publicznie dystrybuowana.

​
Co robi

  • Łączy się z Gateway przez WebSocket (LAN lub tailnet).
  • Udostępnia możliwości węzła: Canvas, zrzut ekranu, przechwytywanie z kamery, lokalizacja, tryb rozmowy, wybudzanie głosem.
  • Odbiera polecenia node.invoke i raportuje zdarzenia stanu węzła.

​
Wymagania

  • Gateway uruchomiony na innym urządzeniu (macOS, Linux lub Windows przez WSL2).
  • Ścieżka sieciowa:
    • Ta sama sieć LAN przez Bonjour, lub
    • Tailnet przez unicast DNS-SD (przykładowa domena: openclaw.internal.), lub
    • Ręczny host/port (tryb awaryjny).

​
Szybki start (parowanie + połączenie)

  1. Uruchom Gateway:
openclaw gateway --port 18789
  1. W aplikacji iOS otwórz Ustawienia i wybierz wykryty gateway (lub włącz Ręczny host i wprowadź host/port).
  2. Zatwierdź żądanie parowania na hoście Gateway: 
openclaw nodes pending
openclaw nodes approve <requestId>
  1. Zweryfikuj połączenie:
openclaw nodes status
openclaw gateway call node.list --params "{}"

​
Ścieżki wykrywania

​
Bonjour (LAN)

Gateway ogłasza _openclaw-gw._tcp na local.. Aplikacja iOS automatycznie je wyświetla.

​
Tailnet (między sieciami)

Jeśli mDNS jest blokowane, użyj strefy unicast DNS-SD (wybierz domenę; przykład: openclaw.internal.) oraz Tailscale split DNS. Zobacz Bonjour dla przykładu CoreDNS.

​
Ręczny host/port

W Ustawieniach włącz Ręczny host i wprowadź host gateway + port (domyślnie 18789).

​
Canvas + A2UI

Węzeł iOS renderuje canvas WKWebView. Użyj node.invoke, aby nim sterować: 
openclaw nodes invoke --node "iOS Node" --command canvas.navigate --params '{"url":"http://<gateway-host>:18793/__openclaw__/canvas/"}'
Uwagi:
  • Host canvas Gateway serwuje /__openclaw__/canvas/ oraz /__openclaw__/a2ui/.
  • Jest udostępniane przez serwer HTTP Gateway (ten sam port co gateway.port, domyślnie 18789).
  • Węzeł iOS automatycznie przechodzi do A2UI po połączeniu, gdy ogłoszony jest adres URL hosta canvas.
  • Wróć do wbudowanego szkieletu za pomocą canvas.navigate oraz {"url":""}.

​
Eval / zrzut canvas

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"}'

​
Wybudzanie głosem + tryb rozmowy

  • Wybudzanie głosem i tryb rozmowy są dostępne w Ustawieniach.
  • iOS może wstrzymywać dźwięk w tle; traktuj funkcje głosowe jako „best‑effort”, gdy aplikacja nie jest aktywna.

​
Typowe błędy

  • NODE_BACKGROUND_UNAVAILABLE: przenieś aplikację iOS na pierwszy plan (polecenia canvas/kamery/ekranu tego wymagają).
  • A2UI_HOST_NOT_CONFIGURED: Gateway nie ogłosił adresu URL hosta canvas; sprawdź canvasHost w Konfiguracji Gateway.
  • Monit parowania nigdy się nie pojawia: uruchom openclaw nodes pending i zatwierdź ręcznie.
  • Ponowne łączenie nie działa po reinstalacji: token parowania w Pęku kluczy został wyczyszczony; sparuj węzeł ponownie.

​
Powiązana dokumentacja