首页
介绍
教程
Skills
技术博客
GitHub
返回教程中心
平台与客户端

OpenClaw Raspberry Pi 部署教程，低成本长期在线配置指南

O
OpenClaw AI
2026-03-25

如果你想用尽可能低的成本，换来一台始终在线、可放在家里角落长期运行的 OpenClaw 主机，Raspberry Pi 是官方专门支持的平台之一。它的定位很明确：不是拿来本地推理大模型，而是作为低功耗、长期在线的 Gateway 主机，让渠道、调度和远程控制稳定常驻。

这条方案适合什么人

官方 Raspberry Pi 文档把它定位为下面几类目标：

  • 7×24 个人 AI 助手
  • 家庭自动化中枢
  • 长期开着的 Telegram / WhatsApp Bot 主机

简单说，如果你已经知道“自己的笔记本电脑不可能 24 小时开机”，但又不想立刻买 VPS，Pi 是非常合理的下一步。

先别误会：Pi 更适合当 Gateway 主机，不适合本地跑大模型

官方文档说得很直白，Pi 适合作为 Gateway。模型建议走云端 API，而不是在 Pi 上本地硬跑大型 LLM。即使能跑，小模型以外的实际体验通常也不理想。

所以正确期待应该是：

  • Pi 负责 Gateway、渠道、日志、配置、远程访问
  • 模型推理由 OpenAI、Anthropic、OpenRouter 或 Ollama 云端模型承担

硬件选型怎么选

根据官方平台页：

  • Pi 5 4GB / 8GB：最佳选择，速度最快
  • Pi 4 4GB：最均衡，适合大多数人
  • Pi 4 2GB：可用，但建议加 swap
  • Pi 4 1GB：勉强可行，需要更克制的配置
  • Pi 3B+：能跑，但会明显偏慢
  • Pi Zero 2 W：不推荐

官方给出的下限和推荐值是：

  • 最低：1GB RAM、1 核、500MB 磁盘
  • 推荐：2GB 以上 RAM、64 位系统、16GB 以上 SD 卡或 USB SSD

如果你是第一次买板子，我建议直接从 Pi 4 4GB 或 Pi 5 起步，省下很多“能跑但不舒服”的调参时间。

系统应该怎么选

官方建议使用 64 位 Raspberry Pi OS，最好是 Lite 版本。理由很直接：

  • 更省资源
  • 更适合无头部署
  • 更接近服务器场景

如果你不是专门想在 Pi 上装桌面，不建议为了“看起来方便”去装完整桌面环境，它只会多占资源。

安装前要准备什么

开始前，建议准备好这些：

  1. 一张质量可靠的 16GB+ SD 卡，或更理想的 USB SSD
  2. 一台能写镜像的电脑
  3. 稳定电源
  4. 本地网络或 Wi-Fi
  5. 一个用于 SSH 登录的用户名和密码

如果你准备让它长期在线，最好从一开始就想好：

  • 它放在哪
  • 如何联网
  • 断电后是否能自动恢复

第一步：刷写系统

官方建议用 Raspberry Pi Imager 刷入系统，并在刷写阶段就预先配置：

  • hostname
  • SSH
  • 用户名和密码
  • Wi-Fi

这样你第一次启动后基本就可以直接通过 SSH 接入，不需要接显示器和键盘。

第二步：通过 SSH 连上 Pi

官方示例：

bash
ssh user@gateway-host
# 或
ssh user@192.168.x.x

如果你能顺利进 shell，后面所有 OpenClaw 安装步骤都可以完全在 SSH 下完成。

第三步：做基础系统准备

官方文档给出的起步命令是：

bash
sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl build-essential
sudo timedatectl set-timezone Asia/Shanghai

时区这一步不要偷懒。提醒、调度、日志时间和某些自动化行为都依赖它。上面我把官方示例里的时区替换成了你的本地时区写法，更适合这个站点读者直接照着改。

第四步：安装 Node.js 24

官方 Raspberry Pi 平台页给出的命令是：

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

这里最关键的是确认：

  • 系统是 ARM64
  • Node 版本已经是 24.x

如果你装的是 32 位系统或 Node 版本太老，后面很多奇怪问题其实从这里就已经埋下了。

第五步：低内存机型一定要补 swap

对于 2GB 或更低内存的 Pi，官方明确建议加 swap。示例：

bash
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
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

这一步的价值不是让 Pi 突然变快，而是降低安装依赖、重建缓存或临时高峰时直接 OOM 的概率。

第六步：安装 OpenClaw

官方给了两条路：

方案 A：标准安装

适合绝大多数用户：

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

方案 B：可修改安装

适合你准备调试、二次开发或排 ARM 兼容问题：

bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm run build
npm link

如果你的目标只是把节点稳定跑起来，直接用标准安装就够了。

第七步：运行 onboarding 并安装 daemon

官方建议：

bash
openclaw onboard --install-daemon

在 Pi 上，向导里的选择通常建议这样处理：

  1. Gateway 模式选 Local
  2. 模型认证优先选 API Key
  3. 第一个渠道优先选 Telegram 这类排障边界更清晰的渠道
  4. 守护进程安装选 是

官方特别提醒，在无头 Pi 上 OAuth 流程有时会更挑环境，所以第一次接模型时，API Key 往往比浏览器登录更省心。

第八步：验证安装是否真的成功

不要看到安装结束就认为一切 OK，至少做这几步：

bash
openclaw --version
openclaw doctor
openclaw status

如果你已经安装成 daemon / service，再看一次服务状态也很值得。

第九步：访问 Dashboard

官方建议通过 SSH 隧道来访问 Pi 上的 Dashboard。先在 Pi 上打印 Dashboard 地址：

bash
ssh user@gateway-host 'openclaw dashboard --no-open'

然后在你电脑的另一个终端里建立隧道：

bash
ssh -N -L 18789:127.0.0.1:18789 user@gateway-host

最后在本机浏览器打开：

text
http://127.0.0.1:18789/

这套方式的好处是：

  • Gateway 不需要裸露到公网
  • 你可以先确认服务本身完全正常
  • 远程访问和安全暴露可以以后再做

性能优化：哪些值得做，哪些不值得

最值得做：改用 USB SSD

官方文档明确说这会带来显著提升。原因很简单，很多“Pi 很卡”的抱怨，本质上是存储介质太慢，不是 OpenClaw 本身的问题。

可以做：开启 Node 模块编译缓存

官方示例：

bash
grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF'
export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
mkdir -p /var/tmp/openclaw-compile-cache
export OPENCLAW_NO_RESPAWN=1
EOF
source ~/.bashrc

这更适合 CLI 会被频繁调用的场景，可以减少重复冷启动开销。

可以做：减少无头机器的额外负担

例如：

bash
echo 'gpu_mem=16' | sudo tee -a /boot/config.txt
sudo systemctl disable bluetooth

如果这台 Pi 就是纯服务器节点，这类调整通常有意义。

ARM 平台上需要额外注意什么

官方文档特别提到，OpenClaw 大部分能力都能在 ARM64 上正常跑，但某些外部二进制工具未必有 ARM 构建版本。所以如果某个 Skill 或外部命令失效，别先怪 OpenClaw，先确认它依赖的二进制是否支持 ARM。

官方举的方向包括：

  • Node.js 正常
  • WhatsApp、Telegram 这类纯 JS 渠道没大问题
  • 某些第三方 CLI 可能需要单独找 ARM 版本
  • Chromium 可以直接用系统包安装

这也是为什么我建议尽量用官方已有路径，不要一开始就在 Pi 上叠太多小众依赖。

32 位系统为什么不推荐

官方说得很明确：务必使用 64 位 OS。检查命令：

bash
uname -m

理想输出应该是：

text
aarch64

如果看到的是 armv7l 之类 32 位标识，很多现代依赖都会受限。

模型怎么配最合理

官方平台页建议 Pi 上优先使用 API 型云端模型，例如：

json
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-20250514",
        "fallbacks": ["openai/gpt-4o-mini"]
      }
    }
  }
}

这段配置的核心思想不是“这两个模型一定最适合所有人”，而是：

  • Pi 自己只负责 Gateway
  • 真正的推理成本放到云端模型
  • fallback 可以提高长期在线系统的韧性

如果你想在 Pi 上本地跑重量级模型，体验通常远不如把它当成轻量控制节点。

开机自动启动怎么确认

如果你已经在 onboarding 里安装了 daemon，通常已经自动配置好了。官方给出的检查方式是：

bash
sudo systemctl is-enabled openclaw
sudo systemctl enable openclaw
sudo systemctl start openclaw

具体服务名可能会因安装方式而略有不同，但重点是确认：

  • 服务已启用
  • 重启后会自动恢复

常见问题与排查

内存不足或系统被杀进程

优先检查：

bash
free -h

如果内存紧张：

  • 增大 swap
  • 减少并行运行的服务
  • 避免在 Pi 上同时叠太多浏览器/重型任务

性能慢得离谱

官方建议优先排查：

  • 是否仍在用慢速 SD 卡
  • 是否应该换 USB SSD
  • 是否有多余服务在后台占资源
  • CPU 是否过热或限频

相关命令：

bash
vcgencmd get_throttled
vcgencmd measure_temp
htop

服务起不来

先别急着重装，先看：

  • Node 是否正常
  • 64 位系统是否正确
  • daemon / systemd 是否真的启用
  • openclaw doctor 输出了什么

一条最务实的建议

Pi 真正的优势是“低功耗、低成本、长期在线”，不是“高性能本地 AI 工作站”。如果你顺着这个定位去配：

  • Pi 做 Gateway
  • 模型走云端
  • SSH 隧道访问 Dashboard
  • 必要时再加 Tailscale

它会是非常稳的一台家庭常驻 OpenClaw 主机。

继续阅读

相关阅读与站内入口

OpenClaw Linux VPS 部署教程，长期在线运行配置指南

按官方 Linux 平台文档整理最适合长期在线的 Gateway 运行路径和 systemd 服务安装方式。

OpenClaw 移动端使用教程，手机平板远程控制 Gateway 指南

理解 iOS、Android、笔记本该如何安全接入同一个长期在线 Gateway，而不是各自跑一套系统。

OpenClaw Windows 安装教程，WSL2 部署和使用指南

解释为什么官方推荐 WSL2，以及如何把 Windows 放在控制平面而不是长期承载 Gateway。

OpenClaw macOS 使用教程 菜单栏权限和远程控制指南

根据官方 macOS 文档整理菜单栏应用、本地权限和 Gateway 代理的定位。

查看全部 OpenClaw 教程

继续浏览安装部署、模型接入、渠道配置和故障排查等完整教程。

前往 Skills 市场

找到更多可直接安装的 Skills 和可复用能力，丰富你的 OpenClaw 使用场景。

准备好开始了吗？

继续探索更多教程，或者去技能市场看看有哪些现成的插件。