Capture d'appareil photo

OpenClaw prend en charge la capture d’appareil photo pour les workflows des agents :

nœud iOS (jumelé via Gateway) : capturer une photo (jpg) ou un clip vidéo court (mp4, avec audio optionnel) via node.invoke.
nœud Android (jumelé via Gateway) : capturer une photo (jpg) ou un clip vidéo court (mp4, avec audio optionnel) via node.invoke.
application macOS (nœud via Gateway) : capturer une photo (jpg) ou un clip vidéo court (mp4, avec audio optionnel) via node.invoke.

Tout accès à l’appareil photo est protégé par des paramètres contrôlés par l’utilisateur.

Nœud iOS

Paramètre utilisateur (activé par défaut)

Onglet Paramètres iOS → Appareil photo → Autoriser l’appareil photo (camera.enabled)
- Par défaut : activé (l’absence de clé est traitée comme une activation).
- Lorsqu’il est désactivé : les commandes camera.* renvoient CAMERA_DISABLED.

Commandes (via Gateway `node.invoke`)

camera.list
- Payload de réponse :
  - devices : tableau de { id, name, position, deviceType }
camera.snap
- Paramètres :
  - facing : front|back (par défaut : front)
  - maxWidth : nombre (facultatif ; par défaut 1600 sur le nœud iOS)
  - quality : 0..1 (facultatif ; par défaut 0.9)
  - format : actuellement jpg
  - delayMs : nombre (facultatif ; par défaut 0)
  - deviceId : chaîne (facultatif ; depuis camera.list)
- Payload de réponse :
  - format: "jpg"
  - base64: "<...>"
  - width, height
- Protection du payload : les photos sont recompressées pour maintenir le payload base64 sous 5 Mo.
camera.clip
- Paramètres :
  - facing : front|back (par défaut : front)
  - durationMs : nombre (par défaut 3000, limité à un maximum de 60000)
  - includeAudio : booléen (par défaut true)
  - format : actuellement mp4
  - deviceId : chaîne (optionnel ; depuis camera.list)
- Charge utile de la réponse :
  - format: "mp4"
  - base64: "<...>"
  - durationMs
  - hasAudio

Exigence de premier plan

Comme canvas.*, le nœud iOS n’autorise les commandes camera.* qu’en premier plan. Les appels en arrière-plan renvoient NODE_BACKGROUND_UNAVAILABLE.

Assistant CLI

Le moyen le plus simple d’obtenir des fichiers médias consiste à utiliser l’assistant CLI, qui écrit les médias décodés dans un fichier temporaire et imprime le chemin enregistré.

Exemples :

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

Notes :

nodes camera snap est réglé par défaut sur les deux orientations pour donner à l’agent les deux vues.
Les fichiers de sortie sont temporaires (dans le répertoire temporaire de l’OS) sauf si vous créez votre propre wrapper.

Nœud Android

Paramètre utilisateur Android (activé par défaut)

Feuille de paramètres Android → Camera → Allow Camera (camera.enabled)
- Par défaut : on (l’absence de clé est traitée comme activée).
- Si désactivé : les commandes camera.* renvoient CAMERA_DISABLED.

Autorisations

Android nécessite des autorisations d’exécution :
- CAMERA pour camera.snap et camera.clip.
- RECORD_AUDIO pour camera.clip lors du includeAudio=true.

Si les autorisations sont manquantes, l’application les demandera si possible ; si elles sont refusées, les requêtes camera.* échouent avec une erreur *_PERMISSION_REQUIRED.

Exigence de premier plan Android

Comme canvas.*, le nœud Android n’autorise les commandes camera.* qu’en premier plan. Les appels en arrière-plan renvoient NODE_BACKGROUND_UNAVAILABLE.

Commandes Android (via Gateway `node.invoke`)

camera.list
- Charge utile de réponse :
  - devices : tableau de { id, name, position, deviceType }

Garantie de charge utile

Les photos sont recompressées pour maintenir la charge utile base64 sous 5 Mo.

Application macOS

Paramètre utilisateur (désactivé par défaut)

L’application compagnon macOS expose une case à cocher :

Settings → General → Allow Camera (openclaw.cameraEnabled)
- Par défaut : désactivé
- Lorsqu’elle est désactivée : les demandes d’accès à la caméra renvoient “Camera disabled by user”.

Assistant CLI (appel de nœud)

Utilisez la CLI principale openclaw pour invoquer les commandes de caméra sur le nœud macOS.