摄像头捕获

Camera Node（摄像头节点）为 Agent 提供视觉输入能力。通过摄像头节点，Agent 可以看到现实世界并做出响应。

启动摄像头节点

openclaw node --type camera

设备选择

如果系统有多个摄像头，可以用 --device 指定：

openclaw node --type camera --device "USB Camera"

捕获模式

OpenClaw 支持三种摄像头捕获模式：

Snapshot（快照模式）

按需拍摄单张照片，由 Agent 主动触发。

camera:
  mode: snapshot
  format: jpeg
  quality: 85           # JPEG 质量 (1-100)
  resolution: 1280x720  # 分辨率

适用场景：

• Agent 需要查看当前画面时触发拍照
• 视觉问答（"帮我看看这是什么"）
• 文档拍照识别

Continuous（连续模式）

按固定间隔持续采集帧。

camera:
  mode: continuous
  interval: 5           # 每 5 秒采集一帧
  format: jpeg
  quality: 70
  resolution: 640x480   # 降低分辨率节省带宽

适用场景：

• 环境持续监控
• 延时摄影
• 安防场景

Motion-triggered（运动触发模式）

仅在检测到画面变化时采集。

camera:
  mode: motion
  sensitivity: medium    # low / medium / high
  cooldown: 10           # 触发后冷却时间（秒）
  format: jpeg
  quality: 85
  resolution: 1280x720

适用场景：

• 节省带宽和存储
• 门口/走廊监控
• 宠物/婴儿看护

多模态模型要求

摄像头采集的图片需要通过多模态模型（如 GPT-4o、Qwen-VL、GLM-4V）进行分析。请确保你的模型配置支持图片输入。

分辨率与格式

支持的分辨率

预设	分辨率	适用场景
low	320×240	极低带宽
medium	640×480	日常监控
hd	1280×720	文字识别、细节查看
fhd	1920×1080	高清分析
自定义	WxH	任意分辨率

支持的格式

格式	特点
JPEG	体积小，速度快（推荐）
PNG	无损压缩，适合文字截图
WebP	体积最小，需要模型支持

隐私控制

重要：隐私保护

摄像头涉及隐私，务必做好以下配置。

区域遮罩

遮蔽画面中的特定区域：

camera:
  privacy:
    mask_regions:
      - x: 0
        y: 0
        width: 200
        height: 150
        label: "邻居窗户"

访问控制

camera:
  privacy:
    require_approval: true    # 每次拍照需要用户确认
    allowed_agents:           # 只允许指定 Agent 访问
      - agent-main
    schedule:                 # 时间段限制
      enabled: true
      active_hours: "08:00-22:00"

数据保留策略

camera:
  privacy:
    retention:
      enabled: true
      max_age: 24h            # 图片最多保留 24 小时
      auto_delete: true       # 过期自动删除

完整配置示例

快照模式

camera:
  mode: snapshot
  format: jpeg
  quality: 85
  resolution: 1280x720
  privacy:
    require_approval: false
    retention:
      max_age: 1h
      auto_delete: true

监控模式

camera:
  mode: motion
  sensitivity: medium
  cooldown: 30
  format: jpeg
  quality: 80
  resolution: 1920x1080
  privacy:
    schedule:
      enabled: true
      active_hours: "00:00-23:59"
    retention:
      max_age: 7d
      auto_delete: true

常用命令

# 列出可用摄像头
openclaw node --type camera --list-devices

# 测试摄像头（拍一张预览）
openclaw node --type camera --test

# 指定分辨率启动
openclaw node --type camera --resolution 1920x1080

使用场景示例

场景	配置建议
"这是什么东西？"	snapshot 模式 + 高分辨率
门口来客提醒	motion 模式 + 中灵敏度
仓库盘点	continuous 模式 + 定时采集
文档扫描识别	snapshot 模式 + PNG 格式

故障排查

问题	解决方案
Permission denied	检查系统摄像头权限设置
画面全黑	确认摄像头未被其他程序占用
格式不支持	改用 JPEG 格式
帧率过低	降低分辨率或检查 USB 带宽

更多问题请参考 故障排查。