在树莓派 4/5（推荐 2 GB+ 内存）上跑 OpenClaw Gateway，只需 30 分钟就能获得一台 24/7 在线的个人 AI 网关。模型通过云端 API 运行，树莓派只负责网关任务，低至 1 GB 内存也能跑（需添加 Swap）。关键步骤：刷写 64 位 Raspberry Pi OS Lite，安装 Node.js 24，执行 openclaw onboard --install-daemon 初始化，再通过 SSH 隧道访问控制面板。推荐用 USB SSD 提速、启用模块编译缓存、为无头模式释放 GPU 内存。如果内存 ≤2 GB，务必加 2G Swap，否则服务容易 OOM 崩溃。

树莓派部署 OpenClaw 全过程：刷机、配置、调优与排错

在树莓派上运行持久化、全天候的 OpenClaw Gateway。因为 Pi 只负责网关（模型通过 API 在云端运行），即便是入门款也能轻松应对——硬件成本约 35–80 美元一次性投入，无月费。

硬件兼容性

Pi 型号	内存	能否运行	说明
Pi 5	4/8 GB	最佳	最快，推荐。
Pi 4	4 GB	良好	大多数用户的最佳选择。
Pi 4	2 GB	可行	需添加 Swap。
Pi 4	1 GB	勉强	加 Swap，最小配置。
Pi 3B+	1 GB	慢	能用但响应慢。
Pi Zero 2 W	512 MB	不推荐	无法正常运行。

最低要求： 1 GB 内存、1 核 CPU、500 MB 空闲磁盘、64 位操作系统。
推荐配置： 2 GB+ 内存、16 GB+ SD 卡（或 USB SSD）、有线网络。

前置条件

• 树莓派 4 或 5，2 GB+ 内存（推荐 4 GB）
• MicroSD 卡（16 GB+）或 USB SSD（性能更好）
• 官方树莓派电源适配器
• 网络连接（有线或 WiFi）
• 64 位 Raspberry Pi OS（必须，不要用 32 位）
• 约 30 分钟

配置步骤

1. 刷写系统
   使用 Raspberry Pi OS Lite（64-bit）——无头服务器无需桌面。

   • 下载 Raspberry Pi Imager。
   • 选择操作系统：Raspberry Pi OS Lite（64-bit）。
   • 在设置对话框中预配置：
     • 主机名：gateway-host
     • 启用 SSH
     • 设置用户名和密码
     • 配置 WiFi（如果不使用有线网络）
   • 刷写到 SD 卡或 USB 驱动器，插入后启动树莓派。

2. SSH 连接

   ssh user@gateway-host

3. 更新系统

   sudo apt update && sudo apt upgrade -y
   sudo apt install -y git curl build-essential
   
   # 设置时区（对 cron 定时任务和提醒很重要）
   sudo timedatectl set-timezone America/Chicago

4. 安装 Node.js 24

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

5. 添加 Swap（2 GB 及以下内存必做）

   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，适合低内存设备
   echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
   sudo sysctl -p

6. 安装 OpenClaw

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

7. 运行初始配置向导

   openclaw onboard --install-daemon

   按向导操作。无头设备推荐用 API key 而非 OAuth。Telegram 是最容易上手的渠道。

8. 验证运行状态

   openclaw status
   systemctl --user status openclaw-gateway.service
   journalctl --user -u openclaw-gateway.service -f

9. 访问控制面板
   在你的电脑上，从树莓派获取仪表板 URL：

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

   然后在另一个终端创建 SSH 隧道：

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

   在本地浏览器打开打印出的 URL。如需远程访问，参考 Tailscale 集成。

性能优化建议

使用 USB SSD — SD 卡速度慢且易磨损。USB SSD 能大幅提升性能。参考 树莓派 USB 启动指南。

启用模块编译缓存 — 在低性能树莓派上加速 CLI 重复调用：

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

OPENCLAW_NO_RESPAWN=1 让常规 Gateway 重启保持进程内执行，减少进程交接，便于小主机上的 PID 追踪。

减少内存占用 — 无头部署时释放 GPU 内存并禁用不需要的服务：

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

systemd drop-in 实现稳定重启 — 如果这台 Pi 主要跑 OpenClaw，可以添加服务 drop-in：

systemctl --user edit openclaw-gateway.service

[Service]
Environment=OPENCLAW_NO_RESPAWN=1
Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
Restart=always
RestartSec=2
TimeoutStartSec=90

然后执行 systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service。在无头 Pi 上，还需启用 lingering 确保用户服务在退出登录后继续运行：sudo loginctl enable-linger "$(whoami)"。

推荐模型配置

由于 Pi 只运行网关，应使用云端 API 模型：

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

不要在 Pi 上运行本地 LLM — 哪怕是小型模型也慢到无法使用。让 Claude 或 GPT 处理模型任务。

ARM 二进制注意事项

大部分 OpenClaw 功能在 ARM64 上无需修改即可工作（Node.js、Telegram、WhatsApp/Baileys、Chromium）。偶尔缺少 ARM 构建的二进制通常是可选 Go/Rust CLI 工具（由 skill 携带）。在回退到源码编译前，先检查该二进制的发布页是否有 linux-arm64 / aarch64 产物。

持久化与备份

OpenClaw 状态存储在：

• ~/.openclaw/ — openclaw.json、每个 agent 的 auth-profiles.json、渠道/provider 状态、会话。
• ~/.openclaw/workspace/ — agent 工作区（SOUL.md、记忆、artifacts）。

这些数据在重启后保留。用以下命令创建便携快照：

openclaw backup create

如果将这些数据放在 SSD 上，性能和寿命都会优于 SD 卡。

常见问题

树莓派能本地跑 LLM 模型吗？

不行。树莓派的算力不足以运行任何实用的本地 LLM，即使是小型模型也极慢。你应该只使用云端 API 模型（如 Claude、GPT），Pi 只负责网关和路由。

2 GB 内存的树莓派够用吗？

2 GB 内存加上 2 GB Swap 可以运行，但推荐 4 GB 以获得更稳定的体验。如果只有 2 GB，务必按上述步骤添加 Swap 并降低 swappiness。同时禁用蓝牙、AVAHI 等不需要的服务，并设置 gpu_mem=16 释放 GPU 内存。

服务启动不了，如何排查？

首先检查日志：journalctl --user -u openclaw-gateway.service --no-pager -n 100。然后运行 openclaw doctor --non-interactive 诊断常见问题。如果是无头 Pi，确认 lingering 已启用：sudo loginctl enable-linger "$(whoami)"。如果是内存不足，用 free -h 查看 Swap 是否激活。

下一步

• 渠道列表 — 接入 Telegram、WhatsApp、Discord 等
• Gateway 配置 — 所有配置选项
• 更新 — 保持 OpenClaw 最新版本

相关文档

• 安装概述
• Linux 服务器
• 支持平台