在 Raspberry Pi 上部署 OpenClaw 是什么体验？

OpenClaw 爆火那段时间，很多人去买 Mac Mini 专门跑它。但其实家里吃灰的树莓派就够了——功耗不到 10W，24 小时常驻，电费几乎可以忽略不计。这篇文章聊聊在 Raspberry Pi 上部署 OpenClaw 实际是什么体验，包括哪些地方顺，哪些地方麻烦。

先说结论：能跑，但对硬件有要求

OpenClaw 本身只是一个 Gateway 进程，模型调用走的是云端 API，Pi 负责的是消息收发、工具执行、记忆管理这些相对轻量的工作。所以即使是树莓派也能胜任，但型号和内存选错了体验会差很多。

官方文档给出的硬件要求：

Pi 5 的 Cortex-A76 核心性能大约是 Pi 4 的三倍，工具解析、代码执行这些操作在 Pi 5 上是流畅的，在 Pi 4 上则会有明显的等待感。如果是新买，Pi 5（8GB）大约 80 美元，是目前性价比最高的选择。

Pi Zero、Pi 3 这类低端型号跑完整版 OpenClaw 勉强，官方有一个精简版叫 PicoClaw，专门为这些低配设备设计，如果你手上只有这些型号可以考虑。

存储选 SSD，不要只用 SD 卡

这一点几乎所有部署过的人都会提到：OpenClaw 会频繁读写 SQLite 记忆数据库和日志文件，SD 卡的随机读写性能撑不住，时间久了还容易损坏。

推荐配置：用官方的 M.2 HAT+ 加一块便宜的 NVMe SSD 跑系统，性能体验差距很明显。如果实在不想加 HAT，至少用高品质 SD 卡（A2 规格，Samsung Pro Endurance 或 SanDisk Extreme），并且做好定期备份。

装系统

用 Raspberry Pi Imager 刷镜像，选 Raspberry Pi OS Lite（64-bit）。不需要桌面环境，Lite 版省下来的内存和 CPU 都给 OpenClaw 用。

⚠️ 必须选 64-bit，32-bit 镜像有 4GB 内存上限，跑不了现代 Node.js。

系统刷好启动之后，先更新软件包：

sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl build-essential

设置时区（影响 cron 定时任务和提醒功能）：

sudo timedatectl set-timezone Asia/Shanghai

加 swap——必做，不是可选

安装 OpenClaw 时 npm 编译依赖需要不少内存，内存不够会被系统直接 Kill 掉。官方文档明确建议在 Pi 上先加 2GB swap：

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

降低 swappiness，避免 Pi 过于积极地使用 swap 拖慢速度：

echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

安装 Node.js 和 OpenClaw

官方文档推荐在 Pi 上安装 Node.js 24.x：

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs
node --version

然后跑官方安装脚本：

curl -fsSL https://openclaw.ai/install.sh | bash

在 Pi 5（8GB）上安装大约需要 3 到 5 分钟。Pi 4 会稍慢一些。

初始化配置

openclaw onboard --install-daemon

在无头服务器（没有显示器）上跑 onboard，引导会跳过浏览器打开的步骤，改为打印 SSH 端口转发指令，让你在本机浏览器访问控制面板：

ssh -L 18789:127.0.0.1:18789 pi@你的树莓派IP

然后在本机浏览器打开 http://127.0.0.1:18789。

官方文档特别提示：在无头设备上，API Key 认证比 OAuth 更可靠，OAuth 需要弹出浏览器完成授权，在没有显示器的 Pi 上会比较麻烦。

远程访问：用 Tailscale

Pi 通常在家里的局域网里，想从外面用手机访问需要穿透内网。官方文档推荐用 Tailscale，和 OpenClaw 搭配非常顺：

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up

配好之后 Pi 会有一个 Tailscale 的 IP，无论你在哪里都能访问。

加上 Telegram 渠道之后，随时用手机发消息触发任务，Pi 在家里默默执行，结果推回给你。

几个真实的坑

不要在 Pi 上跑本地大模型

很多人装完会想试试 Ollama。结论是：装了之后 Agent 会因为内存耗尽而卡死或疯狂 swap，根本跑不起来。Pi 的定位是 Gateway（负责协调），模型调用走云端 API。即使你对隐私要求很高，也不适合在 Pi 上跑推理，老实用 API 就好。

电源不要省钱

Pi 5 在高负载下功耗不小，廉价 USB-C 充电头在 SSD、风扇同时工作时很容易触发欠压保护，导致随机崩溃。用官方的 27W 电源，不然排查问题会很头疼。

Pi 5 要上主动散热

持续跑 OpenClaw 会让 Pi 5 发热明显，触发热降频之后速度掉得很快。官方带风扇的外壳大约 10 美元，装上之后温度能控制在合理范围内。

4GB 内存在高负载下会卡

Pi 4（4GB）在处理复杂多步任务或者大上下文对话时，会看到明显的 swap 活动和响应变慢。如果预算允许，直接上 Pi 5（8GB）省得后悔。

Pi 上能做什么

官方博客上有一个真实案例：用 Pi 5 加摄像头模块搭了一个婚礼照相亭，OpenClaw 通过 SSH 远程控制另一台 Pi，用自然语言描述需求，AI 自动生成代码、配置热点、搭建分享页面，全程没有手写一行代码。

更日常的用法：接上 Telegram，让 AI 帮你定时发工作简报、监控服务状态、处理邮件、控制智能家居设备。Pi 常驻运行，你在哪里都能触发任务。

什么情况下不适合用 Pi

• 需要本地跑大模型：Pi 内存不够，换有 GPU 的机器
• 对响应速度要求很高：云端 VPS 在网络延迟上会有优势
• 不想维护硬件：SD 卡损坏、系统更新、断电恢复都需要自己处理
• 生产环境用途：官方建议生产环境用稳定性更高的 VPS 或专用服务器

配置速查