Aplicación Android

​

Resumen de compatibilidad

• Rol: aplicación de nodo complementario (Android no aloja el Gateway).
• Gateway requerido: sí (ejecútalo en macOS, Linux o Windows mediante WSL2).
• Instalación: Google Play para la aplicación, Primeros pasos para el Gateway y luego Emparejamiento.
• Gateway: Runbook + Configuración.
  • Protocolos: Protocolo del Gateway (nodos + plano de control).

​

Reflejar y controlar Android desde un Mac remoto

​

Antes de empezar

• Instala Tailscale en el dispositivo Android y en el Mac, y conecta ambos a la misma tailnet.
• En Android, activa Opciones de desarrollador y Depuración USB. Android 16 coloca Depuración inalámbrica en Ajustes > Sistema > Opciones de desarrollador. Consulta Opciones de desarrollador de Android.
• Instala scrcpy y ADB en el Mac:
  brew install scrcpy
  brew install --cask android-platform-tools
  
• Mantén el dispositivo Android disponible para la primera conexión. Android debe aprobar la clave ADB de cada Mac antes de que ese Mac pueda controlar el dispositivo.

​

Activar ADB sobre TCP

adb devices
adb tcpip 5555

​

Permitir solo el Mac controlador

{
  grants: [
    {
      src: ["<remote-mac-tailnet-ip>"],
      dst: ["<android-tailnet-ip>"],
      ip: ["tcp:5555"],
    },
  ],
}

​

Conectar e iniciar la duplicación

adb connect <android-tailnet-ip>:5555
adb devices
scrcpy --serial <android-tailnet-ip>:5555

​

Solución de problemas

• Connection timed out: verifica el permiso de tailnet para TCP 5555. Un tailscale ping correcto demuestra la alcanzabilidad entre pares, no que la política permita este puerto TCP. Prueba con nc -vz <android-tailnet-ip> 5555 desde el Mac.
• unauthorized: desbloquea Android y aprueba la clave ADB del Mac remoto, o elimina la estación de trabajo obsoleta en Depuración inalámbrica > Dispositivos emparejados y vuelve a emparejarla.
• Connection refused: vuelve a conectar localmente y ejecuta adb tcpip 5555 otra vez.
• Más de un dispositivo listado: mantén el argumento explícito --serial <android-tailnet-ip>:5555.

adb disconnect <android-tailnet-ip>:5555

​

Runbook de conexión

• Preferido: Tailscale Serve / Funnel con https://<magicdns> / wss://<magicdns>
• También compatible: cualquier otra URL de Gateway wss:// con un endpoint TLS real
• El texto claro ws:// sigue siendo compatible en direcciones de LAN privadas / hosts .local, además de localhost, 127.0.0.1 y el puente del emulador de Android (10.0.2.2)

​

Requisitos previos

• Gateway ejecutándose en otra máquina (o accesible mediante SSH).
• El dispositivo/emulador Android puede alcanzar el WebSocket del gateway:
  • Misma LAN con mDNS/NSD, o
  • Misma tailnet de Tailscale usando Wide-Area Bonjour / DNS-SD unicast (ver abajo), o
  • Host/puerto de gateway manual (alternativa)
• El emparejamiento móvil en tailnet/público no usa endpoints de IP de tailnet sin procesar ws://. Usa Tailscale Serve u otra URL wss:// en su lugar.
• La CLI openclaw disponible en la máquina del gateway (o mediante SSH), para aprobar solicitudes de emparejamiento.

​

1. Iniciar el Gateway

openclaw gateway --port 18789 --verbose

• listening on ws://0.0.0.0:18789

openclaw gateway --tailscale serve

​

2. Verificar el descubrimiento (opcional)

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

openclaw gateway discover --json

​

Descubrimiento entre redes mediante DNS-SD unicast

1. Configura una zona DNS-SD (ejemplo openclaw.internal.) en el host del gateway y publica registros _openclaw-gw._tcp.
2. Configura DNS dividido de Tailscale para el dominio elegido apuntando a ese servidor DNS.

​

3. Conectarse desde Android

• La aplicación mantiene activa su conexión con el gateway mediante un servicio en primer plano (notificación persistente).
• Abre la pestaña Conectar.
• Usa el modo Código de configuración o Manual.
• Si el descubrimiento está bloqueado, usa host/puerto manual en Controles avanzados. Para hosts de LAN privada, ws:// sigue funcionando. Para hosts de Tailscale/públicos, activa TLS y usa un endpoint wss:// / Tailscale Serve.

​

Balizas de presencia activa

​

4. Aprobar el emparejamiento (CLI)

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

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

​

5. Verificar que el nodo esté conectado

openclaw nodes status
openclaw gateway call node.list --params "{}"

​

6. Chat + historial

• Historial: chat.history (normalizado para visualización: se eliminan las etiquetas de directiva en línea, las cargas XML de llamadas de herramienta en texto sin formato (<tool_call>, <function_call>, <tool_calls>, <function_calls> y variantes truncadas), y los tokens de control del modelo filtrados en ASCII/ancho completo; se omiten las filas de asistente con tokens silenciosos como los exactos NO_REPLY / no_reply; las filas demasiado grandes pueden reemplazarse por marcadores de posición)
• Enviar: chat.send
• Actualizaciones push (mejor esfuerzo): chat.subscribe -> event:"chat"

​

7. Canvas + cámara

​

Host Canvas del Gateway (recomendado para contenido web)

1. Crea ~/.openclaw/workspace/canvas/index.html en el host del gateway.
2. Navega el nodo hasta él (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":"/"} para volver al andamiaje predeterminado). canvas.snapshot devuelve { format, base64 } (format="jpeg" predeterminado).
• A2UI: canvas.a2ui.push, canvas.a2ui.reset (alias heredado canvas.a2ui.pushJSONL). Estos usan la página A2UI incluida y propiedad de la aplicación para renderizado con capacidad de acción.

​

8. Voz + superficie ampliada de comandos de Android

• Pestaña Voz: Android tiene dos modos explícitos de captura. Mic es una sesión manual de la pestaña Voz que envía cada pausa como un turno de chat y se detiene cuando la aplicación deja de estar en primer plano o el usuario sale de la pestaña Voz. Talk es el Talk Mode continuo y sigue escuchando hasta que se desactiva o el nodo se desconecta.
• Talk Mode promociona el servicio en primer plano existente de connectedDevice a connectedDevice|microphone antes de que empiece la captura y luego lo degrada cuando Talk Mode se detiene. El servicio del nodo declara FOREGROUND_SERVICE_CONNECTED_DEVICE con CHANGE_NETWORK_STATE; Android 14+ también requiere la declaración FOREGROUND_SERVICE_MICROPHONE, el permiso en tiempo de ejecución RECORD_AUDIO y el tipo de servicio de micrófono en tiempo de ejecución.
• De forma predeterminada, Android Talk usa reconocimiento de voz nativo, chat de Gateway y talk.speak a través del proveedor de Talk de Gateway configurado. La TTS del sistema local solo se usa cuando talk.speak no está disponible.
• Android Talk usa retransmisión de Gateway en tiempo real solo cuando talk.realtime.mode es realtime y talk.realtime.transport es gateway-relay.
• Voice wake está implementado en el código fuente (VoiceWakeMode), pero el runtime de la aplicación distribuida siempre lo fuerza a off al conectarse; hoy no hay ningún conmutador visible para el usuario.
• Familias adicionales de comandos de Android (la disponibilidad depende del dispositivo, los permisos y la configuración del usuario):
  • device.status, device.info, device.permissions, device.health
  • device.apps solo cuando Configuración > Capacidades del teléfono > Aplicaciones instaladas está habilitado; enumera de forma predeterminada las aplicaciones visibles en el lanzador (pasa includeNonLaunchable para obtener la lista completa).
  • notifications.list, notifications.actions (consulta Reenvío de notificaciones abajo)
  • photos.latest
  • contacts.search, contacts.add
  • calendar.events, calendar.add
  • callLog.search
  • sms.search
  • motion.activity, motion.pedometer

​

Puntos de entrada del asistente

​

Reenvío de notificaciones

​

Relacionado

• Aplicación iOS
• Nodos
• Solución de problemas de nodos Android