跳转到主要内容

​
相机捕获 (智能体)

OpenClaw 支持智能体工作流的 相机捕获：
  • iOS 节点 (通过网关配对): 通过 node.invoke 捕获 照片 (jpg) 或 短视频片段 (mp4, 可选音频)。
  • Android 节点 (通过网关配对): 通过 node.invoke 捕获 照片 (jpg) 或 短视频片段 (mp4, 可选音频)。
  • macOS 应用 (通过网关作为节点): 通过 node.invoke 捕获 照片 (jpg) 或 短视频片段 (mp4, 可选音频)。
所有相机访问都受到 用户控制的设置 限制。

​
iOS 节点

​
用户设置 (默认开启)

  • iOS 设置标签页 → 相机 (Camera) → 允许相机 (Allow Camera) (camera.enabled)
    • 默认: 开 (缺少键视为已启用)。
    • 关闭时: camera.* 命令返回 CAMERA_DISABLED。

​
命令 (通过网关 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>               # 默认: 前置 + 后置 (2 行 MEDIA)
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 默认为 两个 摄像头，以给智能体提供两种视图。
  • 输出文件是临时的（在 OS 临时目录中），除非你构建自己的包装器。

​
Android 节点

​
用户设置 (默认开启)

  • Android 设置页 → 相机 (Camera) → 允许相机 (Allow Camera) (camera.enabled)
    • 默认: 开 (缺少键视为已启用)。
    • 关闭时: camera.* 命令返回 CAMERA_DISABLED。

​
权限

  • Android 需要运行时权限：
    • camera.snap 和 camera.clip 都需要 CAMERA。
    • 当 includeAudio=true 时，camera.clip 需要 RECORD_AUDIO。
如果缺少权限，应用会在可能时提示；如果被拒绝，camera.* 请求会失败并返回 *_PERMISSION_REQUIRED 错误。

​
前台要求

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

​
载荷保护

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

​
macOS 应用

​
用户设置 (默认关闭)

macOS 配套应用暴露了一个复选框：
  • 设置 (Settings) → 常规 (General) → 允许相机 (Allow Camera) (openclaw.cameraEnabled)
    • 默认: 关
    • 关闭时: 相机请求返回 “用户禁用了相机 (Camera disabled by user)”。

​
CLI 助手 (节点调用)

使用主 openclaw CLI 在 macOS 节点上调用相机命令。 示例: 
openclaw nodes camera list --node <id>            # 列出相机 id
openclaw nodes camera snap --node <id>            # 打印 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          # 打印 MEDIA:<path>
openclaw nodes camera clip --node <id> --duration-ms 3000      # 打印 MEDIA:<path> (旧版标志)
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 以下。

​
安全 + 实际限制

  • 相机和麦克风访问会触发通常的 OS 权限提示（并需要 Info.plist 中的用法字符串）。
  • 视频片段有上限（目前 <= 60s），以避免过大的节点载荷（base64 开销 + 消息限制）。

​
macOS 屏幕录像 (OS 级)

对于 屏幕 视频（非相机），请使用 macOS 配套应用： 
openclaw nodes screen record --node <id> --duration 10s --fps 15   # 打印 MEDIA:<path>
注意:
  • 需要 macOS 屏幕录制 权限 (TCC)。