相机捕获

​

相机捕获（代理）

OpenClaw 支持用于代理工作流的 相机捕获：

• iOS 节点（通过 Gateway 网关 配对）：通过 node.invoke 捕获照片 (jpg) 或短视频片段 (mp4，可选音频)。
• Android 节点（通过 Gateway 网关 配对）：通过 node.invoke 捕获照片 (jpg) 或短视频片段 (mp4，可选音频)。
• macOS 应用（通过 Gateway 网关 作为节点）：通过 node.invoke 捕获照片 (jpg) 或短视频片段 (mp4，可选音频)。

所有相机访问都受 用户控制的设置 限制。

​

iOS 节点

​

用户设置（默认开启）

• iOS 设置选项卡 → 相机 → 允许相机 (camera.enabled)
  • 默认值：on（缺少键被视为已启用）。
  • 关闭时：camera.* 命令返回 CAMERA_DISABLED。

​

命令（通过 Gateway(网关) node.invoke）

• camera.list

  • 响应负载：
    • devices：{ id, name, position, deviceType } 数组

• camera.snap

  • 参数：
    • facing：front|back（默认值：front）
    • maxWidth：数字（可选；iOS 节点上的默认值为 1600）
    • quality：0..1（可选；默认值为 0.9）
    • format：目前为 jpg
    • delayMs：数字（可选；默认值为 0）
    • deviceId：字符串（可选；来自 camera.list）
  • 响应负载：
    • format: "jpg"
    • base64: "<...>"
    • width、height
  • 负载保护：照片会被重新压缩，以使 base64 负载保持在 5 MB 以下。

• camera.clip

  • 参数：
    • facing：front|back（默认值：front）
    • durationMs：数字（默认值 3000，最大限制为 60000）
    • includeAudio：布尔值（默认值 true）
    • format：目前为 mp4
    • deviceId：字符串（可选；来自 camera.list）
  • 响应负载：
    • format: "mp4"
    • base64: "<...>"
    • durationMs
    • hasAudio

​

前台要求

与 canvas.* 类似，iOS 节点仅允许在前台执行 camera.* 命令。后台调用将返回 NODE_BACKGROUND_UNAVAILABLE。

​

CLI 辅助工具（临时文件 + MEDIA）

获取附件最简单的方法是通过 CLI 辅助工具，该工具将解码后的媒体写入临时文件并打印 MEDIA:<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

注意：

• nodes camera snap 默认为 both（两者），以便为代理提供两个视角。
• 除非您构建自己的包装程序，否则输出文件是临时的（位于操作系统临时目录中）。

​

Android 节点

​

Android 用户设置（默认开启）

• Android 设置表 → 相机 → 允许相机（camera.enabled）
  • 默认值：on（缺少键被视为已启用）。
  • 关闭时：camera.* 命令返回 CAMERA_DISABLED。

​

权限

• Android 需要运行时权限：
  • CAMERA 用于 camera.snap 和 camera.clip。
  • RECORD_AUDIO 用于 camera.clip 当 includeAudio=true 时。

如果缺少权限，应用会在可能的情况下提示；如果被拒绝，camera.* 请求将失败，并出现 *_PERMISSION_REQUIRED 错误。

​

Android 前台要求

像 canvas.* 一样，Android 节点仅允许在前台执行 camera.* 命令。后台调用返回 NODE_BACKGROUND_UNAVAILABLE。

​

Android 命令（通过 Gateway(网关) node.invoke）

• camera.list
  • 响应载荷：
    • devices：{ id, name, position, deviceType } 数组

​

载荷保护

照片会被重新压缩，以将 base64 载荷保持在 5 MB 以下。

​

macOS 应用

​

用户设置（默认关闭）

macOS 配套应用提供了一个复选框：

• Settings（设置） → General（通用） → Allow Camera（允许相机） (openclaw.cameraEnabled)
  • 默认值：off
  • 关闭时：相机请求返回“Camera disabled by user”（用户禁用了相机）。

​

CLI 辅助工具（节点调用）

使用主 openclaw CLI 在 macOS 节点上调用相机命令。

示例：

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

注意：

• 除非被覆盖，否则 openclaw nodes camera snap 默认为 maxWidth=1600。
• 在 macOS 上，camera.snap 在预热/曝光稳定后会等待 delayMs（默认 2000ms）再进行捕获。
• 照片有效载荷会重新压缩，以将 base64 大小保持在 5 MB 以下。

​

安全性与实际限制

• 相机和麦克风访问会触发通常的操作系统权限提示（并且需要在 Info.plist 中包含使用说明字符串）。
• 视频片段会被限制（目前为 <= 60s），以避免节点有效载荷过大（base64 开销 + 消息限制）。

​

macOS 屏幕视频（操作系统级别）

对于屏幕视频（而非相机），请使用 macOS 配套工具：

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

注意：

• 需要 macOS 屏幕录制权限（TCC）。

---

本页面源自 openclaw/openclaw，由 BeaversLab 翻译，遵循 MIT 协议 发布。