本页内容
本页内容
托管
Raspberry Pi
在 Raspberry Pi 上运行持久、始终在线的 OpenClaw 网关。由于 Pi 只是网关(模型通过 API 在云中运行),因此即使是普通的 Pi 也能很好地处理工作负载 - 典型硬件成本为 一次性 35-80 美元,无月租费。
硬件兼容性
| Pi模型 | RAM | 作品? | 笔记 |
|---|---|---|---|
| Pi 5 | 4/8 GB | 最佳 | 速度最快,推荐。 |
| Pi 4 | 4 GB | 良好 | 适合大多数用户的最佳选择。 |
| Pi 4 | 2 GB | OK | 添加交换。 |
| Pi 4 | 1 GB | 紧张 | 配合交换空间可用,配置要尽量精简。 |
| Pi 3B+ | 1 GB | 慢 | 可以运行,但比较卡。 |
| Pi零2 W | 512 MB | No | 不推荐。 |
最小: 1 GB RAM,1核,500个MB可用磁盘,64位OS。 推荐: 2 GB+ RAM、16 GB+ SD 卡(或 USB SSD)、以太网。
先决条件
- Raspberry Pi 4 或 5 个,带 2 个 GB+ RAM(推荐 4 个 GB)
- MicroSD 卡(16 GB+)或 USB SSD(性能更好)
- 官方Pi电源
- 网络连接(以太网或WiFi)
- 64 位 Raspberry Pi OS(必需 - 请勿使用 32 位)
- 约 30 分钟
设置
闪存 OS
使用 Raspberry Pi OS Lite (64-bit) -- 无需桌面环境,适合无头服务器。
- 下载 Raspberry Pi Imager。
- 选择OS:Raspberry Pi OS Lite(64位)。
- 在设置对话框中,预先配置:
- 主机名:
gateway-host - 启用 SSH
- 设置用户名和密码
- 配置 WiFi(如果不使用以太网)
- 主机名:
- 将系统刷写到 SD 卡或 USB 驱动器中,插入后启动 Pi。
通过 SSH 连接
更新系统
安装 Node.js 24 LTS
添加交换(对于 2 GB 或更少很重要)
安装 OpenClaw
运行入门引导培训
按照向导操作。对于无头设备,建议使用 API 密钥而不是 OAuth。Telegram 是最容易上手的渠道。
验证
访问 Control UI
在你的电脑上,从 Pi 获取仪表盘 URL:
然后在另一个终端中创建 SSH 隧道:
在本地浏览器中打开打印出的 URL。若要实现始终在线的远程访问,请参阅 Tailscale 集成。
性能提示
使用 USB SSD -- SD 卡速度慢且磨损。 USB SSD 显着提高了性能并能承受更多的写入周期;如果您将 OS 保留在 SD 上,则可将其用于 OPENCLAW_STATE_DIR。请参阅 Pi USB 启动指南。
Enable 模块编译缓存 -- 加速低功耗 Pi 主机上重复的 CLI 调用。 OPENCLAW_NO_RESPAWN=1 保持例行网关在进程内重新启动,避免额外的进程切换并保持 PID 在小型主机上的简单跟踪:
使用 /var/tmp,而不是 /tmp——一些发行版在启动时清除 /tmp,这会删除预热的缓存。网关主线程保持未缓存状态,以避免同步缓存写入延迟启动或关闭。工作人员保留缓存;请参阅 网关缓存策略。
降低内存使用 -- 对于无头设置,释放 GPU 内存并禁用未使用的服务:
systemd 用于特定于主机的启动调整的插入项 — 受管单元拥有通用重新启动策略(Restart=always、RestartSec=5)。如果此 Pi 主要运行 OpenClaw,则仅为特定于主机的启动设置添加服务插入项:
然后执行 systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service。在无头 Pi 上,还应先启用 lingering,这样用户服务在注销后也能继续运行:sudo loginctl enable-linger "$(whoami)"。
推荐模型设置
由于 Pi 仅运行网关,因此请使用云托管的 API 模型 - 不要在 Pi 上运行本地 LLM,即使是小型模型也太慢而无法使用:
ARM 二进制说明
大多数 OpenClaw 功能在 ARM64 上无需修改即可运行(Node.js、Telegram、WhatsApp/Baileys、Chromium)。偶尔缺少 ARM 构建的二进制文件通常是由技能提供的可选 Go/Rust CLI 工具。先使用 uname -m 验证架构(应显示 aarch64),然后在缺失二进制文件的发布页面上检查是否有 linux-arm64 / aarch64 产物,再在必要时回退为从源代码构建。
持久化与备份
OpenClaw 的状态位于:
~/.openclaw/--openclaw.json,共享和每个代理 SQLite 身份验证存储,channel/provider 状态,会话。~/.openclaw/workspace/-- agent 工作区(SOUL.md、memory、artifacts)。
这些产品在重新启动后仍能幸存,并受益于 SSD 而非 SD 卡的性能和使用寿命。使用以下命令创建备份存档:
绝对符号链接保留其原始目标位置,包括指向单独备份的配置或凭据的链接。在激活另一台主机或另一条路径上的状态之前查看这些链接;请参阅 备份符号链接警告 。恢复验证并提取到新的暂存目录中;激活是一个单独的离线步骤。有关回滚警告和激活顺序,请参阅 恢复完整存档 。
故障排查
内存不足 -- 验证交换是否与 free -h 处于活动状态。禁用未使用的服务 (sudo systemctl disable cups bluetooth avahi-daemon)。仅使用基于 API- 的模型。
性能缓慢 -- 使用 USB SSD 代替 SD 卡。通过 vcgencmd get_throttled 检查 CPU 是否降频(应返回 0x0)。
服务无法启动 -- 使用 journalctl --user -u openclaw-gateway.service --no-pager -n 100 查看日志,并运行 openclaw doctor --non-interactive。如果这是无头 Pi,还要验证 lingering 是否已启用:sudo loginctl enable-linger "$(whoami)"。
ARM 二进制问题 -- 如果某个 skill 失败并显示 "exec format error",请检查该二进制是否有 ARM64 构建。使用 uname -m 验证架构(应显示 aarch64)。
WiFi 断开 -- 关闭 WiFi 电源管理:sudo iwconfig wlan0 power off。