Android-app

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Ondersteuningssnapshot

• Rol: begeleidende Node-app (Android host de Gateway niet).
• Gateway vereist: ja (voer deze uit op macOS, Linux of Windows via WSL2).
• Installatie: Aan de slag + Koppelen.
• Gateway: Runbook + Configuratie.
  • Protocollen: Gateway-protocol (Nodes + control plane).

​

Systeembeheer

​

Verbindingsrunbook

• Voorkeur: Tailscale Serve / Funnel met https://<magicdns> / wss://<magicdns>
• Ook ondersteund: elke andere wss:// Gateway-URL met een echt TLS-endpoint
• Cleartext ws:// blijft ondersteund op privé-LAN-adressen / .local-hosts, plus localhost, 127.0.0.1 en de Android-emulatorbrug (10.0.2.2)

​

Vereisten

• Je kunt de Gateway uitvoeren op de “master”-machine.
• Android-apparaat/emulator kan de Gateway-WebSocket bereiken:
  • Zelfde LAN met mDNS/NSD, of
  • Zelfde Tailscale-tailnet met Wide-Area Bonjour / unicast DNS-SD (zie hieronder), of
  • Handmatige Gateway-host/poort (fallback)
• Mobiele koppeling via tailnet/openbaar gebruikt geen ruwe tailnet-IP-ws://-endpoints. Gebruik in plaats daarvan Tailscale Serve of een andere wss://-URL.
• Je kunt de CLI (openclaw) uitvoeren op de Gateway-machine (of via SSH).

​

1) Start de Gateway

openclaw gateway --port 18789 --verbose

• listening on ws://0.0.0.0:18789

openclaw gateway --tailscale serve

​

2) Controleer discovery (optioneel)

dns-sd -B _openclaw-gw._tcp local.

openclaw gateway discover --json

​

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

1. Stel een DNS-SD-zone in (voorbeeld openclaw.internal.) op de Gateway-host en publiceer _openclaw-gw._tcp-records.
2. Configureer Tailscale split DNS voor je gekozen domein dat naar die DNS-server wijst.

​

3) Verbinden vanaf Android

• De app houdt de Gateway-verbinding actief via een foreground service (blijvende melding).
• Open het tabblad Verbinden.
• Gebruik de modus Setupcode of Handmatig.
• Als discovery is geblokkeerd, gebruik dan handmatige host/poort in Geavanceerde bediening. Voor privé-LAN-hosts werkt ws:// nog steeds. Voor Tailscale/openbare hosts schakel je TLS in en gebruik je een wss://- / Tailscale Serve-endpoint.

• Handmatig endpoint (indien ingeschakeld), anders
• De laatst gevonden Gateway (best-effort).

​

Aanwezigheidsalive-beacons

​

4) Koppeling goedkeuren (CLI)

openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>

{
  gateway: {
    nodes: {
      pairing: {
        autoApproveCidrs: ["192.168.1.0/24"],
      },
    },
  },
}

​

5) Controleer of de Node is verbonden

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

​

6) Chat + geschiedenis

• Geschiedenis: chat.history (weergavegenormaliseerd; inline directivetags worden uit zichtbare tekst gestript, plaintext XML-payloads voor toolcalls (waaronder <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls> en afgekapt toolcall-blokken) en gelekte ASCII-/full-width modelcontroletokens worden gestript, pure silent-token-assistentrijen zoals exact NO_REPLY / no_reply worden weggelaten, en te grote rijen kunnen worden vervangen door placeholders)
• Verzenden: chat.send
• Pushupdates (best-effort): chat.subscribe → event:"chat"

​

7) Canvas + camera

​

Gateway Canvas Host (aanbevolen voor webinhoud)

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:18789/__openclaw__/canvas/"}'

• 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.snap (jpg)
• camera.clip (mp4)

​

8) Spraak + uitgebreid Android-commandosurface

• Spraaktabblad: Android heeft twee expliciete opnamemodi. Mic is een handmatige sessie op het spraaktabblad die elke pauze als chatbeurt verzendt en stopt wanneer de app de foreground verlaat of de gebruiker het spraaktabblad verlaat. Talk is continue Talk Mode en blijft luisteren totdat deze wordt uitgeschakeld of de Node de verbinding verbreekt.
• Talk Mode promoveert de bestaande foreground service van dataSync naar dataSync|microphone voordat opname begint, en degradeert deze weer wanneer Talk Mode stopt. Android 14+ vereist de FOREGROUND_SERVICE_MICROPHONE-declaratie, de runtime-toekenning RECORD_AUDIO en het microfoonservicetype tijdens runtime.
• Gesproken antwoorden gebruiken talk.speak via de geconfigureerde Gateway Talk-provider. Lokale systeem-TTS wordt alleen gebruikt wanneer talk.speak niet beschikbaar is.
• Voice wake blijft uitgeschakeld in de Android-UX/runtime.
• Extra Android-commandofamilies (beschikbaarheid hangt af van apparaat + permissies):
  • device.status, device.info, device.permissions, device.health
  • notifications.list, notifications.actions (zie Meldingen doorsturen hieronder)
  • photos.latest
  • contacts.search, contacts.add
  • calendar.events, calendar.add
  • callLog.search
  • sms.search
  • motion.activity, motion.pedometer

​

Assistent-entrypoints

​

Meldingen doorsturen

{
  notifications: {
    allowPackages: ["com.slack", "com.whatsapp"],
    denyPackages: ["com.android.systemui"],
    quietHours: {
      start: "22:00",
      end: "07:00",
    },
    rateLimit: 5,
  },
}

​

Gerelateerd

• iOS-app
• Nodes
• Problemen met Android-Node oplossen