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

# कैमरा कैप्चर

OpenClaw agent workflows के लिए **कैमरा कैप्चर** का समर्थन करता है:

* **iOS Node** (Gateway के जरिए पेयर किया गया): `node.invoke` के जरिए **फ़ोटो** (`jpg`) या **छोटी वीडियो क्लिप** (`mp4`, वैकल्पिक ऑडियो के साथ) कैप्चर करें।
* **Android Node** (Gateway के जरिए पेयर किया गया): `node.invoke` के जरिए **फ़ोटो** (`jpg`) या **छोटी वीडियो क्लिप** (`mp4`, वैकल्पिक ऑडियो के साथ) कैप्चर करें।
* **macOS ऐप** (Gateway के जरिए Node): `node.invoke` के जरिए **फ़ोटो** (`jpg`) या **छोटी वीडियो क्लिप** (`mp4`, वैकल्पिक ऑडियो के साथ) कैप्चर करें।

सभी कैमरा एक्सेस **उपयोगकर्ता-नियंत्रित सेटिंग्स** के पीछे नियंत्रित है।

## iOS Node

### उपयोगकर्ता सेटिंग (डिफ़ॉल्ट रूप से चालू)

* iOS Settings टैब → **Camera** → **Allow Camera** (`camera.enabled`)
  * डिफ़ॉल्ट: **चालू** (अनुपस्थित कुंजी को सक्षम माना जाता है)।
  * बंद होने पर: `camera.*` कमांड `CAMERA_DISABLED` लौटाते हैं।

### कमांड (Gateway `node.invoke` के जरिए)

* `camera.list`
  * प्रतिक्रिया payload:
    * `devices`: `{ id, name, position, deviceType }` की array

* `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 से कम रखने के लिए फ़ोटो को फिर से compress किया जाता है।

* `camera.clip`
  * Params:
    * `facing`: `front|back` (डिफ़ॉल्ट: `front`)
    * `durationMs`: number (डिफ़ॉल्ट `3000`, अधिकतम `60000` तक सीमित)
    * `includeAudio`: boolean (डिफ़ॉल्ट `true`)
    * `format`: वर्तमान में `mp4`
    * `deviceId`: string (वैकल्पिक; `camera.list` से)
  * प्रतिक्रिया payload:
    * `format: "mp4"`
    * `base64: "<...>"`
    * `durationMs`
    * `hasAudio`

### Foreground आवश्यकता

`canvas.*` की तरह, iOS Node केवल **foreground** में `camera.*` कमांड की अनुमति देता है। Background invocations `NODE_BACKGROUND_UNAVAILABLE` लौटाते हैं।

### CLI helper

मीडिया फ़ाइलें पाने का सबसे आसान तरीका CLI helper है, जो decoded media को temp file में लिखता है और saved path print करता है।

उदाहरण:

```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` agent को दोनों views देने के लिए डिफ़ॉल्ट रूप से **दोनों** facings का उपयोग करता है।
* Output files अस्थायी होती हैं (OS temp directory में), जब तक आप अपना wrapper नहीं बनाते।

## Android Node

### Android उपयोगकर्ता सेटिंग (डिफ़ॉल्ट रूप से चालू)

* Android Settings sheet → **Camera** → **Allow Camera** (`camera.enabled`)
  * डिफ़ॉल्ट: **चालू** (अनुपस्थित कुंजी को सक्षम माना जाता है)।
  * बंद होने पर: `camera.*` कमांड `CAMERA_DISABLED` लौटाते हैं।

### अनुमतियां

* Android को runtime permissions चाहिए:
  * `camera.snap` और `camera.clip` दोनों के लिए `CAMERA`।
  * `includeAudio=true` होने पर `camera.clip` के लिए `RECORD_AUDIO`।

यदि permissions अनुपस्थित हैं, तो ऐप संभव होने पर prompt करेगा; यदि denied हो, तो `camera.*` requests
`*_PERMISSION_REQUIRED` error के साथ fail होती हैं।

### Android foreground आवश्यकता

`canvas.*` की तरह, Android Node केवल **foreground** में `camera.*` कमांड की अनुमति देता है। Background invocations `NODE_BACKGROUND_UNAVAILABLE` लौटाते हैं।

### Android कमांड (Gateway `node.invoke` के जरिए)

* `camera.list`
  * प्रतिक्रिया payload:
    * `devices`: `{ id, name, position, deviceType }` की array

### Payload guard

base64 payload को 5 MB से कम रखने के लिए फ़ोटो को फिर से compress किया जाता है।

## macOS ऐप

### उपयोगकर्ता सेटिंग (डिफ़ॉल्ट रूप से बंद)

macOS companion ऐप एक checkbox दिखाता है:

* **Settings → General → Allow Camera** (`openclaw.cameraEnabled`)
  * डिफ़ॉल्ट: **बंद**
  * बंद होने पर: camera requests "Camera disabled by user" लौटाती हैं।

### CLI helper (Node invoke)

macOS Node पर camera commands invoke करने के लिए मुख्य `openclaw` CLI का उपयोग करें।

उदाहरण:

```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 saved 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 saved path
openclaw 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` override न होने पर डिफ़ॉल्ट रूप से `maxWidth=1600` का उपयोग करता है।
* macOS पर, `camera.snap` capture करने से पहले warm-up/exposure settle के बाद `delayMs` (डिफ़ॉल्ट 2000ms) प्रतीक्षा करता है।
* base64 को 5 MB से कम रखने के लिए photo payloads को फिर से compress किया जाता है।

## सुरक्षा + व्यावहारिक सीमाएं

* Camera और microphone access सामान्य OS permission prompts trigger करते हैं (और Info.plist में usage strings की आवश्यकता होती है)।
* Video clips को oversized Node payloads (base64 overhead + message limits) से बचने के लिए सीमित किया जाता है (वर्तमान में `<= 60s`)।

## macOS screen video (OS-level)

*camera* नहीं, बल्कि *screen* video के लिए macOS companion का उपयोग करें:

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

नोट्स:

* macOS **Screen Recording** permission (TCC) आवश्यक है।

## संबंधित

* [Image और media support](/hi/nodes/images)
* [Media understanding](/hi/nodes/media-understanding)
* [Location command](/hi/nodes/location-command)