← Back to Skills Marketplace
455
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install raspberry-pi-camera-service
Description
提供使用摄像头拍照, 录制视频或直接生成gif的能力。何时触发: 需要拍照时, 需要观察一段时间当前视野时, 需要关注某件事情的进展时.
Usage Guidance
This bundle appears to implement the claimed Pi camera service, but take care before installing:
- Review the install script (scripts/deploy/install.sh) line-by-line. It must be run as root and will create a systemd unit and write to /opt and /etc. Do not run it blindly.
- Expect real prerequisites: python3, ffmpeg (for USB & conversions), and picamera2 (for CSI). The metadata does not list these — ensure they are present and trusted.
- The default .env/template uses HOST=0.0.0.0 (network-exposed). If you don't want the service reachable from other hosts, change HOST to 127.0.0.1 or apply firewall rules.
- The installer installs a client package into the system Python using --break-system-packages; prefer avoiding system-wide installs (inspect and modify install.sh to only install into the service venv or manually install the client in a controlled way).
- If you proceed, test in an isolated Raspberry Pi or VM first. Confirm the service binds to the intended host/port, check file permissions on the output directory, and audit the code locally (service.py and deploy scripts) before granting root privileges.
Capability Analysis
Type: OpenClaw Skill
Name: raspberry-pi-camera-service
Version: 1.0.0
The bundle provides a legitimate Raspberry Pi camera management service with a FastAPI backend and a Python SDK. It supports CSI and USB cameras, video recording (H264, MP4), and GIF generation using FFmpeg. The installation scripts (`install.sh`, `uninstall.sh`) correctly set up a systemd service and a local Python package for the client. Security best practices are followed, such as using list-based arguments for subprocess calls in `camera_manager.py` and `converter.py`, and implementing path traversal checks in the file retrieval endpoint in `service.py`.
Capability Assessment
Purpose & Capability
The code, client, and deploy scripts implement exactly a Pi camera HTTP service (Picamera2 + FFmpeg + FastAPI) as described. However the declared skill metadata lists no required binaries or env vars even though the runtime needs Python3, systemd (for the install script), ffmpeg (for USB / conversion), and (optionally) picamera2 for CSI cameras. This mismatch (metadata says nothing required but files clearly expect these components) is an incoherence to be aware of.
Instruction Scope
The runtime instructions and code restrict activity to camera control, file creation in an output dir, and local HTTP API interactions — no hidden external endpoints or credential exfiltration are present. However the included deployment/template .env uses HOST=0.0.0.0 by default, so the service will be network-accessible unless you change it or firewall it; the service also supports persistent background conversion and a heartbeat mechanism that can keep recordings active for extended periods. These networking and persistence behaviors increase exposure and should be configured intentionally.
Install Mechanism
There is no formal install spec in the registry, but the bundle includes deploy/install.sh which is a root-run installer that: creates /opt/camera-service, writes systemd unit files, enables and starts a service, copies files, creates a virtualenv, and (notably) installs a camera-client package into the system Python using 'pip install ... --break-system-packages'. It does not download code from unknown third-party hosts, but it performs privileged, system-wide modifications; running it without review is risky.
Credentials
The skill does not declare any required credentials and the code does not attempt to read secrets or unrelated system config. It does read a .env for HOST/PORT/OUTPUT_DIR and uses PATH/PYTHONPATH in the systemd unit. One minor inconsistency: registry metadata lists no required env vars or binaries, but the service expects OUTPUT_DIR, ffmpeg, and optionally picamera2/picamera hardware — these are normal for the stated purpose but should be declared.
Persistence & Privilege
The installer sets up a systemd service (Restart=always, enabled at boot) and installs a client package into system Python (pip --break-system-packages). Creating an auto-starting system service and modifying system packages are reasonable for a long-running hardware service, but they are privileged actions; the combination of system-wide package installation and enabling a daemon increases blast radius if the code is later modified or contains vulnerabilities. 'always' is false (good), but the installer still grants persistent presence.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install raspberry-pi-camera-service - After installation, invoke the skill by name or use
/raspberry-pi-camera-service - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
raspberry-pi-camera-service 1.0.0
- Initial release providing remote camera control for Raspberry Pi (CSI & USB cameras) via HTTP API.
- Supports photo capture, multi-format video recording (H264, MP4, GIF), and GIF generation.
- Includes session management with heartbeat monitoring and automatic timeout protection.
- Offers backend format conversion, and video file management (list, download, delete).
- Provides easy-to-use Python client with example usage for capturing photos and recording videos.
Metadata
Frequently Asked Questions
What is raspberry-pi-camera-service?
提供使用摄像头拍照, 录制视频或直接生成gif的能力。何时触发: 需要拍照时, 需要观察一段时间当前视野时, 需要关注某件事情的进展时. It is an AI Agent Skill for Claude Code / OpenClaw, with 455 downloads so far.
How do I install raspberry-pi-camera-service?
Run "/install raspberry-pi-camera-service" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is raspberry-pi-camera-service free?
Yes, raspberry-pi-camera-service is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does raspberry-pi-camera-service support?
raspberry-pi-camera-service is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created raspberry-pi-camera-service?
It is built and maintained by CLD1994 (@cld1994); the current version is v1.0.0.
More Skills