カメラキャプチャ

OpenClaw はエージェントワークフロー向けに カメラキャプチャ をサポートしています。

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

すべてのカメラアクセスは ユーザーが制御する設定 によって制限されます。

iOS ノード

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

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

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

• camera.list

  • レスポンスペイロード:
    • devices: { id, name, position, deviceType } の配列

• camera.snap

  • パラメーター:
    • facing: front|back（デフォルト: front）
    • maxWidth: 数値（任意。iOS ノードでのデフォルトは 1600）
    • quality: 0..1（任意。デフォルトは 0.9）
    • format: 現在は jpg
    • delayMs: 数値（任意。デフォルトは 0）
    • deviceId: 文字列（任意。camera.list から取得）
  • レスポンスペイロード:
    • format: "jpg"
    • base64: "<...>"
    • width, height
  • ペイロードガード: base64 ペイロードが 5 MB 未満に収まるよう、写真は再圧縮されます。

• camera.clip

  • パラメーター:
    • facing: front|back（デフォルト: front）
    • durationMs: 数値（デフォルトは 3000、最大 60000 にクランプ）
    • includeAudio: 真偽値（デフォルトは true）
    • format: 現在は mp4
    • deviceId: 文字列（任意。camera.list から取得）
  • レスポンスペイロード:
    • format: "mp4"
    • base64: "<...>"
    • durationMs
    • hasAudio

フォアグラウンド要件

canvas.* と同様に、iOS ノードは フォアグラウンド でのみ camera.* コマンドを許可します。バックグラウンドでの呼び出しは NODE_BACKGROUND_UNAVAILABLE を返します。

CLI ヘルパー

メディアファイルを取得する最も簡単な方法は CLI ヘルパーを使うことです。これはデコードしたメディアを一時ファイルに書き込み、保存先パスを出力します。

例:

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

注:

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

Android ノード

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

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

権限

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

権限がない場合、可能であればアプリがプロンプトを表示します。拒否された場合、camera.* リクエストは *_PERMISSION_REQUIRED エラーで失敗します。

Android フォアグラウンド要件

canvas.* と同様に、Android ノードは フォアグラウンド でのみ camera.* コマンドを許可します。バックグラウンドでの呼び出しは NODE_BACKGROUND_UNAVAILABLE を返します。

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

• camera.list
  • レスポンスペイロード:
    • devices: { id, name, position, deviceType } の配列

ペイロードガード

base64 ペイロードが 5 MB 未満に収まるよう、写真は再圧縮されます。

macOS アプリ

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

macOS コンパニオンアプリはチェックボックスを公開します。

• Settings → General → Allow Camera（openclaw.cameraEnabled）
  • デフォルト: オフ
  • オフの場合: カメラリクエストは「ユーザーによりカメラが無効化されています」を返します。

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

メインの openclaw CLI を使用して、macOS ノード上でカメラコマンドを呼び出します。

例:

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

注:

• openclaw nodes camera snap は、上書きされない限りデフォルトで maxWidth=1600 を使用します。
• macOS では、camera.snap はウォームアップと露出安定後、キャプチャ前に delayMs（デフォルト 2000ms）だけ待機します。
• base64 が 5 MB 未満に収まるよう、写真ペイロードは再圧縮されます。

安全性と実用上の制限

• カメラとマイクへのアクセスでは、通常の OS 権限プロンプトが表示されます（また、Info.plist に用途説明文字列が必要です）。
• 動画クリップは、ノードペイロードが大きくなりすぎるのを避けるために制限されています（現在は <= 60s。base64 のオーバーヘッドとメッセージ制限のため）。

macOS 画面動画（OS レベル）

画面 動画（カメラではない）には、macOS コンパニオンを使用します。

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

注:

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

関連

• 画像とメディアのサポート
• メディア理解
• 位置情報コマンド