Raspberry Pi Agent Skill 简介¶

Skill 简介¶

Raspberry Pi Agent 是一个基于 OpenClaw 平台开发的轻量级 AI 助手，专为树莓派（Raspberry Pi）等边缘计算设备优化设计。它能够在资源受限的硬件环境下提供强大的 AI 辅助功能，例如树莓派 3B+、4、5 以及 Zero 2W 等型号。通过将 AI 功能本地化，Raspberry Pi Agent 无需依赖云端数据中心即可执行多种任务，从而最大限度地减少网络延迟、节省带宽成本，并增强数据隐私性。该 Skill 的设计理念是“功能强大且资源高效”，它不仅能够管理树莓派系统的各项运行指标，还能执行多种自动化任务，并为家庭服务器、物联网（IoT）项目提供支持。对于希望在不依赖昂贵硬件或云服务的情况下实现 AI 功能的开发者来说，Raspberry Pi Agent 是一个理想的选择。

Raspberry Pi Agent 的核心优势在于其对资源的高效利用。它通过优化 token 使用、内存占用和 API 调用成本，确保在树莓派等低功耗设备上也能流畅运行。此外，它还集成了多种系统监控和管理工具，使其不仅是一个 AI 助手，更是一个全面的系统管理解决方案。

主要功能¶

1. 系统监控与管理¶

Raspberry Pi Agent 提供全面的系统监控功能，能够实时跟踪 CPU 使用率、温度、内存占用、存储空间和网络状态。例如，它可以：
- 使用 vcgencmd 工具获取树莓派特定的硬件指标。
- 监控 CPU 温度，并在温度过高时自动采取降温措施（如开启风扇）或发送警报。
- 跟踪磁盘使用情况，并在存储空间不足时发出警告。

# 示例：获取系统状态
Agent:
Pi 4B | Up 12d | 08:32 UTC
CPU: 14% | 48°C | RAM: 1.2/4GB
Disk: 38/64GB (59%) | Net: 192.168.1.50

2. Docker 容器管理¶

该 Skill 支持 Docker 容器的管理，能够监控容器的运行状态、CPU 和内存使用情况，并支持容器的启动、停止和重启操作。例如：
- 监控多个容器的资源占用情况。
- 在资源不足时自动调整容器资源分配。

# 示例：查看 Docker 容器状态
Agent:
| Container | CPU | RAM | Status |
|-----------|-----|-----|--------|
| pihole | 2% | 120MB | ✅ 12d |
| nextcloud | 4% | 380MB | ✅ 12d |
| homeassistant | 8% | 450MB | ✅ 12d |

3. GPIO 控制与传感器集成¶

Raspberry Pi Agent 支持通过 GPIO 引脚控制各种外设，如传感器、LED、继电器和执行器。例如：
- 读取 DHT22 温度和湿度传感器的数据。
- 控制风扇、灯光等设备的开关状态。

# 示例：读取 GPIO4 上的温度传感器数据
Agent:
DHT22 @ GPIO4
Temp: 22.3°C | Humidity: 45%
Last read: just now
24h range: 19.1°C — 24.8°C

4. 网络与设备管理¶

该 Skill 能够监控本地网络中的连接设备，提供网络使用情况的详细统计信息。例如：
- 列出所有连接的设备及其 IP 地址。
- 监控网络带宽使用情况。

5. 家庭服务器辅助功能¶

Raspberry Pi Agent 可以作为家庭服务器的辅助工具，支持多种服务的管理和监控，如 Pi-hole 广告拦截、Nextcloud 个人云存储和 Home Assistant 智能家居平台。例如：
- 提供 Pi-hole 的广告拦截统计数据和详细日志。
- 监控 Nextcloud 和 Home Assistant 的运行状态。

6. 自动化任务调度¶

该 Skill 支持定时任务的调度和执行，例如：
- 定期备份重要文件。
- 定时执行系统健康检查。
- 在特定时间执行自定义脚本。

使用场景¶

1. 家庭自动化系统¶

开发者可以利用 Raspberry Pi Agent 构建一个完整的家庭自动化系统，通过 GPIO 控制各种家用设备，并使用 AI 助手实现语音控制或自动化操作。

2. 物联网（IoT）项目¶

在 IoT 项目中，Raspberry Pi Agent 可以作为中央控制器，实时监控传感器数据，并根据预设规则执行相应的控制操作。

3. 个人服务器管理¶

对于个人开发者，Raspberry Pi Agent 可以帮助管理小型服务器环境，监控服务运行状态，优化资源使用，并提供远程访问功能。

4. 智能家居集成¶

结合 Home Assistant 等智能家居平台，Raspberry Pi Agent 可以实现更复杂的自动化场景，例如根据天气情况自动调节室内温度。

5. 低成本 AI 项目¶

在资源受限的硬件环境下，开发者可以使用 Raspberry Pi Agent 开展各种 AI 项目，如图像识别、自然语言处理等，而无需昂贵的硬件支持。

如何使用¶

1. 安装与配置¶

首先，确保你的树莓派已经安装了 Docker。然后，使用以下命令拉取 Raspberry Pi Agent 的 Docker 镜像：

docker pull openclaw/rpi-agent:latest

接下来，创建一个配置文件 config.yaml，内容如下：

hardware:
  model: "Raspberry Pi 4 Model B"
  ram: "4GB"
  storage: "64GB microSD"
  network: "WiFi + Ethernet"
  gpio: true

token_budget:
  daily_limit: 10000
  batch_operations: true
  cache_ttl: 300
  model: "haiku"

services:
  - name: "pihole"
    check: "curl -s http://localhost/admin/api.php?summary"
  - name: "nextcloud"
    check: "curl -s http://localhost:8080/status.php"
  - name: "homeassistant"
    check: "curl -s http://localhost:8123/api/"

schedule:
  health_check: "*/15 * * * *"
  daily_report: "0 8 * * *"
  temp_alert: "*/5 * * * *"
  backup: "0 2 * * 0"

最后，使用以下命令启动 Agent：

docker run -d --privileged --restart=always -v /path/to/config.yaml:/config.yaml openclaw/rpi-agent:latest

2. 前置条件¶

树莓派 3B+、4、5 或 Zero 2W。
已安装 Docker。
必要的 GPIO 外设（如传感器、继电器等）。

示例¶

示例 1：获取系统状态¶

# 发送命令
echo "Status" | docker exec -i <container_id> bash -c "rpi-agent"

# 接收响应
Pi 4B | Up 12d | 08:32 UTC
CPU: 14% | 48°C | RAM: 1.2/4GB
Disk: 38/64GB (59%) | Net: 192.168.1.50
─────────────────────────────
pihole    ✅  12.4K blocked today (31%)
nextcloud ✅  2 users active
homeassist ✅  14 devices online
docker    ✅  5/5 containers running

示例 2：读取 GPIO 传感器数据并控制设备¶

# 读取 GPIO4 上的温度传感器数据
echo "GPIO: Read temperature sensor on pin 4" | docker exec -i <container_id> bash -c "rpi-agent"

# 响应
DHT22 @ GPIO4
Temp: 22.3°C | Humidity: 45%
Last read: just now
24h range: 19.1°C — 24.8°C

# 温度过高，开启风扇
echo "Too hot, turn on fan" | docker exec -i <container_id> bash -c "rpi-agent"

# 响应
GPIO17 → HIGH (fan relay ON)
Auto-off: when temp < 21°C
Current: 22.3°C → monitoring

总结¶

Raspberry Pi Agent 是一个功能强大且资源高效的 AI 助手，专为树莓派等边缘设备设计。它不仅能够简化系统管理任务，还能为物联网项目、家庭自动化和智能家居系统提供支持。对于希望在低功耗硬件上实现复杂功能的开发者来说，Raspberry Pi Agent 是一个不可或缺的工具。通过其直观的配置和强大的功能，开发者可以轻松地将 AI 能力融入到各种应用场景中，从而提升项目的智能化和自动化水平。

raspberry-pi