> ## Documentation Index
> Fetch the complete documentation index at: https://openclawdoc.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Camera Capture

> OpenClaw は、エージェントワークフロー向けに camera capture をサポートしています。カメラアクセスはすべて ユーザーが制御する設定 の背後にあります。

OpenClaw は、エージェントワークフロー向けに **camera capture** をサポートしています。

* **iOS node**（Gateway 経由でペアリング）: `node.invoke` で **写真**（`jpg`）または **短い動画クリップ**（`mp4`、音声は任意）を取得できます
* **Android node**（Gateway 経由でペアリング）: `node.invoke` で **写真**（`jpg`）または **短い動画クリップ**（`mp4`、音声は任意）を取得できます
* **macOS app**（Gateway 配下の node）: `node.invoke` で **写真**（`jpg`）または **短い動画クリップ**（`mp4`、音声は任意）を取得できます

カメラアクセスはすべて **ユーザーが制御する設定** の背後にあります。

## iOS node

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

* iOS の Settings タブ → **Camera** → **Allow Camera**（`camera.enabled`）
  * デフォルト: **on**（キー未設定でも有効として扱う）
  * off の場合: `camera.*` コマンドは `CAMERA_DISABLED` を返す

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

* `camera.list`
  * 応答ペイロード:
    * `devices`: `{ id, name, position, deviceType }` の配列

* `camera.snap`
  * パラメータ:
    * `facing`: `front|back`（デフォルト: `front`）
    * `maxWidth`: number（任意。iOS node のデフォルトは `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`
  * パラメータ:
    * `facing`: `front|back`（デフォルト: `front`）
    * `durationMs`: number（デフォルト `3000`、最大 `60000` にクランプ）
    * `includeAudio`: boolean（デフォルト `true`）
    * `format`: 現在は `mp4`
    * `deviceId`: string（任意。`camera.list` で取得）
  * 応答ペイロード:
    * `format: "mp4"`
    * `base64: "<...>"`
    * `durationMs`
    * `hasAudio`

### フォアグラウンド要件

`canvas.*` と同様に、iOS node では **foreground** 中のみ `camera.*` を実行できます。background から呼び出した場合は `NODE_BACKGROUND_UNAVAILABLE` を返します。

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

添付ファイルとして扱う最も簡単な方法は、デコード済みメディアを一時ファイルへ書き込み、`MEDIA:<path>` を出力する CLI helper を使うことです。

例:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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` はデフォルトで **両方の向き** を取得し、エージェントに front / back 両方の視点を渡します
* 自前のラッパーを作らない限り、出力ファイルは OS の一時ディレクトリ上のテンポラリファイルです

## Android node

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

* Android の Settings sheet → **Camera** → **Allow Camera**（`camera.enabled`）
  * デフォルト: **on**（キー未設定でも有効として扱う）
  * off の場合: `camera.*` コマンドは `CAMERA_DISABLED` を返す

### 権限

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

権限が不足している場合、可能であればアプリが権限要求を出します。拒否された場合、`camera.*` リクエストは `*_PERMISSION_REQUIRED` で失敗します。

### Android の foreground 要件

`canvas.*` と同様に、Android node でも **foreground** 中のみ `camera.*` を実行できます。background からの呼び出しは `NODE_BACKGROUND_UNAVAILABLE` を返します。

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

* `camera.list`
  * 応答ペイロード:
    * `devices`: `{ id, name, position, deviceType }` の配列

### ペイロード保護

写真は base64 ペイロードを 5 MB 未満に抑えるため再圧縮されます。

## macOS app

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

macOS companion app には次のチェックボックスがあります。

* **Settings → General → Allow Camera**（`openclaw.cameraEnabled`）
  * デフォルト: **off**
  * off の場合: カメラ要求は “Camera disabled by user” を返す

### CLI helper（node invoke）

メインの `openclaw` CLI を使って、macOS node に camera command を送れます。

例:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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` は、warm-up / 露出安定のあと `delayMs`（デフォルト 2000ms）だけ待ってから撮影します
* 写真ペイロードは base64 が 5 MB 未満になるよう再圧縮されます

## セーフティと実用上の制限

* カメラおよびマイクの使用時には、通常の OS 権限プロンプトが表示されます（Info.plist の usage string も必要）
* ノードペイロードの肥大化（base64 オーバーヘッド + メッセージ制限）を避けるため、動画クリップは現在 `<= 60s` に制限されています

## macOS の画面動画（OS レベル）

*screen* 動画（カメラではなく画面）については、macOS companion を使用します。

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw nodes screen record --node <id> --duration 10s --fps 15   # prints MEDIA:<path>
```

注:

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