Volver

13. Acceso móvil de OpenClaw: Nodos iOS y Android

Este artículo explica cómo usar OpenClaw en dispositivos iOS y Android, incluyendo instalación de la app móvil, emparejamiento de nodos, soporte de Canvas, cámara, grabación de pantalla y más funciones para una experiencia de asistente IA verdaderamente móvil.

Aplica a OpenClaw v2026.2 | Este artículo asume que ya has completado el despliegue del Gateway y quieres usarlo en dispositivos móviles.

TL;DR: Las apps iOS/Android se conectan al Gateway como “nodos”, proporcionando capacidades de cámara, grabación de pantalla, ubicación y notificaciones. Flujo de emparejamiento: abrir App → descubrir Gateway → introducir código de emparejamiento. Comandos: camera.snap (foto), screen.record (grabación), location.get (ubicación), notification.send (notificación). La activación por voz solo funciona en iOS diciendo “Hey Claw”.

Descripción general de funciones móviles

Comparación de funciones

Función iOS Android Descripción
Mensajes A través de WebChat o apps de mensajería
Canvas Interfaz visual
Cámara Tomar fotos para análisis con IA
Grabación de pantalla Grabar y compartir pantalla
Servicios de ubicación Obtener ubicación actual
Notificaciones Recibir notificaciones de la IA
Activación por voz Activar con “Hey Claw”
Ejecución local Requiere conexión al Gateway

Diagrama de arquitectura

[App iOS/Android] <--WiFi/Cellular--> [Gateway] <---> [Agent]
        |                                    |
    [Node API]                        [Tools/Skills]
        |                                    |
   [Capacidades                      [Servicios
    del dispositivo]                  externos]
    - Cámara
    - Pantalla
    - Ubicación
    - Notificaciones

Instalación en iOS

Requisitos del sistema

Requisito Versión
iOS 15.0+
Dispositivo iPhone 8 y superior

Métodos de instalación

Método uno: TestFlight (recomendado)

  1. Unirse a la prueba de TestFlight
  2. Instalar la app OpenClaw para iOS
  3. Abrir la app para emparejamiento

Método dos: Compilar desde código fuente

# Clonar repositorio
git clone https://github.com/openclaw/openclaw.git
cd openclaw/apps/ios

# Instalar dependencias
pod install

# Abrir Xcode
open OpenClaw.xcworkspace

# Compilar e instalar en el dispositivo

Configuración de permisos en iOS

Permiso Uso Requerido
Cámara Análisis de fotos Opcional
Biblioteca de fotos Guardar/leer fotos Opcional
Ubicación Obtener ubicación actual Opcional
Notificaciones Recibir notificaciones de mensajes Recomendado
Micrófono Activación por voz Opcional
Face ID Autenticación segura Opcional

Instalación en Android

Requisitos del sistema

Requisito Versión
Android 10.0+ (API 29+)
Dispositivo La mayoría de dispositivos modernos

Métodos de instalación

Método uno: Instalación directa del APK

  1. Descargar el APK más reciente
  2. Permitir instalación de fuentes desconocidas
  3. Instalar y abrir la app

Método dos: Compilar desde código fuente

# Clonar repositorio
git clone https://github.com/openclaw/openclaw.git
cd openclaw/apps/android

# Compilar
./gradlew assembleDebug

# Instalar en el dispositivo
adb install app/build/outputs/apk/debug/app-debug.apk

Configuración de permisos en Android

Permiso Uso Requerido
Cámara Análisis de fotos Opcional
Almacenamiento Guardar/leer archivos Opcional
Ubicación Obtener ubicación actual Opcional
Notificaciones Recibir notificaciones de mensajes Recomendado
Micrófono Entrada de voz Opcional

Emparejamiento de nodos

Flujo de emparejamiento

sequenceDiagram
    participant A as App móvil
    participant G as Gateway
    participant D as Servicio de descubrimiento
    
    A->>D: Difundir solicitud de descubrimiento
    D-->>A: Gateway descubierto
    A->>G: Solicitar emparejamiento
    G-->>A: Devolver código de emparejamiento
    A->>A: Mostrar código de emparejamiento
    Note over A,G: El usuario introduce el código en la App
    A->>G: Enviar código de emparejamiento
    G->>G: Verificar código
    G-->>A: Emparejamiento exitoso
    A->>G: Registrar capacidades del nodo
    G-->>A: Confirmar registro

Pasos de emparejamiento

1. Asegurarse de que el Gateway esté en ejecución

# Iniciar Gateway
openclaw gateway --port 18789

# Verificar estado
openclaw health

2. Abrir la app móvil

Abrir la app OpenClaw para iOS/Android.

3. Descubrir el Gateway

La app escaneará automáticamente el Gateway en la red local, o puedes introducir manualmente la dirección del Gateway:

http://192.168.1.100:18789

4. Obtener el código de emparejamiento

Consultar el código de emparejamiento en la terminal del Gateway:

openclaw pairing list

# Ejemplo de salida:
# Node     Code     Platform
# ios-1    ABC123   iOS
# android-1 XYZ789  Android

5. Introducir el código de emparejamiento

Introduce el código de emparejamiento en la app para completar el proceso.

Configurar nodos

{
  "nodes": {
    "ios-1": {
      "platform": "ios",
      "capabilities": ["camera", "screen_record", "location", "notification"],
      "autoConnect": true
    },
    "android-1": {
      "platform": "android",
      "capabilities": ["camera", "screen_record", "location", "notification", "sms"],
      "autoConnect": true
    }
  }
}

Función de cámara

Tomar fotos para análisis con IA

Usuario: Ayúdame a ver qué hay en la nevera

Agent: De acuerdo, déjame ver a través de la cámara de tu teléfono...
[Llamando camera.snap]
[Analizando imagen]
En tu nevera hay:
- Leche (media botella)
- Huevos (6)
- Pepinos (2)
- Tomates (varios)
¡Podrías hacer huevos revueltos con tomate!

Comandos de cámara

Comando Descripción
camera.snap Tomar foto
camera.video Grabar video
camera.switch Cambiar cámara frontal/trasera

Configurar cámara

{
  "nodes": {
    "ios-1": {
      "camera": {
        "defaultCamera": "back",
        "quality": "high",
        "saveToGallery": false
      }
    }
  }
}

Grabación de pantalla

Grabar y compartir

Usuario: Ayúdame a ver cómo usar esta app

Agent: De acuerdo, por favor comienza a grabar la pantalla...

[El usuario opera la app]

Agent: Ya lo vi, es una app de lista de tareas.
Puedes:
1. Tocar el + en la esquina inferior derecha para añadir tareas
2. Deslizar a la izquierda para eliminar tareas
3. Tocar una tarea para editar los detalles

Configuración de grabación de pantalla

{
  "nodes": {
    "ios-1": {
      "screenRecord": {
        "maxDuration": 300,
        "quality": "medium",
        "withAudio": true
      }
    }
  }
}

Servicios de ubicación

Obtener ubicación actual

Usuario: ¿Qué hay de bueno para comer cerca?

Agent: Déjame ver dónde estás...
[Llamando location.get]
Actualmente estás cerca de Chueca, Madrid.
Te recomiendo algunos restaurantes bien valorados:
1. La Barraca - 4.8 puntos, Paella tradicional
2. Casa Julio - 4.7 puntos, Croquetas
3. ...

Comandos de ubicación

Comando Descripción
location.get Obtener ubicación actual
location.watch Monitorear cambios de ubicación continuamente

Configuración de ubicación

{
  "nodes": {
    "ios-1": {
      "location": {
        "accuracy": "high",
        "distanceFilter": 100
      }
    }
  }
}

Función de notificaciones

Enviar notificaciones

Agent: La tarea está completada, enviaré una notificación a tu teléfono.

[Llamando notification.send]

El teléfono recibe la notificación:
Título: Tarea completada
Contenido: El código ha sido desplegado en producción

Configuración de notificaciones

{
  "nodes": {
    "ios-1": {
      "notification": {
        "enabled": true,
        "sound": true,
        "badge": true
      }
    }
  }
}

Activación por voz (iOS)

Configurar activación por voz

{
  "nodes": {
    "ios-1": {
      "voiceWake": {
        "enabled": true,
        "keyword": "hey claw",
        "sensitivity": "medium"
      }
    }
  }
}

Usar activación por voz

  1. Decir “Hey Claw”
  2. La app inicia automáticamente la escucha
  3. Hacer tu pregunta
  4. El Agent responde

Canvas en móvil

Canvas en dispositivos móviles

El Canvas en móvil ofrece la misma experiencia visual que en escritorio:

  • Paneles interactivos
  • Visualización de datos en tiempo real
  • Formularios de entrada
  • Gráficos y tablas

Optimización de Canvas para móvil

{
  "canvas": {
    "mobile": {
      "adaptiveLayout": true,
      "touchGestures": true,
      "performanceMode": "balanced"
    }
  }
}

Gestión de nodos

Ver nodos

# Listar todos los nodos
openclaw nodes list

# Ejemplo de salida:
# Node        Platform  Status   Capabilities
# ios-1       iOS       online   camera,location,notification
# android-1   Android   offline  camera,location,sms

# Ver detalles del nodo
openclaw nodes show ios-1

Operaciones con nodos

# Habilitar nodo
openclaw nodes enable ios-1

# Deshabilitar nodo
openclaw nodes disable ios-1

# Desconectar nodo
openclaw nodes disconnect ios-1

# Renombrar nodo
openclaw nodes rename ios-1 --name "Mi iPhone"

Solución de problemas

El nodo no puede conectarse

# Verificar estado del Gateway
openclaw health

# Verificar red
ping 192.168.1.100

# Ver registros del nodo
openclaw logs --node ios-1

Problemas de permisos

# Verificar permisos del nodo
openclaw nodes permissions ios-1

# Ejemplo de salida:
# Permission      Status
# Camera          Granted
# Location        Granted
# Notification    Granted
# Microphone      Denied

Fallo en el emparejamiento

  1. Asegurarse de que el Gateway esté en ejecución
  2. Verificar la conexión de red (misma red local)
  3. Verificar la configuración del firewall
  4. Intentar emparejar de nuevo

Resumen

Los nodos móviles amplían las capacidades de OpenClaw:

  • Cámara: Análisis de fotos, grabación de video
  • Ubicación: Obtener la ubicación actual
  • Notificaciones: Enviar mensajes push al teléfono
  • Canvas: Interfaz visual en dispositivos móviles
  • Activación por voz: Operación manos libres

Registro de actualizaciones:

  • 2026-02-26: Publicación inicial

Navegación de la serie: