Naar hoofdinhoud gaan

​
Android-app (Node)

​
Supportoverzicht

​
Systeembeheer

Systeembeheer (launchd/systemd) bevindt zich op de Gateway-host. Zie Gateway.

​
Verbindingsrunbook

Android-node-app ⇄ (mDNS/NSD + WebSocket) ⇄ Gateway Android verbindt direct met de Gateway WebSocket (standaard ws://<host>:18789) en gebruikt door de Gateway beheerde koppeling.

​
Vereisten

  • Je kunt de Gateway draaien op de “master”-machine.
  • Android-apparaat/emulator kan de Gateway WebSocket bereiken:
    • Zelfde LAN met mDNS/NSD, of
    • Dezelfde Tailscale tailnet met Wide-Area Bonjour / unicast DNS-SD (zie hieronder), of
    • Handmatige gateway host/poort (fallback)
  • Je kunt de CLI (openclaw) draaien op de gatewaymachine (of via SSH).

​
1. Start de Gateway

openclaw gateway --port 18789 --verbose
Bevestig in de logs dat je iets ziet als:
  • listening on ws://0.0.0.0:18789
Voor tailnet-only opstellingen (aanbevolen voor Wenen ⇄ Londen), bind de Gateway aan het tailnet-IP:
  • Stel gateway.bind: "tailnet" in ~/.openclaw/openclaw.json in op de Gateway-host.
  • Herstart de Gateway / macOS-menubalk-app.

​
2. Discovery verifiëren (optioneel)

Vanaf de gatewaymachine: 
dns-sd -B _openclaw-gw._tcp local.
Meer debugnotities: Bonjour.

​
Tailnet (Wenen ⇄ Londen) discovery via unicast DNS-SD

Android NSD/mDNS-discovery gaat niet over netwerken heen. Als je Android-node en de Gateway zich op verschillende netwerken bevinden maar via Tailscale verbonden zijn, gebruik dan Wide-Area Bonjour / unicast DNS-SD:
  1. Zet een DNS-SD-zone op (bijvoorbeeld openclaw.internal.) op de Gateway-host en publiceer _openclaw-gw._tcp-records.
  2. Configureer Tailscale split DNS voor je gekozen domein, verwijzend naar die DNS-server.
Details en voorbeeld CoreDNS-config: Bonjour.

​
3. Verbinden vanaf Android

In de Android-app:
  • De app houdt de gatewayverbinding actief via een foreground service (persistente notificatie).
  • Open Instellingen.
  • Selecteer onder Ontdekte Gateways je gateway en tik op Verbinden.
  • Als mDNS geblokkeerd is, gebruik Geavanceerd → Handmatige Gateway (host + poort) en Verbinden (handmatig).
Na de eerste succesvolle koppeling maakt Android bij het starten automatisch opnieuw verbinding:
  • Handmatig eindpunt (indien ingeschakeld), anders
  • De laatst ontdekte gateway (best effort).

​
4. Koppeling goedkeuren (CLI)

Op de gatewaymachine: 
openclaw nodes pending
openclaw nodes approve <requestId>
Koppelingsdetails: Gateway-koppeling.

​
5. Controleren of de node verbonden is

  • Via nodes-status: 
    openclaw nodes status
  • Via de Gateway: 
    openclaw gateway call node.list --params "{}"

​
6. Chat + geschiedenis

Het Chat-blad van de Android-node gebruikt de primaire sessiesleutel van de gateway (main), waardoor geschiedenis en antwoorden worden gedeeld met WebChat en andere clients:
  • Geschiedenis: chat.history
  • Verzenden: chat.send
  • Push-updates (best effort): chat.subscribe → event:"chat"

​
7. Canvas + camera

​
Gateway Canvas Host (aanbevolen voor webcontent)

Als je wilt dat de node echte HTML/CSS/JS toont die de agent op schijf kan bewerken, wijs de node dan naar de Gateway canvas host. Opmerking: nodes laden canvas vanaf de Gateway HTTP-server (dezelfde poort als gateway.port, standaard 18789).
  1. Maak ~/.openclaw/workspace/canvas/index.html aan op de Gateway-host.
  2. Navigeer de node ernaartoe (LAN): 
openclaw nodes invoke --node "<Android Node>" --command canvas.navigate --params '{"url":"http://<gateway-hostname>.local:18793/__openclaw__/canvas/"}'
Tailnet (optioneel): als beide apparaten op Tailscale zitten, gebruik een MagicDNS-naam of tailnet-IP in plaats van .local, bijv. http://<gateway-magicdns>:18793/__openclaw__/canvas/. Deze server injecteert een live-reload-client in HTML en herlaadt bij bestandswijzigingen. De A2UI-host bevindt zich op http://<gateway-host>:18793/__openclaw__/a2ui/. Canvas-opdrachten (alleen foreground):
  • canvas.eval, canvas.snapshot, canvas.navigate (gebruik {"url":""} of {"url":"/"} om terug te keren naar de standaard scaffold). canvas.snapshot retourneert { format, base64 } (standaard format="jpeg").
  • A2UI: canvas.a2ui.push, canvas.a2ui.reset (canvas.a2ui.pushJSONL legacy-alias)
Camera-opdrachten (alleen foreground; permissie-afhankelijk):
  • camera.snap (jpg)
  • camera.clip (mp4)
Zie Camera-node voor parameters en CLI-hulpmiddelen.