Captura da câmera

OpenClaw oferece suporte a captura de câmera para fluxos de trabalho de agentes:

• Nó iOS (pareado via Gateway): capture uma foto (jpg) ou um clipe de vídeo curto (mp4, com áudio opcional) via node.invoke.
• Nó Android (pareado via Gateway): capture uma foto (jpg) ou um clipe de vídeo curto (mp4, com áudio opcional) via node.invoke.
• App macOS (nó via Gateway): capture uma foto (jpg) ou um clipe de vídeo curto (mp4, com áudio opcional) via node.invoke.

Todo acesso à câmera é protegido por configurações controladas pelo usuário.

Nó iOS

Configuração do usuário (ativada por padrão)

• Aba Settings do iOS → Camera → Allow Camera (camera.enabled)
  • Padrão: ativado (chave ausente é tratada como habilitada).
  • Quando desativado: comandos camera.* retornam CAMERA_DISABLED.

Comandos (via Gateway node.invoke)

• camera.list

  • Payload de resposta:
    • devices: array de { id, name, position, deviceType }

• camera.snap

  • Parâmetros:
    • facing: front|back (padrão: front)
    • maxWidth: number (opcional; padrão 1600 no nó iOS)
    • quality: 0..1 (opcional; padrão 0.9)
    • format: atualmente jpg
    • delayMs: number (opcional; padrão 0)
    • deviceId: string (opcional; de camera.list)
  • Payload de resposta:
    • format: "jpg"
    • base64: "<...>"
    • width, height
  • Proteção de payload: fotos são recomprimidas para manter o payload base64 abaixo de 5 MB.

• camera.clip

  • Parâmetros:
    • facing: front|back (padrão: front)
    • durationMs: number (padrão 3000, limitado a um máximo de 60000)
    • includeAudio: boolean (padrão true)
    • format: atualmente mp4
    • deviceId: string (opcional; de camera.list)
  • Payload de resposta:
    • format: "mp4"
    • base64: "<...>"
    • durationMs
    • hasAudio

Requisito de primeiro plano

Assim como canvas.*, o nó iOS só permite comandos camera.* em primeiro plano. Invocações em segundo plano retornam NODE_BACKGROUND_UNAVAILABLE.

Auxiliar da CLI

A maneira mais fácil de obter arquivos de mídia é via o auxiliar da CLI, que grava a mídia decodificada em um arquivo temporário e imprime o caminho salvo.

Exemplos:

openclaw nodes camera snap --node <id>               # default: both front + back (2 MEDIA lines)openclaw nodes camera snap --node <id> --facing frontopenclaw nodes camera clip --node <id> --duration 3000openclaw nodes camera clip --node <id> --no-audio

Notas:

• nodes camera snap usa como padrão ambas as orientações para dar ao agente as duas visualizações.
• Os arquivos de saída são temporários (no diretório temporário do SO), a menos que você crie seu próprio wrapper.

Nó Android

Configuração do usuário Android (ativada por padrão)

• Painel Settings do Android → Camera → Allow Camera (camera.enabled)
  • Padrão: ativado (chave ausente é tratada como habilitada).
  • Quando desativado: comandos camera.* retornam CAMERA_DISABLED.

Permissões

• Android exige permissões em tempo de execução:
  • CAMERA para camera.snap e camera.clip.
  • RECORD_AUDIO para camera.clip quando includeAudio=true.

Se as permissões estiverem ausentes, o app solicitará quando possível; se forem negadas, solicitações camera.* falharão com um erro *_PERMISSION_REQUIRED.

Requisito de primeiro plano no Android

Assim como canvas.*, o nó Android só permite comandos camera.* em primeiro plano. Invocações em segundo plano retornam NODE_BACKGROUND_UNAVAILABLE.

Comandos Android (via Gateway node.invoke)

• camera.list
  • Payload de resposta:
    • devices: array de { id, name, position, deviceType }

Proteção de payload

Fotos são recomprimidas para manter o payload base64 abaixo de 5 MB.

App macOS

Configuração do usuário (desativada por padrão)

O app complementar para macOS expõe uma caixa de seleção:

• Settings → General → Allow Camera (openclaw.cameraEnabled)
  • Padrão: desativado
  • Quando desativado: solicitações de câmera retornam "Câmera desabilitada pelo usuário".

Auxiliar da CLI (node invoke)

Use a CLI principal openclaw para invocar comandos de câmera no nó macOS.

Exemplos:

openclaw nodes camera list --node <id>            # list camera idsopenclaw nodes camera snap --node <id>            # prints saved pathopenclaw nodes camera snap --node <id> --max-width 1280openclaw nodes camera snap --node <id> --delay-ms 2000openclaw nodes camera snap --node <id> --device-id <id>openclaw nodes camera clip --node <id> --duration 10s          # prints saved pathopenclaw nodes camera clip --node <id> --duration-ms 3000      # prints saved path (legacy flag)openclaw nodes camera clip --node <id> --device-id <id>openclaw nodes camera clip --node <id> --no-audio

Notas:

• openclaw nodes camera snap usa maxWidth=1600 como padrão, a menos que seja substituído.
• No macOS, camera.snap aguarda delayMs (padrão 2000ms) após o aquecimento/estabilização da exposição antes de capturar.
• Payloads de foto são recomprimidos para manter base64 abaixo de 5 MB.

Segurança + limites práticos

• O acesso à câmera e ao microfone aciona os prompts de permissão usuais do SO (e exige strings de uso em Info.plist).
• Clipes de vídeo são limitados (atualmente <= 60s) para evitar payloads de nó grandes demais (sobrecarga de base64 + limites de mensagem).

Vídeo de tela no macOS (nível do SO)

Para vídeo de tela (não câmera), use o complementar para macOS:

openclaw nodes screen record --node <id> --duration 10s --fps 15   # prints saved path

Notas:

• Exige permissão de Screen Recording do macOS (TCC).

Relacionados

• Suporte a imagens e mídia
• Compreensão de mídia
• Comando de localização