Ring Doorbell & Camera Control
Monitor and control Ring devices from your AI assistant.
Features
- 📷 Capture snapshots from any Ring camera or doorbell
- 📋 List all devices with battery status
- 📹 View recent doorbell events and motion history
- 🔋 Monitor battery levels
Setup
1. Install Dependencies
pip3 install ring-doorbell
Note: ffmpeg is required for video frame extraction on some doorbell models.
2. Authenticate
First time setup requires authentication with 2FA:
python3 <skill_dir>/ring_tool.py auth
Token will be saved to ~/.openclaw/ring_token.json and auto-refresh.
Usage
List All Devices
python3 <skill_dir>/ring_tool.py list
Returns JSON with device name, type, battery level, and online status.
Capture Snapshot
python3 <skill_dir>/ring_tool.py snapshot "前门门铃"
Device name supports partial/fuzzy match. Returns path to saved image.
View Recent Events
python3 <skill_dir>/ring_tool.py events --limit 10
python3 <skill_dir>/ring_tool.py events --device "车库门铃"
When to Use This Skill
- "看一下前门的摄像头"
- "拍一张后院的照片"
- "门铃最近有没有人按?"
- "所有设备电量多少?"
- "车库门摄像头状态"
Notes
- Token auto-refreshes; re-run auth if it expires
- Snapshots require device to be online
- Some doorbell models may not support live snapshot (uses video frame instead)
- Images saved to
~/.openclaw/media/ring/
Credits
Built with ring-doorbell Python library.