​

カメラキャプチャ（エージェント）

• iOS ノード（Gateway（ゲートウェイ）経由でペアリング）：node.invoke により 写真（jpg）または 短い動画クリップ（mp4、任意で音声付き）をキャプチャします。
• Android ノード（Gateway（ゲートウェイ）経由でペアリング）：node.invoke により 写真（jpg）または 短い動画クリップ（mp4、任意で音声付き）をキャプチャします。
• macOS アプリ（Gateway（ゲートウェイ）経由のノード）：node.invoke により 写真（jpg）または 短い動画クリップ（mp4、任意で音声付き）をキャプチャします。

​

iOS ノード

​

ユーザー設定（既定でオン）

• iOS 設定タブ → Camera → Allow Camera（camera.enabled）
  • 既定値：オン（キーが存在しない場合は有効として扱われます）。
  • オフの場合：camera.* コマンドは CAMERA_DISABLED を返します。

​

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

• camera.list
  • レスポンスペイロード：
    • devices：{ id, name, position, deviceType } の配列
• camera.snap
  • Params:
    • facing：front|back（既定値：front）
    • maxWidth：number（任意；iOS ノードでは既定 1600）
    • quality：0..1（任意；既定 0.9）
    • format：現在は jpg
    • delayMs：number（任意；既定 0）
    • deviceId：string（任意；camera.list から）
  • レスポンスペイロード：
    • format: "jpg"
    • base64: "<...>"
    • width、height
  • ペイロードガード：写真は、base64 ペイロードが 5 MB 未満になるよう再圧縮されます。
• camera.clip
  • Params:
    • facing：front|back（既定値：front）
    • durationMs：number（既定 3000、最大 60000 にクランプ）
    • includeAudio：boolean（既定 true）
    • format：現在は mp4
    • deviceId：string（任意；camera.list から）
  • レスポンスペイロード：
    • format: "mp4"
    • base64: "<...>"
    • durationMs
    • hasAudio

​

フォアグラウンド要件

​

CLI ヘルパー（一時ファイル + MEDIA）

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

• nodes camera snap は、エージェントに両方の視点を提供するため、既定で 両方 の向きになります。
• 出力ファイルは、独自のラッパーを構築しない限り、一時的（OS の一時ディレクトリ内）です。

​

Android ノード

​

Android ユーザー設定（既定でオン）

• Android 設定シート → Camera → Allow Camera（camera.enabled）
  • 既定値：オン（キーが存在しない場合は有効として扱われます）。
  • オフの場合：camera.* コマンドは CAMERA_DISABLED を返します。

​

権限

• Android では実行時権限が必要です。
  • CAMERA：camera.snap と camera.clip の両方に必要です。
  • RECORD_AUDIO：includeAudio=true の場合に camera.clip に必要です。

​

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

​

ペイロードガード

​

macOS アプリ

​

ユーザー設定（既定でオフ）

• Settings → General → Allow Camera（openclaw.cameraEnabled）
  • 既定値：オフ
  • オフの場合：カメラ要求は「Camera disabled by user」を返します。

​

CLI ヘルパー（ノード呼び出し）

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

• openclaw nodes camera snap は、上書きされない限り既定で maxWidth=1600 です。
• macOS では、camera.snap はウォームアップ／露出の安定後に delayMs（既定 2000 ms）待機してからキャプチャします。
• 写真のペイロードは、base64 が 5 MB 未満になるよう再圧縮されます。

​

安全性 + 実用上の制限

• カメラおよびマイクへのアクセスは、通常の OS 権限プロンプトをトリガーします（Info.plist に使用目的の文字列が必要です）。
• 動画クリップは、ノードのペイロードが過大にならないよう（base64 のオーバーヘッド + メッセージ制限）、上限（現在は <= 60s）が設定されています。

​

macOS 画面動画（OS レベル）

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

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