Saltar para o conteúdo principal

​
Captura de câmera (agente)

O OpenClaw oferece suporte à captura de câmera para fluxos de trabalho de agentes:
  • Nó iOS (emparelhado via Gateway): captura uma foto (jpg) ou clipe curto de vídeo (mp4, com áudio opcional) via node.invoke.
  • Nó Android (emparelhado via Gateway): captura uma foto (jpg) ou clipe curto de vídeo (mp4, com áudio opcional) via node.invoke.
  • App macOS (nó via Gateway): captura uma foto (jpg) ou clipe curto de vídeo (mp4, com áudio opcional) via node.invoke.
Todo acesso à câmera é controlado por configurações definidas pelo usuário.

​
Nó iOS

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

  • Aba Ajustes do iOS → Câmera → Permitir Câmera (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: as 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 (arquivos temporários + MEDIA)

A maneira mais fácil de obter anexos é via o auxiliar da CLI, que grava a mídia decodificada em um arquivo temporário e imprime MEDIA:<path>. Exemplos: 
openclaw nodes camera snap --node <id>               # default: both front + back (2 MEDIA lines)
openclaw nodes camera snap --node <id> --facing front
openclaw nodes camera clip --node <id> --duration 3000
openclaw nodes camera clip --node <id> --no-audio
Notas:
  • nodes camera snap usa ambas as câmeras por padrão para fornecer 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 de usuário do Android (ativada por padrão)

  • Tela de Configurações do Android → Câmera → Permitir Câmera (camera.enabled)
    • Padrão: ativado (chave ausente é tratada como habilitada).
    • Quando desativado: comandos camera.* retornam CAMERA_DISABLED.

​
Permissions

  • O 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 negadas, solicitações camera.* falham 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.

​
Proteção de payload

As 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 do macOS expõe uma caixa de seleção:
  • Ajustes → Geral → Permitir Câmera (openclaw.cameraEnabled)
    • Padrão: desativado
    • Quando desativado: solicitações de câmera retornam “Camera disabled by user”.

​
Auxiliar da CLI (invocação do nó)

Use a CLI principal openclaw para invocar comandos de câmera no nó macOS. Exemplos: 
openclaw nodes camera list --node <id>            # list camera ids
openclaw nodes camera snap --node <id>            # prints MEDIA:<path>
openclaw nodes camera snap --node <id> --max-width 1280
openclaw nodes camera snap --node <id> --delay-ms 2000
openclaw nodes camera snap --node <id> --device-id <id>
openclaw nodes camera clip --node <id> --duration 10s          # prints MEDIA:<path>
openclaw nodes camera clip --node <id> --duration-ms 3000      # prints MEDIA:<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 por padrão, a menos que seja substituído.
  • No macOS, camera.snap aguarda delayMs (padrão 2000ms) após o aquecimento/estabilização de exposição antes de capturar.
  • Os payloads de foto são recomprimidos para manter o base64 abaixo de 5 MB.

​
Segurança + limites práticos

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

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

Para vídeo de tela (não da câmera), use o app complementar do macOS: 
openclaw nodes screen record --node <id> --duration 10s --fps 15   # prints MEDIA:<path>
Notas:
  • Requer permissão de Gravação de Tela do macOS (TCC).