Captura de cámara para agentes con OpenClaw

Integrar visión en un flujo de trabajo automatizado suele ser un dolor de cabeza. A veces necesitas que tu agente “vea” lo que ocurre en el mundo real o capture una prueba visual rápida para tomar una decisión, pero configurar el acceso a la cámara y gestionar la transferencia de archivos suele complicar el código más de lo necesario.

OpenClaw simplifica esto permitiendo que tus agentes invoquen comandos de cámara directamente en dispositivos remotos, gestionando los permisos y la compresión por ti.

Requisitos previos

• Un dispositivo con el iOS node, Android node o la macOS app instalado.
• El nodo debe estar emparejado mediante un Gateway.

Inicio rápido

La ruta más corta para obtener una imagen es usar el CLI helper. Este comando guarda la imagen en un archivo temporal y te devuelve la ruta lista para procesar.

# Captura una foto (por defecto captura frontal y trasera en iOS)
openclaw nodes camera snap --node <id>

# Graba un clip de video de 3 segundos con audio
openclaw nodes camera clip --node <id> --duration 3000

Configuración por plataforma

iOS node

En iOS, el acceso está permitido por defecto, pero el nodo debe estar en foreground (primer plano). Si la app está minimizada, los comandos fallarán.

• Ajustes: iOS Settings → Camera → Allow Camera (camera.enabled).
• Comportamiento: Si falta la clave de configuración, el sistema la trata como habilitada.
• Límites: Las fotos se recomprimen para que el payload base64 sea menor a 5 MB.

Android node

Al igual que en iOS, Android requiere que la app esté en foreground. La diferencia principal radica en la gestión de permisos del sistema operativo.

• Permisos: Necesitas conceder permisos de CAMERA y RECORD_AUDIO (para clips con sonido).
• Ajustes: Android Settings sheet → Camera → Allow Camera.
• Payload: Se aplica la misma restricción de 5 MB para las imágenes.

macOS app

En macOS, la privacidad es más estricta y la cámara viene desactivada por defecto. Debes habilitarla manualmente en Settings → General → Allow Camera.

Para capturar imágenes con una cámara específica o ajustar el retraso de exposición:

# Listar cámaras disponibles
openclaw nodes camera list --node <id>

# Captura con retraso de 2 segundos para estabilizar la imagen
openclaw nodes camera snap --node <id> --delay-ms 2000 --device-id <id>

Si lo que necesitas es grabar la pantalla en lugar de la cámara web, usa el comando de grabación de pantalla (requiere permiso de Screen Recording en TCC):

openclaw nodes screen record --node <id> --duration 10s --fps 15

Solución de problemas

• CAMERA_DISABLED: El usuario desactivó el interruptor de cámara en los ajustes de la app.
• NODE_BACKGROUND_UNAVAILABLE: El nodo está en segundo plano. Abre la app en el dispositivo y mantén la pantalla activa.
• *_PERMISSION_REQUIRED: El sistema operativo bloqueó el acceso. Revisa los permisos de privacidad en los ajustes de iOS/Android.
• Payload demasiado grande: Los clips de video están limitados a 60 segundos para evitar errores de memoria al codificar en base64.

¿Necesitas ayuda para configurar tus nodos? Prueba nuestro AI Setup Assistant.

Próximos pasos

• Node.js Gateway API Reference
• Managing iOS Nodes
• Android Permissions Guide
• macOS Screen Capture