摄像头快照抓取

技能简介

camsnap 是一款命令行工具，用于从 RTSP/ONVIF 协议的摄像头中抓取静态图片、短视频片段或监测运动事件。

业务背景

帮助安防监控、零售巡检等业务快速获取摄像头画面，支持设备自动发现、定时抓拍、异常录制及运动告警。无需复杂视频平台部署，即可实现轻量化的视觉数据采集与现场状况核验，降低硬件接入门槛。

落地案例：连锁门店督导需每日抽查各分店实时画面，传统方式依赖人工登录NVR查看。使用该工具配置摄像头IP后，可定时抓取关键区域快照存档，或设置运动检测触发录像，督导次日批量审阅图片即可掌握营业情况，减少实时盯屏的人力消耗。

能做什么

• 自动发现局域网内的 ONVIF 摄像头并获取设备信息
• 抓取单帧快照保存为图片文件
• 录制指定时长的视频片段
• 持续监测画面变化并触发自定义动作
• 诊断连接问题与测试配置

使用说明

安装

brew install steipete/tap/camsnap

需确保系统已安装 ffmpeg 且位于 PATH 中。

配置步骤

1. 创建配置文件目录：mkdir -p ~/.config/camsnap
2. 添加摄像头：camsnap add --name kitchen --host 192.168.0.10 --user user --pass pass

常用操作

• 发现设备：camsnap discover --info
• 抓取快照：camsnap snap kitchen --out shot.jpg
• 录制片段：camsnap clip kitchen --dur 5s --out clip.mp4
• 运动监测：camsnap watch kitchen --threshold 0.2 --action '...'
• 连接诊断：camsnap doctor --probe

建议先用短时测试确认连接正常，再进行长时间录制。

输入与输出

见下方输入与输出表格。

风险提示

• 需正确配置摄像头用户名密码，错误凭证会导致连接失败
• 长时间录制可能产生大体积文件，注意磁盘空间
• 运动监测的阈值设置过低可能产生过多误触发
• 依赖 ffmpeg，若未安装则功能无法使用

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/steipete/camsnap/SKILL.md
来源类型：开源社区