​

Camera capture（agent）

• iOS node（Gateway経由でpair）: node.invoke を通じて写真（jpg）または短い動画クリップ（mp4、任意でaudio付き）を撮影できます。
• Android node（Gateway経由でpair）: node.invoke を通じて写真（jpg）または短い動画クリップ（mp4、任意でaudio付き）を撮影できます。
• macOS app（Gateway経由のnode）: node.invoke を通じて写真（jpg）または短い動画クリップ（mp4、任意でaudio付き）を撮影できます。

​

iOS node

​

ユーザー設定（デフォルトでオン）

• iOS Settingsタブ → Camera → Allow Camera (camera.enabled)
  • デフォルト: on（キーが存在しない場合は有効として扱われます）。
  • オフ時: camera.* コマンドは CAMERA_DISABLED を返します。

​

コマンド（Gateway node.invoke 経由）

• camera.list
  • レスポンスpayload:
    • devices: { id, name, position, deviceType } の配列
• camera.snap
  • Params:
    • facing: front|back（デフォルト: front）
    • maxWidth: number（任意。iOS nodeでのデフォルトは 1600）
    • quality: 0..1（任意。デフォルトは 0.9）
    • format: 現在は jpg
    • delayMs: number（任意。デフォルトは 0）
    • deviceId: string（任意。camera.list から取得）
  • レスポンスpayload:
    • format: "jpg"
    • base64: "<...>"
    • width, height
  • Payload guard: 写真は、base64 payloadが5 MB未満に収まるよう再圧縮されます。
• camera.clip
  • Params:
    • facing: front|back（デフォルト: front）
    • durationMs: number（デフォルト 3000、最大 60000 にclamp）
    • includeAudio: boolean（デフォルト true）
    • format: 現在は mp4
    • deviceId: string（任意。camera.list から取得）
  • レスポンスpayload:
    • format: "mp4"
    • base64: "<...>"
    • durationMs
    • hasAudio

​

フォアグラウンド要件

​

CLI helper（一時ファイル + MEDIA）

openclaw nodes camera snap --node <id>               # デフォルト: front + back の両方（2つのMEDIA行）
openclaw nodes camera snap --node <id> --facing front
openclaw nodes camera clip --node <id> --duration 3000
openclaw nodes camera clip --node <id> --no-audio

• nodes camera snap はデフォルトで両方の向きを対象にし、エージェントへ両方の視点を渡します。
• 独自のwrapperを作らない限り、出力ファイルは一時ファイルです（OSの一時ディレクトリ内）。

​

Android node

​

Androidのユーザー設定（デフォルトでオン）

• Android Settingsシート → Camera → Allow Camera (camera.enabled)
  • デフォルト: on（キーが存在しない場合は有効として扱われます）。
  • オフ時: camera.* コマンドは CAMERA_DISABLED を返します。

​

権限

• Androidではランタイム権限が必要です。
  • camera.snap と camera.clip の両方に CAMERA。
  • includeAudio=true の camera.clip には RECORD_AUDIO。

​

Androidのフォアグラウンド要件

​

Androidコマンド（Gateway node.invoke 経由）

• camera.list
  • レスポンスpayload:
    • devices: { id, name, position, deviceType } の配列

​

Payload guard

​

macOS app

​

ユーザー設定（デフォルトでオフ）

• Settings → General → Allow Camera (openclaw.cameraEnabled)
  • デフォルト: off
  • オフ時: cameraリクエストは「Camera disabled by user」を返します。

​

CLI helper（node invoke）

openclaw nodes camera list --node <id>            # camera id一覧
openclaw nodes camera snap --node <id>            # 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          # MEDIA:<path> を出力
openclaw nodes camera clip --node <id> --duration-ms 3000      # MEDIA:<path> を出力（legacy flag）
openclaw nodes camera clip --node <id> --device-id <id>
openclaw nodes camera clip --node <id> --no-audio

• openclaw nodes camera snap は、上書きされない限りデフォルトで maxWidth=1600 を使います。
• macOSでは、camera.snap はwarm-up/exposureが落ち着いた後、撮影前に delayMs（デフォルト 2000ms）待機します。
• 写真payloadは、base64が5 MB未満に収まるよう再圧縮されます。

​

安全性と実用上の制限

• cameraとmicrophoneへのアクセスでは、通常のOS権限プロンプトが表示されます（また、Info.plist内のusage stringも必要です）。
• 動画クリップは、node payloadの肥大化（base64のオーバーヘッド + メッセージ制限）を避けるため、上限があります（現在は <= 60s）。

​

macOS screen video（OSレベル）

openclaw nodes screen record --node <id> --duration 10s --fps 15   # MEDIA:<path> を出力

• macOSのScreen Recording権限（TCC）が必要です。