Kamerainspelning (agent)¶

OpenClaw stöder kamerainspelning för agentarbetsflöden:

• iOS-nod (parad via Gateway): ta ett foto (jpg) eller ett kort videoklipp (mp4, med valfritt ljud) via node.invoke.
• Android-nod (parad via Gateway): ta ett foto (jpg) eller ett kort videoklipp (mp4, med valfritt ljud) via node.invoke.
• macOS-app (nod via Gateway): ta ett foto (jpg) eller ett kort videoklipp (mp4, med valfritt ljud) via node.invoke.

All kameratillgång är spärrad bakom användarkontrollerade inställningar.

iOS-nod¶

Användarinställning (standard på)¶

• iOS-inställningsfliken → Kamera → Tillåt kamera (camera.enabled)
• Standard: på (saknad nyckel behandlas som aktiverad).
• När av: camera.*-kommandon returnerar CAMERA_DISABLED.

Kommandon (via Gateway node.invoke)¶

• camera.list

• Svarspayload:

  • devices: array av { id, name, position, deviceType }

• camera.snap

• Parametrar:
  • facing: front|back (standard: front)
  • maxWidth: number (valfri; standard 1600 på iOS-noden)
  • quality: 0..1 (valfri; standard 0.9)
  • format: för närvarande jpg
  • delayMs: number (valfri; standard 0)
  • deviceId: string (valfri; från camera.list)
• Svarspayload:
  • format: "jpg"
  • base64: "<...>"
  • width, height

• Payload-skydd: foton rekomprimeras för att hålla base64-payloaden under 5 MB.

• camera.clip

• Parametrar:
  • facing: front|back (standard: front)
  • durationMs: number (standard 3000, begränsad till max 60000)
  • includeAudio: boolean (standard true)
  • format: för närvarande mp4
  • deviceId: string (valfri; från camera.list)
• Svarspayload:
  • format: "mp4"
  • base64: "<...>"
  • durationMs
  • hasAudio

Förgrundskrav¶

Som canvas.*, tillåter iOS-noden endast camera.* kommandon i förgrunden. Bakgrundsinciteringar returnerar NODE_BACKGROUND_UNAVAILABLE.

CLI-hjälpare (temporära filer + MEDIA)¶

Det enklaste sättet att få bilagor är via CLI-hjälparen, som skriver avkodad media till en temporär fil och skriver ut MEDIA:<path>.

Exempel:

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

Noteringar:

• nodes camera snap är som standard båda riktningarna för att ge agenten båda vyerna.
• Utdatafiler är temporära (i OS:ets temporära katalog) om du inte bygger ett eget omslag.

Android-nod¶

Android-användarinställning (standard på)¶

• Android-inställningsblad → Kamera → Tillåt kamera (camera.enabled)
• Standard: på (saknad nyckel behandlas som aktiverad).
• När av: camera.*-kommandon returnerar CAMERA_DISABLED.

Behörigheter¶

• Android kräver körningsbehörigheter:
• CAMERA för både camera.snap och camera.clip.
• RECORD_AUDIO för camera.clip när includeAudio=true.

Om behörigheter saknas uppmanar appen när det är möjligt; om de nekas misslyckas camera.*-begäranden med ett *_PERMISSION_REQUIRED-fel.

Android-krav på förgrund¶

Som canvas.*, tillåter Android-noden endast camera.* kommandon i förgrunden. Bakgrundsinciteringar returnerar NODE_BACKGROUND_UNAVAILABLE.

Payload-skydd¶

Foton rekomprimeras för att hålla base64-payloaden under 5 MB.

macOS-app¶

Användarinställning (standard av)¶

macOS companion-appen exponerar en kryssruta:

• Inställningar → Allmänt → Tillåt kamera (openclaw.cameraEnabled)
• Standard: av
• När av: kamerabegäranden returnerar ”Kamera inaktiverad av användaren”.

CLI-hjälpare (nodanrop)¶

Använd huvud-CLI:t openclaw för att anropa kamerakommandon på macOS-noden.

Exempel:

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

Noteringar:

• openclaw nodes camera snap är som standard maxWidth=1600 om inget annat anges.
• På macOS väntar camera.snap delayMs (standard 2000 ms) efter uppvärmning/exponeringsstabilisering innan inspelning.
• Fotopayloads rekomprimeras för att hålla base64 under 5 MB.

Säkerhet + praktiska gränser¶

• Kamera- och mikrofonåtkomst triggar de vanliga OS-behörighetspromptarna (och kräver användningssträngar i Info.plist).
• Videoklipp är begränsade (för närvarande <= 60s) för att undvika överstora nodpayloads (base64-overhead + meddelandegränser).

macOS-skärmvideo (OS-nivå)¶

För skärm-video (inte kamera), använd macOS companion:

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

Noteringar:

• Kräver macOS-behörigheten Skärminspelning (TCC).