--- read_when: - Aggiunta o modifica dell'acquisizione dalla fotocamera sui nodi iOS/Android o macOS - Estensione dei flussi di lavoro con file temporanei MEDIA accessibili agli agenti summary: 'Acquisizione dalla fotocamera (nodi iOS/Android + app macOS) per l''uso da parte dell''agente: foto (jpg) e brevi clip video (mp4)' title: Acquisizione dalla fotocamera x-i18n: generated_at: "2026-06-27T17:42:23Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 8cb02b1e0e5d68e537dc699bcabacfb48b7beaf07459bf47800810a721191795 source_path: nodes/camera.md workflow: 16 --- OpenClaw supporta la **cattura da fotocamera** per i flussi di lavoro degli agenti: - **Node iOS** (associato tramite Gateway): cattura una **foto** (`jpg`) o una **breve clip video** (`mp4`, con audio opzionale) tramite `node.invoke`. - **Node Android** (associato tramite Gateway): cattura una **foto** (`jpg`) o una **breve clip video** (`mp4`, con audio opzionale) tramite `node.invoke`. - **App macOS** (Node tramite Gateway): cattura una **foto** (`jpg`) o una **breve clip video** (`mp4`, con audio opzionale) tramite `node.invoke`. Tutto l’accesso alla fotocamera è protetto da **impostazioni controllate dall’utente**. ## Node iOS ### Impostazione utente (attiva per impostazione predefinita) - Scheda Impostazioni iOS → **Fotocamera** → **Consenti fotocamera** (`camera.enabled`) - Predefinito: **attivo** (una chiave mancante viene trattata come abilitata). - Quando è disattivo: i comandi `camera.*` restituiscono `CAMERA_DISABLED`. ### Comandi (tramite Gateway `node.invoke`) - `camera.list` - Payload della risposta: - `devices`: array di `{ id, name, position, deviceType }` - `camera.snap` - Parametri: - `facing`: `front|back` (predefinito: `front`) - `maxWidth`: numero (opzionale; predefinito `1600` sul Node iOS) - `quality`: `0..1` (opzionale; predefinito `0.9`) - `format`: attualmente `jpg` - `delayMs`: numero (opzionale; predefinito `0`) - `deviceId`: stringa (opzionale; da `camera.list`) - Payload della risposta: - `format: "jpg"` - `base64: "<...>"` - `width`, `height` - Protezione del payload: le foto vengono ricompresse per mantenere il payload base64 sotto 5 MB. - `camera.clip` - Parametri: - `facing`: `front|back` (predefinito: `front`) - `durationMs`: numero (predefinito `3000`, limitato a un massimo di `60000`) - `includeAudio`: booleano (predefinito `true`) - `format`: attualmente `mp4` - `deviceId`: stringa (opzionale; da `camera.list`) - Payload della risposta: - `format: "mp4"` - `base64: "<...>"` - `durationMs` - `hasAudio` ### Requisito di primo piano Come `canvas.*`, il Node iOS consente i comandi `camera.*` solo in **primo piano**. Le invocazioni in background restituiscono `NODE_BACKGROUND_UNAVAILABLE`. ### Helper CLI Il modo più semplice per ottenere file multimediali è tramite l’helper CLI, che scrive i media decodificati in un file temporaneo e stampa il percorso salvato. Esempi: ```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 ``` Note: - `nodes camera snap` usa come predefiniti **entrambi** gli orientamenti per fornire all’agente entrambe le viste. - I file di output sono temporanei (nella directory temporanea del sistema operativo), a meno che tu non crei un wrapper personalizzato. ## Node Android ### Impostazione utente Android (attiva per impostazione predefinita) - Foglio Impostazioni Android → **Fotocamera** → **Consenti fotocamera** (`camera.enabled`) - Predefinito: **attivo** (una chiave mancante viene trattata come abilitata). - Quando è disattivo: i comandi `camera.*` restituiscono `CAMERA_DISABLED`. ### Autorizzazioni - Android richiede autorizzazioni di runtime: - `CAMERA` sia per `camera.snap` sia per `camera.clip`. - `RECORD_AUDIO` per `camera.clip` quando `includeAudio=true`. Se le autorizzazioni mancano, l’app le richiederà quando possibile; se vengono negate, le richieste `camera.*` non riescono con un errore `*_PERMISSION_REQUIRED`. ### Requisito di primo piano su Android Come `canvas.*`, il nodo Android consente i comandi `camera.*` solo in **primo piano**. Le invocazioni in background restituiscono `NODE_BACKGROUND_UNAVAILABLE`. ### Comandi Android (tramite Gateway `node.invoke`) - `camera.list` - Payload di risposta: - `devices`: array di `{ id, name, position, deviceType }` ### Protezione del payload Le foto vengono ricompresse per mantenere il payload base64 sotto i 5 MB. ## App macOS ### Impostazione utente (disattivata per impostazione predefinita) L'app companion macOS espone una casella di controllo: - **Settings → General → Allow Camera** (`openclaw.cameraEnabled`) - Valore predefinito: **disattivato** - Quando è disattivata: le richieste della fotocamera restituiscono "Fotocamera disattivata dall'utente". ### Helper CLI (`node invoke`) Usa la CLI principale `openclaw` per invocare i comandi della fotocamera sul nodo macOS. Esempi: ```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 ``` Note: - `openclaw nodes camera snap` usa per impostazione predefinita `maxWidth=1600`, salvo override. - Su macOS, `camera.snap` attende `delayMs` (valore predefinito 2000 ms) dopo il riscaldamento e l'assestamento dell'esposizione prima di acquisire. - I payload delle foto vengono ricompressi per mantenere base64 sotto i 5 MB. ## Sicurezza + limiti pratici - L'accesso a fotocamera e microfono attiva le consuete richieste di autorizzazione del sistema operativo (e richiede stringhe di utilizzo in Info.plist). - I clip video sono limitati (attualmente `<= 60s`) per evitare payload del nodo troppo grandi (overhead base64 + limiti dei messaggi). ## Video dello schermo macOS (a livello di sistema operativo) Per i video dello _schermo_ (non della fotocamera), usa l'app companion macOS: ```bash openclaw nodes screen record --node --duration 10s --fps 15 # prints saved path ``` Note: - Richiede l'autorizzazione **Screen Recording** di macOS (TCC). ## Correlati - [Supporto per immagini e media](/it/nodes/images) - [Comprensione dei media](/it/nodes/media-understanding) - [Comando di localizzazione](/it/nodes/location-command)