--- read_when: - Menambahkan atau memodifikasi pengambilan kamera pada node iOS/Android atau macOS - Memperluas alur kerja file sementara MEDIA yang dapat diakses agen summary: 'Pengambilan kamera (node iOS/Android + aplikasi macOS) untuk penggunaan agen: foto (jpg) dan klip video pendek (mp4)' title: Pengambilan kamera x-i18n: generated_at: "2026-06-27T17:39:55Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 8cb02b1e0e5d68e537dc699bcabacfb48b7beaf07459bf47800810a721191795 source_path: nodes/camera.md workflow: 16 --- OpenClaw mendukung **pengambilan kamera** untuk alur kerja agen: - **Node iOS** (dipasangkan melalui Gateway): ambil **foto** (`jpg`) atau **klip video pendek** (`mp4`, dengan audio opsional) melalui `node.invoke`. - **Node Android** (dipasangkan melalui Gateway): ambil **foto** (`jpg`) atau **klip video pendek** (`mp4`, dengan audio opsional) melalui `node.invoke`. - **Aplikasi macOS** (Node melalui Gateway): ambil **foto** (`jpg`) atau **klip video pendek** (`mp4`, dengan audio opsional) melalui `node.invoke`. Semua akses kamera dibatasi oleh **pengaturan yang dikendalikan pengguna**. ## Node iOS ### Pengaturan pengguna (aktif secara default) - Tab Pengaturan iOS → **Camera** → **Allow Camera** (`camera.enabled`) - Default: **aktif** (kunci yang hilang diperlakukan sebagai aktif). - Saat nonaktif: perintah `camera.*` mengembalikan `CAMERA_DISABLED`. ### Perintah (melalui Gateway `node.invoke`) - `camera.list` - Payload respons: - `devices`: array `{ id, name, position, deviceType }` - `camera.snap` - Param: - `facing`: `front|back` (default: `front`) - `maxWidth`: angka (opsional; default `1600` pada Node iOS) - `quality`: `0..1` (opsional; default `0.9`) - `format`: saat ini `jpg` - `delayMs`: angka (opsional; default `0`) - `deviceId`: string (opsional; dari `camera.list`) - Payload respons: - `format: "jpg"` - `base64: "<...>"` - `width`, `height` - Pembatas payload: foto dikompresi ulang agar payload base64 tetap di bawah 5 MB. - `camera.clip` - Param: - `facing`: `front|back` (default: `front`) - `durationMs`: angka (default `3000`, dibatasi hingga maksimum `60000`) - `includeAudio`: boolean (default `true`) - `format`: saat ini `mp4` - `deviceId`: string (opsional; dari `camera.list`) - Payload respons: - `format: "mp4"` - `base64: "<...>"` - `durationMs` - `hasAudio` ### Persyaratan latar depan Seperti `canvas.*`, Node iOS hanya mengizinkan perintah `camera.*` di **latar depan**. Pemanggilan di latar belakang mengembalikan `NODE_BACKGROUND_UNAVAILABLE`. ### Pembantu CLI Cara termudah untuk mendapatkan berkas media adalah melalui pembantu CLI, yang menulis media yang didekodekan ke berkas sementara dan mencetak path tersimpan. Contoh: ```bash openclaw nodes camera snap --node # default: both front + back (2 MEDIA lines) openclaw nodes camera snap --node --facing front openclaw nodes camera clip --node --duration 3000 openclaw nodes camera clip --node --no-audio ``` Catatan: - `nodes camera snap` secara default menggunakan **kedua** arah hadap kamera untuk memberi agen kedua tampilan. - Berkas output bersifat sementara (di direktori sementara sistem operasi) kecuali Anda membuat wrapper sendiri. ## Node Android ### Pengaturan pengguna Android (aktif secara default) - Lembar Pengaturan Android → **Camera** → **Allow Camera** (`camera.enabled`) - Default: **aktif** (kunci yang hilang diperlakukan sebagai aktif). - Saat nonaktif: perintah `camera.*` mengembalikan `CAMERA_DISABLED`. ### Izin - Android memerlukan izin runtime: - `CAMERA` untuk `camera.snap` dan `camera.clip`. - `RECORD_AUDIO` untuk `camera.clip` saat `includeAudio=true`. Jika izin tidak ada, aplikasi akan meminta izin bila memungkinkan; jika ditolak, permintaan `camera.*` gagal dengan kesalahan `*_PERMISSION_REQUIRED`. ### Persyaratan latar depan Android Seperti `canvas.*`, Node Android hanya mengizinkan perintah `camera.*` di **latar depan**. Pemanggilan di latar belakang mengembalikan `NODE_BACKGROUND_UNAVAILABLE`. ### Perintah Android (melalui Gateway `node.invoke`) - `camera.list` - Payload respons: - `devices`: array `{ id, name, position, deviceType }` ### Pembatas payload Foto dikompresi ulang agar payload base64 tetap di bawah 5 MB. ## Aplikasi macOS ### Pengaturan pengguna (nonaktif secara default) Aplikasi pendamping macOS menyediakan kotak centang: - **Settings → General → Allow Camera** (`openclaw.cameraEnabled`) - Default: **nonaktif** - Saat nonaktif: permintaan kamera mengembalikan "Kamera dinonaktifkan oleh pengguna". ### Pembantu CLI (pemanggilan Node) Gunakan CLI utama `openclaw` untuk memanggil perintah kamera pada Node macOS. Contoh: ```bash openclaw nodes camera list --node # list camera ids openclaw nodes camera snap --node # prints saved path openclaw nodes camera snap --node --max-width 1280 openclaw nodes camera snap --node --delay-ms 2000 openclaw nodes camera snap --node --device-id openclaw nodes camera clip --node --duration 10s # prints saved path openclaw nodes camera clip --node --duration-ms 3000 # prints saved path (legacy flag) openclaw nodes camera clip --node --device-id openclaw nodes camera clip --node --no-audio ``` Catatan: - `openclaw nodes camera snap` secara default menggunakan `maxWidth=1600` kecuali ditimpa. - Pada macOS, `camera.snap` menunggu `delayMs` (default 2000ms) setelah pemanasan/eksposur stabil sebelum mengambil gambar. - Payload foto dikompresi ulang agar base64 tetap di bawah 5 MB. ## Keamanan + batas praktis - Akses kamera dan mikrofon memicu prompt izin sistem operasi biasa (dan memerlukan string penggunaan di Info.plist). - Klip video dibatasi (saat ini `<= 60s`) untuk menghindari payload Node yang terlalu besar (overhead base64 + batas pesan). ## Video layar macOS (level OS) Untuk video _layar_ (bukan kamera), gunakan pendamping macOS: ```bash openclaw nodes screen record --node --duration 10s --fps 15 # prints saved path ``` Catatan: - Memerlukan izin **Screen Recording** macOS (TCC). ## Terkait - [Dukungan gambar dan media](/id/nodes/images) - [Pemahaman media](/id/nodes/media-understanding) - [Perintah lokasi](/id/nodes/location-command)