camsnap

camsnap is a specialized tool designed to integrate network video surveillance into your OpenClaw assistant ecosystem. By leveraging the industry-standard RTSP and ONVIF protocols, it allows users to perform remote visual data collection from IP cameras directly through command-line operations. This skill acts as a bridge between raw video feeds and actionable intelligence, enabling you to automate security workflows, create periodic visual logs, or trigger alerts based on environmental motion detection. It is intended for power users and developers managing home or office security who require an extensible, local-first method for camera management and archival.

• Capture high-quality still images from any configured RTSP/ONVIF camera stream.

• Record short video clips with user-defined durations for specific surveillance intervals.

• Advanced motion detection monitoring with configurable sensitivity thresholds and custom action execution.

• Seamless discovery features to identify and probe camera streams on your local network.

• Integrated diagnostic tools to probe stream health and connectivity status.

• Lightweight command-line interface perfect for scripting and cron-based automation.

• Ensure ffmpeg is installed and accessible on your system PATH, as it is required for video processing and encoding.

• The tool uses a YAML configuration file located at ~/.config/camsnap/config.yaml for secure credential and stream management.

• Always perform a brief test capture before scheduling long-form video clips to ensure stream stability and bandwidth availability.

• Motion detection performance depends on your threshold settings; calibrate the --threshold parameter based on the physical environment to minimize false positives.

• This utility works best in environments with reliable local network connectivity to the IP camera endpoints.

• Use the doctor command regularly to troubleshoot stream issues, authentication errors, or protocol mismatches.