跳转到主要内容

在 Raspberry Pi 上运行 OpenClaw

目标

在 Raspberry Pi 上运行持久、常驻的 OpenClaw Gateway 网关,一次性成本约 $35-80(无月费)。 适用于:
  • 24/7 个人 AI 助手
  • 家庭自动化中心
  • 低功耗、随时可用的 Telegram/WhatsApp 机器人

硬件要求

最低配置: 1GB 内存,1 核,500MB 磁盘
推荐: 2GB+ 内存,64 位系统,16GB+ SD 卡(或 USB SSD)

你需要准备

  • Raspberry Pi 4 或 5(推荐 2GB+)
  • MicroSD 卡(16GB+)或 USB SSD(性能更好)
  • 电源(推荐官方 Pi 电源)
  • 网络连接(以太网或 WiFi)
  • 约 30 分钟

1) 刷写系统

使用 Raspberry Pi OS Lite (64-bit) — 无头服务器不需要桌面。
  1. 下载 Raspberry Pi Imager
  2. 选择系统:Raspberry Pi OS Lite (64-bit)
  3. 点击齿轮图标(⚙️)预配置:
    • 设置主机名:gateway-host
    • 启用 SSH
    • 设置用户名/密码
    • 配置 WiFi(如果不使用以太网)
  4. 刷写到你的 SD 卡 / USB 驱动器
  5. 插入并启动 Pi

2) 通过 SSH 连接

3) 系统设置

4) 安装 Node.js 22(ARM64)

5) 添加交换空间(2GB 或更少内存时很重要)

交换空间可防止内存不足崩溃:

6) 安装 OpenClaw

选项 A:标准安装(推荐)

选项 B:可修改安装(用于调试)

可修改安装让你可以直接访问日志和代码 — 对调试 ARM 特定问题很有用。

7) 运行新手引导

按照向导操作:
  1. Gateway 网关模式: Local
  2. 认证: 推荐 API 密钥(OAuth 在无头 Pi 上可能不稳定)
  3. 渠道: Telegram 最容易上手
  4. 守护进程: 是(systemd)

8) 验证安装

9) 访问仪表板

由于 Pi 是无头的,使用 SSH 隧道:
或使用 Tailscale 实现常驻访问:

性能优化

使用 USB SSD(巨大改进)

SD 卡速度慢且会磨损。USB SSD 可大幅提升性能:
设置请参见 Pi USB 启动指南

减少内存使用

监控资源


ARM 特定说明

二进制兼容性

大多数 OpenClaw 功能在 ARM64 上可用,但某些外部二进制文件可能需要 ARM 构建: 如果某个 skill 失败,检查其二进制文件是否有 ARM 构建。许多 Go/Rust 工具有;有些没有。

32 位 vs 64 位

始终使用 64 位系统。 Node.js 和许多现代工具需要它。使用以下命令检查:

推荐的模型设置

由于 Pi 只是 Gateway 网关(模型在云端运行),使用基于 API 的模型:
不要尝试在 Pi 上运行本地 LLM — 即使是小模型也太慢了。让 Claude/GPT 来做繁重的工作。

开机自启

新手引导向导会设置这个,但要验证:

故障排除

内存不足(OOM)

性能慢

  • 使用 USB SSD 代替 SD 卡
  • 禁用未使用的服务:sudo systemctl disable cups bluetooth avahi-daemon
  • 检查 CPU 降频:vcgencmd get_throttled(应返回 0x0

服务无法启动

ARM 二进制问题

如果某个 skill 失败并显示”exec format error”:
  1. 检查该二进制文件是否有 ARM64 构建
  2. 尝试从源代码构建
  3. 或使用支持 ARM 的 Docker 容器

WiFi 断开

对于使用 WiFi 的无头 Pi:

成本对比

回本期: 与云 VPS 相比,Pi 约 6-12 个月内回本。

另请参阅