OpenClaw

raspberry-pi-camera-service

提供使用摄像头拍照, 录制视频或直接生成gif的能力。何时触发: 需要拍照时, 需要观察一段时间当前视野时, 需要关注某件事情的进展时.

cld19940 来源安装数☆ 0 仓库 Stars

查看来源 ↗安装与使用 SKILL.md ↗

安装与使用

请根据来源仓库和你的 AI 工具说明安装此技能。先阅读技能文件和依赖要求，再添加到工作流。

SkillHub CLI

skillhub install cld1994/raspberry-pi-camera-service

打开来源仓库，查看说明和兼容环境后，按来源提供的命令或步骤安装。

将来源链接提供给你的 Agent，让它先读取说明、核对依赖，并向你说明将执行的安装步骤。

查看来源 ↗使用指南

技能说明

Raspberry Pi Camera Service Skill

概述

树莓派摄像头服务提供基于HTTP的树莓派摄像头硬件（CSI或USB）控制，具备以下高级功能：

多格式视频录制（H264、MP4、GIF）
带心跳监控的会话管理
自动超时保护
后台转换任务
视频文件管理（列表、下载、删除）

架构

该服务由三个主要组件组成：

摄像头管理器（Camera Manager） - 处理底层摄像头硬件（通过Picamera2使用CSI接口，通过FFmpeg使用USB接口）
转换器（Converter） - 使用FFmpeg将原始H264转换为其他格式（MP4、GIF）
服务（Service） - 使用FastAPI构建的HTTP API服务器，具备会话管理功能

客户端

客户端SDK会在服务端部署时自动安装到本地

服务端部署

可通过执行 python -c "from camera_client import CameraClient"来判断服务是否被成功部署
如果发现服务还未部署，则立刻阅读 references/deploy_service.md 进行部署

快速开始

拍照

from camera_client import CameraClient

with CameraClient() as client:
    result = client.capture(task_name="snapshot")
    print(f"✅ {result['image_path']}")

录制 MP4 视频

from camera_client import CameraClient

client = CameraClient()

try:
    # 录制 5 秒的 1080p 视频
    result = client.record_video(
        duration=5,
        task_name="demo_video",
        output_format="mp4"
    )

    print(f"录制完成: {result['video_path']}")
    print(f"文件大小: {result['file_size_bytes'] / 1024 / 1024:.2f} MB")

finally:
    client.session.close()

录制 GIF 动图

from camera_client import CameraClient

client = CameraClient()

try:
    # 录制 3 秒的高质量 GIF
    result = client.record_gif(
        duration=3,
        width=480,        # 480 像素宽
        fps=15,           # 15 帧/秒
        quality=7,        # 高质量
        loop=True         # 循环播放
    )

    print(f"GIF 录制完成: {result['video_path']}")

finally:
    client.session.close()

手动控制录制流程

from camera_client import CameraClient
import time

client = CameraClient()

try:
    # 1. 开始录制
    result = client.start_recording(...

来源信息

Source: github
Repository: openclaw/skills
Path: skills/cld1994/raspberry-pi-camera-service
Version: —
Commit: 71928eba5917de14063183122a4eb4ccaa21615b
分类来源: rules
状态: active
可见性: public

这些信息来自收录时的来源分析，可能滞后；使用前请核对最新来源文件。

来源内容

SKILL.md

# Raspberry Pi Camera Service Skill

## 概述

树莓派摄像头服务提供基于HTTP的树莓派摄像头硬件（CSI或USB）控制，具备以下高级功能：

- 多格式视频录制（H264、MP4、GIF）
- 带心跳监控的会话管理
- 自动超时保护
- 后台转换任务
- 视频文件管理（列表、下载、删除）

## 架构

该服务由三个主要组件组成：

1. **摄像头管理器（Camera Manager）** - 处理底层摄像头硬件（通过Picamera2使用CSI接口，通过FFmpeg使用USB接口）
2. **转换器（Converter）** - 使用FFmpeg将原始H264转换为其他格式（MP4、GIF）
3. **服务（Service）** - 使用FastAPI构建的HTTP API服务器，具备会话管理功能

## 客户端
客户端SDK会在服务端部署时自动安装到本地

## 服务端部署
可通过执行 `python -c "from camera_client import CameraClient"`来判断服务是否被成功部署  
如果发现服务还未部署，则立刻阅读 `references/deploy_service.md` 进行部署

### 快速开始

#### 拍照
```python
from camera_client import CameraClient

with CameraClient() as client:
    result = client.capture(task_name="snapshot")
    print(f"✅ {result['image_path']}")
```

#### 录制 MP4 视频

```python
from camera_client import CameraClient

client = CameraClient()

try:
    # 录制 5 秒的 1080p 视频
    result = client.record_video(
        duration=5,
        task_name="demo_video",
        output_format="mp4"
    )

    print(f"录制完成: {result['video_path']}")
    print(f"文件大小: {result['file_size_bytes'] / 1024 / 1024:.2f} MB")

finally:
    client.session.close()
```

#### 录制 GIF 动图

```python
from camera_client import CameraClient

client = CameraClient()

try:
    # 录制 3 秒的高质量 GIF
    result = client.record_gif(
        duration=3,
        width=480,        # 480 像素宽
        fps=15,           # 15 帧/秒
        quality=7,        # 高质量
        loop=True         # 循环播放
    )

    print(f"GIF 录制完成: {result['video_path']}")

finally:
    client.session.close()
```

#### 手动控制录制流程

```python
from camera_client import CameraClient
import time

client = CameraClient()

try:
    # 1. 开始录制
    result = client.start_recording(...

搜索