照片拍摄

当用户希望捕获实时摄像头画面并回传时，使用此技能。

默认行为

1. 优先使用 scripts/capture_webcam.py 进行直接的网络摄像头捕获。
2. 将输出保存至工作区（workspace）内的 tmp/ 目录下。
3. 以 MEDIA:./relative/path.png 或 MEDIA:./relative/path.jpg 格式回复，使图像被回传。
4. 仅在无法进行直接摄像头捕获时，才启用旧版 macOS 应用窗口截图路径。

选择该路径的原因

默认采用直接摄像头捕获，是因为该方式兼容 macOS、Windows 和 Linux，且无需预先配置屏幕录制、辅助功能或自动化权限。

操作系统仍可能对终端或 Python 进程弹出一次性的标准摄像头权限提示。这是预期行为，且其侵入性远低于旧版基于截图的方案。

主命令路径

注意：请将 替换为该技能实际安装路径（例如：~/.agents/skills/photo-capture 或 ~/.openclaw/workspace/skills/photo-capture）。

列出可用摄像头：

python3 /scripts/capture_webcam.py --list-devices

在任意受支持的操作系统上，从默认摄像头捕获图像：

python3 /scripts/capture_webcam.py --output ./tmp/webcam.jpg

从指定设备捕获：

python3 /scripts/capture_webcam.py 
  --device "0" 
  --output ./tmp/webcam.jpg

以更高分辨率捕获：

python3 /scripts/capture_webcam.py 
  --width 1920 
  --height 1080 
  --output ./tmp/webcam-1080p.jpg

平台说明

• macOS：使用 ffmpeg 配合 avfoundation。默认自动选择摄像头索引 0。
• Windows：使用 ffmpeg 配合 dshow。默认自动选择首个检测到的视频设备。
• Linux：使用 ffmpeg 配合 v4l2。默认自动选择类似 /dev/video0 的设备。

依赖要求

• ffmpeg 必须已安装并位于 PATH 环境变量中。
• 系统需连接可用的网络摄像头设备。
• 若存在多个摄像头，请先运行 --list-devices 获取设备列表，再通过 --device 显式指定目标设备。

macOS 回退方案

仅在 macOS 环境中直接摄像头捕获失败时，才保留旧版应用窗口截图作为回退路径。

Photo Booth 回退示例：

bash /scripts/capture_via_app.sh 
  --app "Photo Booth" 
  --layout large 
  --capture window 
  --output ./tmp/photobooth-window-large.png

仅当直接基于 ffmpeg 的捕获路径失败，或用户明确要求图像中包含 Photo Booth 或 FaceTime 的 UI 界面时，才使用该回退方案。

验证方法

更新或调试本技能时，请执行以下步骤：

1. 在目标操作系统上运行 --list-devices 命令。
2. 捕获一帧图像并保存至 tmp/ 目录。
3. 确认输出文件存在且非空。
4. 在 macOS 上，仅当直接捕获被系统阻止时，才启用截图回退路径。