App Android

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.

​

Riepilogo del supporto

• Ruolo: app Node companion (Android non ospita il Gateway).
• Gateway richiesto: sì (eseguilo su macOS, Linux o Windows tramite WSL2).
• Installazione: Per iniziare + Abbinamento.
• Gateway: Runbook + Configurazione.
  • Protocolli: protocollo Gateway (Node + piano di controllo).

​

Controllo di sistema

​

Runbook di connessione

• Preferito: Tailscale Serve / Funnel con https://<magicdns> / wss://<magicdns>
• Supportato anche: qualsiasi altro URL Gateway wss:// con un endpoint TLS reale
• Il testo in chiaro ws:// rimane supportato sugli indirizzi LAN privati / host .local, oltre a localhost, 127.0.0.1 e al bridge dell’emulatore Android (10.0.2.2)

​

Prerequisiti

• Puoi eseguire il Gateway sulla macchina “master”.
• Il dispositivo/emulatore Android può raggiungere il WebSocket del gateway:
  • Stessa LAN con mDNS/NSD, oppure
  • Stessa tailnet Tailscale usando Wide-Area Bonjour / DNS-SD unicast (vedi sotto), oppure
  • Host/porta gateway manuali (fallback)
• L’abbinamento mobile via tailnet/pubblico non usa endpoint IP tailnet grezzi ws://. Usa invece Tailscale Serve o un altro URL wss://.
• Puoi eseguire la CLI (openclaw) sulla macchina gateway (o tramite SSH).

​

1) Avvia il Gateway

openclaw gateway --port 18789 --verbose

• listening on ws://0.0.0.0:18789

openclaw gateway --tailscale serve

​

2) Verifica la discovery (opzionale)

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

openclaw gateway discover --json

​

Discovery su tailnet (Vienna ⇄ Londra) tramite DNS-SD unicast

1. Configura una zona DNS-SD (esempio openclaw.internal.) sull’host gateway e pubblica i record _openclaw-gw._tcp.
2. Configura lo split DNS di Tailscale per il dominio scelto, puntandolo a quel server DNS.

​

3) Connettiti da Android

• L’app mantiene attiva la connessione al gateway tramite un servizio in primo piano (notifica persistente).
• Apri la scheda Connetti.
• Usa la modalità Codice di configurazione o Manuale.
• Se la discovery è bloccata, usa host/porta manuali nei controlli avanzati. Per gli host LAN privati, ws:// funziona ancora. Per gli host Tailscale/pubblici, attiva TLS e usa un endpoint wss:// / Tailscale Serve.

• Endpoint manuale (se abilitato), altrimenti
• L’ultimo gateway rilevato (best-effort).

​

Beacon alive di presenza

​

4) Approva l’abbinamento (CLI)

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

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

​

5) Verifica che il Node sia connesso

• Tramite stato dei Node:
  openclaw nodes status
  
• Tramite Gateway:
  openclaw gateway call node.list --params "{}"
  

​

6) Chat + cronologia

• Cronologia: chat.history (normalizzata per la visualizzazione; i tag di direttiva inline vengono rimossi dal testo visibile, i payload XML delle chiamate agli strumenti in testo semplice (inclusi <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls> e blocchi di chiamata agli strumenti troncati) e i token di controllo del modello trapelati in ASCII/a larghezza piena vengono rimossi, le righe assistant composte solo da token silenziosi come gli esatti NO_REPLY / no_reply vengono omesse e le righe sovradimensionate possono essere sostituite con segnaposto)
• Invio: chat.send
• Aggiornamenti push (best-effort): chat.subscribe → event:"chat"

​

7) Canvas + fotocamera

​

Host Canvas Gateway (consigliato per contenuti web)

1. Crea ~/.openclaw/workspace/canvas/index.html sull’host gateway.
2. Naviga il Node verso di esso (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 (usa {"url":""} o {"url":"/"} per tornare allo scaffold predefinito). canvas.snapshot restituisce { format, base64 } (format="jpeg" per impostazione predefinita).
• A2UI: canvas.a2ui.push, canvas.a2ui.reset (canvas.a2ui.pushJSONL alias legacy)

• camera.snap (jpg)
• camera.clip (mp4)

​

8) Voce + superficie comandi Android ampliata

• Scheda Voce: Android ha due modalità di acquisizione esplicite. Mic è una sessione manuale della scheda Voce che invia ogni pausa come turno di chat e si arresta quando l’app lascia il primo piano o l’utente lascia la scheda Voce. Talk è la modalità Talk continua e continua ad ascoltare finché non viene disattivata o il Node si disconnette.
• La modalità Talk promuove il servizio in primo piano esistente da dataSync a dataSync|microphone prima dell’inizio dell’acquisizione, poi lo declassa quando la modalità Talk si arresta. Android 14+ richiede la dichiarazione FOREGROUND_SERVICE_MICROPHONE, la concessione runtime RECORD_AUDIO e il tipo di servizio microfono a runtime.
• Le risposte vocali usano talk.speak tramite il provider Talk del gateway configurato. La sintesi vocale di sistema locale viene usata solo quando talk.speak non è disponibile.
• L’attivazione vocale rimane disabilitata nell’UX/runtime Android.
• Famiglie di comandi Android aggiuntive (la disponibilità dipende da dispositivo + autorizzazioni):
  • device.status, device.info, device.permissions, device.health
  • notifications.list, notifications.actions (vedi Inoltro notifiche sotto)
  • photos.latest
  • contacts.search, contacts.add
  • calendar.events, calendar.add
  • callLog.search
  • sms.search
  • motion.activity, motion.pedometer

​

Entry point assistant

​

Inoltro notifiche

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

​

Correlati

• App iOS
• Node
• Risoluzione dei problemi del Node Android