Camera capture

Camera capture 문서는 OpenClaw 공식 문서(nodes/camera)를 한국어로 정리한 가이드입니다. Camera capture on iOS, Android, macOS, and Linux nodes for photos and short video clips 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Camera capture on iOS, Android, macOS, and Linux nodes for photos and short video clips

한국어 가이드 범위: nodes/camera 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

iOS node
iOS user setting
iOS commands (via Gateway node.invoke)
iOS foreground requirement
CLI helper
Android node
Android user setting
Permissions
Android foreground requirement
Android commands (via Gateway node.invoke)
macOS app
macOS user setting
CLI helper (node invoke)
Linux node host
Safety + practical limits
macOS screen video (OS-level)
관련 문서

상세 내용

본문

OpenClaw supports camera capture for agent workflows on paired iOS, Android, macOS, and Linux nodes: capture a photo (jpg) or a short video clip (mp4, with optional audio) via Gateway node.invoke.

iOS node

이 섹션의 세부 항목은 공식 문서 iOS node를 참고하세요.

iOS user setting

주요 항목:

iOS Settings tab → Camera → Allow Camera (camera.enabled).
기본값: on (missing key is treated as enabled).
When off: camera.* commands return CAMERA_DISABLED.

iOS commands (via Gateway node.invoke)

주요 항목:

camera.list
Response payload: devices — array of { id, name, position, deviceType }.
camera.snap
Params:
facing: front|back (default: front)
maxWidth: number (optional; default 1600)
quality: 0..1 (optional; default 0.9, clamped to [0.05, 1.0])
format: currently jpg
delayMs: number (optional; default 0, internally capped at 10000)
deviceId: string (optional; from camera.list)
Response payload: format: "jpg", base64, width, height.
Payload guard: photos are recompressed to keep the base64-encoded payload under 5MB.
camera.clip
Params:
facing: front|back (default: front)
durationMs: number (default 3000, clamped to [250, 60000])
includeAudio: boolean (default true)
format: currently mp4
deviceId: string (optional; from camera.list)
Response payload: format: "mp4", base64, durationMs, hasAudio.

iOS foreground requirement

Like canvas.*, the iOS node only allows camera.* commands in the foreground. Background invocations return NODE_BACKGROUND_UNAVAILABLE.

CLI helper

The easiest way to get media files is via the CLI helper, which writes decoded media to a temp file and prints the saved path.

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

Android node

이 섹션의 세부 항목은 공식 문서 Android node를 참고하세요.

Android user setting

주요 항목:

Android Settings sheet → Camera → Allow Camera (camera.enabled).
Fresh installs default to off. Existing installs that predate this setting are migrated to on so upgrades do not silently lose previously working camera access.
When off: camera.* commands return CAMERA_DISABLED: enable Camera in Settings.

Permissions

The app prompts for runtime permissions when possible.

주요 항목:

CAMERA is required for both camera.snap and camera.clip; missing/denied permission returns CAMERA_PERMISSION_REQUIRED.
RECORD_AUDIO is required for camera.clip when includeAudio is true; missing/denied permission returns MIC_PERMISSION_REQUIRED.

Android foreground requirement

Like canvas.*, the Android node only allows camera.* commands in the foreground. Background invocations return NODE_BACKGROUND_UNAVAILABLE: command requires foreground.

Android commands (via Gateway node.invoke)

주요 항목:

camera.list
Response payload: devices — array of { id, name, position, deviceType }.
camera.snap
Params: facing (front|back, default front), quality (default 0.95, clamped to [0.1, 1.0]), maxWidth (default 1600), deviceId (optional; unknown id fails with INVALID_REQUEST).
Response payload: format: "jpg", base64, width, height.
Payload guard: recompressed to keep base64 under 5MB (same budget as iOS).
camera.clip
Params: facing (default front), durationMs (default 3000, clamped to [200, 60000]), includeAudio (default true), deviceId (optional).
Response payload: format: "mp4", base64, durationMs, hasAudio.
Payload guard: raw MP4 is capped at 18MB before base64 encoding; oversize clips fail with PAYLOAD_TOO_LARGE (reduce durationMs and retry).

macOS app

이 섹션의 세부 항목은 공식 문서 macOS app를 참고하세요.

macOS user setting

The macOS companion app exposes a checkbox:

주요 항목:

Settings → General → Allow Camera (openclaw.cameraEnabled).
기본값: off.
When off: camera requests return CAMERA_DISABLED: enable Camera in Settings.

CLI helper (node invoke)

Use the main openclaw CLI to invoke camera commands on the macOS node.

주요 항목:

openclaw nodes camera snap defaults to maxWidth=1600 unless overridden.
camera.snap waits delayMs (default 2000ms, clamped to [0, 10000]) after warm-up/exposure settle before capturing.
Photo payloads are recompressed to keep base64 under 5MB.

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

Linux node host

The bundled Linux Node plugin adds camera capture to the CLI openclaw node service. It works on a headless host and does not require the Linux desktop app.

주요 항목:

FFmpeg with V4L2 input, libx264, and AAC support
a /dev/video* device readable by the node-service user; on common distributions, add that user to the video group
for clips with the default includeAudio: true, a working PulseAudio server or PipeWire PulseAudio compatibility layer with a default source

{
  plugins: {
    entries: {
      "linux-node": {
        config: {
          camera: { enabled: true },
        },
      },
    },
  },
}

Safety + practical limits

주요 항목:

Camera and microphone access trigger the usual OS permission prompts (and require usage strings in Info.plist).
Video clips are capped at 60s to avoid oversized node payloads (base64 overhead plus message limits).

macOS screen video (OS-level)

For screen video (not camera), use the macOS companion:

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

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/nodes/camera
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

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

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

{
  plugins: {
    entries: {
      "linux-node": {
        config: {
          camera: { enabled: true },
        },
      },
    },
  },
}

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

Camera capture

핵심 요약

Camera capture on iOS, Android, macOS, and Linux nodes for photos and short video clips

한국어 가이드 범위: nodes/camera 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

iOS node
iOS user setting
iOS commands (via Gateway node.invoke)
iOS foreground requirement
CLI helper
Android node
Android user setting
Permissions
Android foreground requirement
Android commands (via Gateway node.invoke)
macOS app
macOS user setting
CLI helper (node invoke)
Linux node host
Safety + practical limits
macOS screen video (OS-level)
관련 문서

상세 내용

본문

iOS node

이 섹션의 세부 항목은 공식 문서 iOS node를 참고하세요.

iOS user setting

주요 항목:

iOS Settings tab → Camera → Allow Camera (camera.enabled).
기본값: on (missing key is treated as enabled).
When off: camera.* commands return CAMERA_DISABLED.

iOS commands (via Gateway node.invoke)

주요 항목:

camera.list
Response payload: devices — array of { id, name, position, deviceType }.
camera.snap
Params:
facing: front|back (default: front)
maxWidth: number (optional; default 1600)
quality: 0..1 (optional; default 0.9, clamped to [0.05, 1.0])
format: currently jpg
delayMs: number (optional; default 0, internally capped at 10000)
deviceId: string (optional; from camera.list)
Response payload: format: "jpg", base64, width, height.
Payload guard: photos are recompressed to keep the base64-encoded payload under 5MB.
camera.clip
Params:
facing: front|back (default: front)
durationMs: number (default 3000, clamped to [250, 60000])
includeAudio: boolean (default true)
format: currently mp4
deviceId: string (optional; from camera.list)
Response payload: format: "mp4", base64, durationMs, hasAudio.

iOS foreground requirement

Like canvas.*, the iOS node only allows camera.* commands in the foreground. Background invocations return NODE_BACKGROUND_UNAVAILABLE.

CLI helper

The easiest way to get media files is via the CLI helper, which writes decoded media to a temp file and prints the saved path.

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

Android node

이 섹션의 세부 항목은 공식 문서 Android node를 참고하세요.

Android user setting

주요 항목:

Android Settings sheet → Camera → Allow Camera (camera.enabled).
Fresh installs default to off. Existing installs that predate this setting are migrated to on so upgrades do not silently lose previously working camera access.
When off: camera.* commands return CAMERA_DISABLED: enable Camera in Settings.

Permissions

The app prompts for runtime permissions when possible.

주요 항목:

CAMERA is required for both camera.snap and camera.clip; missing/denied permission returns CAMERA_PERMISSION_REQUIRED.
RECORD_AUDIO is required for camera.clip when includeAudio is true; missing/denied permission returns MIC_PERMISSION_REQUIRED.

Android foreground requirement

Like canvas.*, the Android node only allows camera.* commands in the foreground. Background invocations return NODE_BACKGROUND_UNAVAILABLE: command requires foreground.

Android commands (via Gateway node.invoke)

주요 항목:

camera.list
Response payload: devices — array of { id, name, position, deviceType }.
camera.snap
Params: facing (front|back, default front), quality (default 0.95, clamped to [0.1, 1.0]), maxWidth (default 1600), deviceId (optional; unknown id fails with INVALID_REQUEST).
Response payload: format: "jpg", base64, width, height.
Payload guard: recompressed to keep base64 under 5MB (same budget as iOS).
camera.clip
Params: facing (default front), durationMs (default 3000, clamped to [200, 60000]), includeAudio (default true), deviceId (optional).
Response payload: format: "mp4", base64, durationMs, hasAudio.
Payload guard: raw MP4 is capped at 18MB before base64 encoding; oversize clips fail with PAYLOAD_TOO_LARGE (reduce durationMs and retry).

macOS app

이 섹션의 세부 항목은 공식 문서 macOS app를 참고하세요.

macOS user setting

The macOS companion app exposes a checkbox:

주요 항목:

Settings → General → Allow Camera (openclaw.cameraEnabled).
기본값: off.
When off: camera requests return CAMERA_DISABLED: enable Camera in Settings.

CLI helper (node invoke)

Use the main openclaw CLI to invoke camera commands on the macOS node.

주요 항목:

openclaw nodes camera snap defaults to maxWidth=1600 unless overridden.
camera.snap waits delayMs (default 2000ms, clamped to [0, 10000]) after warm-up/exposure settle before capturing.
Photo payloads are recompressed to keep base64 under 5MB.

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

Linux node host

The bundled Linux Node plugin adds camera capture to the CLI openclaw node service. It works on a headless host and does not require the Linux desktop app.

주요 항목:

FFmpeg with V4L2 input, libx264, and AAC support
a /dev/video* device readable by the node-service user; on common distributions, add that user to the video group
for clips with the default includeAudio: true, a working PulseAudio server or PipeWire PulseAudio compatibility layer with a default source

{
  plugins: {
    entries: {
      "linux-node": {
        config: {
          camera: { enabled: true },
        },
      },
    },
  },
}

Safety + practical limits

주요 항목:

Camera and microphone access trigger the usual OS permission prompts (and require usage strings in Info.plist).
Video clips are capped at 60s to avoid oversized node payloads (base64 overhead plus message limits).

macOS screen video (OS-level)

For screen video (not camera), use the macOS companion:

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

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/nodes/camera
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

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

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

{
  plugins: {
    entries: {
      "linux-node": {
        config: {
          camera: { enabled: true },
        },
      },
    },
  },
}

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

Camera capture

핵심 요약

문서 구성

상세 내용

본문

iOS node

iOS user setting

iOS commands (via Gateway node.invoke)

iOS foreground requirement

CLI helper

Android node

Android user setting

Permissions

Android foreground requirement

Android commands (via Gateway node.invoke)

macOS app

macOS user setting

CLI helper (node invoke)

Linux node host

Safety + practical limits

macOS screen video (OS-level)

관련 문서

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드

Camera capture

핵심 요약

문서 구성

상세 내용

본문

iOS node

iOS user setting

iOS commands (via Gateway node.invoke)

iOS foreground requirement

CLI helper

Android node

Android user setting

Permissions

Android foreground requirement

Android commands (via Gateway node.invoke)

macOS app

macOS user setting

CLI helper (node invoke)

Linux node host

Safety + practical limits

macOS screen video (OS-level)

관련 문서

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드