Frigate监控接入

技能简介

该技能用于连接 Frigate NVR 服务器，通过会话认证方式访问家庭监控摄像头。

业务背景

家庭安防管理人员可通过统一接口实时掌握多点位监控状态，快速调取关键画面与事件记录，无需登录多个系统。该技能将分散的摄像头资源整合为可程序化调用的服务，提升异常响应速度与日常巡检效率。

落地案例：物业值班人员夜间收到车库异动告警后，立即调用技能获取对应摄像头的最新快照确认现场情况，同时提取RTSP流地址推送至大屏持续监视。若需回溯，则查询该摄像头过去2小时的运动检测事件，定位具体时间点并下载片段存档，全程无需打开Frigate后台界面。

能做什么

• 列出所有已配置的摄像头（如门铃、车道、前门等）
• 抓取指定摄像头的最新 JPEG 快照
• 查询特定摄像头的运动检测事件记录
• 获取 RTSP/WebRTC 格式的直播流地址
• 通过命令行脚本快速执行上述操作

使用说明

环境准备

需设置以下环境变量：

export FRIGATE_URL="https://your-server:8971/"
export FRIGATE_USER="your_username"
export FRIGATE_PASS="your_password"

安装依赖

Python 环境需安装 requests 库：

pip install requests

基础调用流程

1. 创建会话并登录获取 token
2. 使用 session 对象发起后续 API 请求
3. 处理返回的图片或 JSON 数据

CLI 工具使用

项目包含 scripts/frigate.py 辅助脚本，支持命令：list（列摄像头）、snapshot（抓图）、events（查事件）、stream（取流地址）。

输入与输出

见下方输入与输出表格。

风险提示

• 自签名证书场景下需使用 verify=False，存在中间人攻击风险
• 会话令牌默认 24 小时过期，长时运行任务需处理重登逻辑
• 密码以明文形式存储于环境变量，注意系统权限隔离
• 外网暴露 Frigate 服务可能带来未授权访问隐患

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/porygonthebot/frigate/SKILL.md
来源类型：GitHub 仓库