Naar hoofdinhoud gaan
De officiële Android-app is beschikbaar op Google Play. Het is een bijbehorende Node en vereist een actieve OpenClaw Gateway. De broncode is ook beschikbaar in de OpenClaw-repository onder apps/android; zie apps/android/README.md voor buildinstructies.

​
Ondersteuningssnapshot

​
Systeembeheer

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

​
Verbindingsrunbook

Android-Node-app ⇄ (mDNS/NSD + WebSocket) ⇄ Gateway Android maakt rechtstreeks verbinding met de Gateway-WebSocket en gebruikt apparaatkoppeling (role: node). Voor Tailscale of openbare hosts vereist Android een veilig endpoint:
  • 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:
    • Hetzelfde LAN met mDNS/NSD, of
    • Dezelfde 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
Bevestig dat je in de logs iets ziet zoals:
  • listening on ws://0.0.0.0:18789
Voor externe Android-toegang via Tailscale heeft Serve/Funnel de voorkeur boven een ruwe tailnet-bind: 
openclaw gateway --tailscale serve
Dit geeft Android een veilig wss:// / https://-endpoint. Een gewone gateway.bind: "tailnet"-configuratie is niet genoeg voor eerste externe Android-koppeling, tenzij je TLS ook apart beëindigt.

​
2) Verifieer ontdekking (optioneel)

Vanaf de Gateway-machine: 
dns-sd -B _openclaw-gw._tcp local.
Meer debugnotities: Bonjour. Als je ook een wide-area ontdekkingsdomein hebt geconfigureerd, vergelijk dan met: 
openclaw gateway discover --json
Dat toont local. plus het geconfigureerde wide-area domein in één doorgang en gebruikt het opgeloste service-endpoint in plaats van alleen TXT-hints.

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

Android NSD/mDNS-ontdekking gaat niet over netwerkgrenzen 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. Ontdekking alleen is niet voldoende voor tailnet/openbare Android-koppeling. De ontdekte route heeft nog steeds een veilig endpoint nodig (wss:// of Tailscale Serve):
  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, wijzend naar die DNS-server.
Details en voorbeeld-CoreDNS-configuratie: Bonjour.

​
3) Verbinden vanaf Android

In de Android-app:
  • De app houdt de Gateway-verbinding actief via een voorgrondservice (persistente melding).
  • Open het tabblad Verbinden.
  • Gebruik de modus Installatiecode of Handmatig.
  • Als ontdekking geblokkeerd is, gebruik dan handmatige host/poort in Geavanceerde bedieningselementen. Voor privé-LAN-hosts werkt ws:// nog steeds. Schakel voor Tailscale/openbare hosts TLS in en gebruik een wss:// / Tailscale Serve-endpoint.
Na de eerste geslaagde koppeling maakt Android bij het starten automatisch opnieuw verbinding:
  • Handmatig endpoint (indien ingeschakeld), anders
  • De laatst ontdekte Gateway (naar beste vermogen).

​
Presence alive-beacons

Nadat de geauthenticeerde Node-sessie verbinding maakt, en wanneer de app naar de achtergrond gaat terwijl de voorgrondservice nog verbonden is, roept Android node.event aan met event: "node.presence.alive". De Gateway registreert dit als lastSeenAtMs/lastSeenReason in de gekoppelde Node-/apparaatmetadata, maar pas nadat de geauthenticeerde Node-apparaatidentiteit bekend is. De app telt de beacon alleen als succesvol geregistreerd wanneer de Gateway-respons handled: true bevat. Oudere Gateways kunnen node.event bevestigen met { "ok": true }; die respons is compatibel maar telt niet als een duurzame last-seen-update.

​
4) Koppeling goedkeuren (CLI)

Op de Gateway-machine: 
openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>
Koppelingsdetails: Koppelen. Optioneel: als de Android-Node altijd verbinding maakt vanaf een strikt gecontroleerd subnet, kun je kiezen voor automatische goedkeuring bij eerste Node-koppeling met expliciete CIDR’s of exacte IP’s: 
{
  gateway: {
    nodes: {
      pairing: {
        autoApproveCidrs: ["192.168.1.0/24"],
      },
    },
  },
}
Dit is standaard uitgeschakeld. Het geldt alleen voor nieuwe role: node-koppelingen zonder aangevraagde scopes. Operator-/browserkoppeling en elke wijziging in rol, scope, metadata of openbare sleutel vereisen nog steeds handmatige goedkeuring.

​
5) Verifieer dat de Node verbonden is

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

​
6) Chat + geschiedenis

Het Android-tabblad Chat ondersteunt sessieselectie (standaard main, plus andere bestaande sessies):
  • Geschiedenis: chat.history (weergave-genormaliseerd; inline directive-tags worden uit zichtbare tekst verwijderd, XML-payloads voor tool-calls in platte tekst (waaronder <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls> en afgekorte tool-call-blokken) en gelekte ASCII-/full-width modelbesturingstokens worden verwijderd, pure stille-token-assistentrijen zoals exacte NO_REPLY / no_reply worden weggelaten, en te grote rijen kunnen worden vervangen door placeholders)
  • Verzenden: chat.send
  • Push-updates (naar beste vermogen): chat.subscribe → event:"chat"

​
7) Canvas + camera

​
Gateway Canvas-host (aanbevolen voor webinhoud)

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.
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:18789/__openclaw__/canvas/"}'
Tailnet (optioneel): als beide apparaten op Tailscale zitten, gebruik dan een MagicDNS-naam of tailnet-IP in plaats van .local, bijvoorbeeld http://<gateway-magicdns>:18789/__openclaw__/canvas/. Deze server injecteert een live-reload-client in HTML en herlaadt bij bestandswijzigingen. De Gateway serveert ook /__openclaw__/a2ui/, maar de Android-app behandelt externe A2UI-pagina’s als alleen-renderen. Actiegeschikte A2UI-commando’s gebruiken de gebundelde app-eigen A2UI-pagina voordat berichten worden toegepast. Canvas-commando’s (alleen voorgrond):
  • canvas.eval, canvas.snapshot, canvas.navigate (gebruik {"url":""} of {"url":"/"} om terug te keren naar de standaardscaffold). canvas.snapshot retourneert { format, base64 } (standaard format="jpeg").
  • A2UI: canvas.a2ui.push, canvas.a2ui.reset (canvas.a2ui.pushJSONL legacy alias). Deze commando’s gebruiken de gebundelde app-eigen A2UI-pagina voor actiegeschikte rendering.
Camera-commando’s (alleen voorgrond; toestemmingsgebonden):
  • camera.snap (jpg)
  • camera.clip (mp4)
Zie Camera-Node voor parameters en CLI-helpers.

​
8) Spraak + uitgebreid Android-commandosurface

  • Spraaktabblad: Android heeft twee expliciete opnamemodi. Microfoon is een handmatige sessie op het spraaktabblad die elke pauze als chatbeurt verzendt en stopt wanneer de app de voorgrond verlaat of de gebruiker het spraaktabblad verlaat. Praten is continue Talk Mode en blijft luisteren tot deze wordt uitgeschakeld of de Node de verbinding verbreekt.
  • Talk Mode promoveert de bestaande voorgrondservice van connectedDevice naar connectedDevice|microphone voordat opname begint, en degradeert deze daarna wanneer Talk Mode stopt. De Node-service declareert FOREGROUND_SERVICE_CONNECTED_DEVICE met CHANGE_NETWORK_STATE; Android 14+ vereist ook de declaratie FOREGROUND_SERVICE_MICROPHONE, de runtime-toekenning RECORD_AUDIO en het microfoonservicetype tijdens runtime.
  • Standaard gebruikt Android Talk native spraakherkenning, Gateway-chat en talk.speak via de geconfigureerde Gateway Talk-provider. Lokale systeem-TTS wordt alleen gebruikt wanneer talk.speak niet beschikbaar is.
  • Android Talk gebruikt realtime Gateway-relay alleen wanneer talk.realtime.mode realtime is en talk.realtime.transport gateway-relay is.
  • Voice wake blijft uitgeschakeld in de Android-UX/runtime.
  • Aanvullende Android-commandofamilies (beschikbaarheid hangt af van apparaat, toestemmingen en gebruikersinstellingen):
    • device.status, device.info, device.permissions, device.health
    • device.apps alleen wanneer Instellingen > Telefoonmogelijkheden > Geïnstalleerde apps is ingeschakeld; het toont standaard apps die zichtbaar zijn in de launcher.
    • 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

Android ondersteunt het starten van OpenClaw via de systeemassistenttrigger (Google Assistant). Wanneer dit is geconfigureerd, opent het ingedrukt houden van de thuisknop of zeggen van “Hey Google, ask OpenClaw…” de app en geeft de prompt door aan de chatcomposer. Dit gebruikt Android App Actions-metadata die in het appmanifest zijn gedeclareerd. Er is geen extra configuratie nodig aan de Gateway-kant — de assistent-intent wordt volledig door de Android-app afgehandeld en doorgestuurd als een normaal chatbericht.
De beschikbaarheid van App Actions hangt af van het apparaat, de versie van Google Play Services en of de gebruiker OpenClaw heeft ingesteld als de standaardassistent-app.

​
Meldingen doorsturen

Android kan apparaatmeldingen als events doorsturen naar de Gateway. Met verschillende bedieningselementen kun je afbakenen welke meldingen worden doorgestuurd en wanneer.
SleutelTypeBeschrijving
notifications.allowPackagesstring[]Stuur alleen meldingen van deze pakketnamen door. Als dit is ingesteld, worden alle andere pakketten genegeerd.
notifications.denyPackagesstring[]Stuur nooit meldingen van deze pakketnamen door. Toegepast na allowPackages.
notifications.quietHours.startstring (HH:mm)Begin van het stilte-urenvenster (lokale apparaattijd). Meldingen worden tijdens dit venster onderdrukt.
notifications.quietHours.endstring (HH:mm)Einde van het stilte-urenvenster.
notifications.rateLimitnumberMaximaal aantal doorgestuurde meldingen per pakket per minuut. Overtollige meldingen worden verwijderd.
De meldingenkiezer gebruikt ook veiliger gedrag voor doorgestuurde meldingevents, waardoor onbedoeld doorsturen van gevoelige systeemmeldingen wordt voorkomen. Voorbeeldconfiguratie: 
{
  notifications: {
    allowPackages: ["com.slack", "com.whatsapp"],
    denyPackages: ["com.android.systemui"],
    quietHours: {
      start: "22:00",
      end: "07:00",
    },
    rateLimit: 5,
  },
}
Voor het doorsturen van meldingen is de Android-machtiging Notification Listener vereist. De app vraagt hier tijdens de installatie om.

​
Gerelateerd