跳轉到主要內容
在 Raspberry Pi 上執行持久、永遠在線的 OpenClaw 閘道。由於 Pi 只是閘道（模型透過 API 在雲端執行），即使是普通規格的 Pi 也能很好地處理工作負載——典型硬體成本為一次性 $35-80，無月費。

​
硬體相容性

Pi 型號RAM可用嗎？備註
Pi 54/8 GB最佳最快，建議使用。
Pi 44 GB良好最適合多數使用者。
Pi 42 GB可以加入 swap。
Pi 41 GB吃緊可搭配 swap 與最小設定使用。
Pi 3B+1 GB慢可用但反應遲緩。
Pi Zero 2 W512 MB不建議不建議使用。
最低需求： 1 GB RAM、1 核心、500 MB 可用磁碟空間、64 位元作業系統。 建議： 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 分鐘

​
設定

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 磁碟，插入後啟動 Pi。
2

透過 SSH 連線

ssh user@gateway-host
3

更新系統

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

# Set timezone (important for cron and reminders)
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

# Reduce swappiness for low-RAM devices
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 金鑰而非 OAuth。Telegram 是最容易入門的頻道。
8

驗證

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

存取控制 UI

在你的電腦上，從 Pi 取得儀表板 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 可大幅改善效能並承受更多寫入循環；如果作業系統仍放在 SD 卡上，請將它用於 OPENCLAW_STATE_DIR。請參閱 Pi USB 開機指南。 啟用模組編譯快取——可加快低功耗 Pi 主機上的重複命令列介面呼叫。OPENCLAW_NO_RESPAWN=1 會讓例行閘道重新啟動保持在同一行程內，避免額外的行程交接，並讓小型主機上的 PID 追蹤保持簡單： 
grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF' # pragma: allowlist secret
export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
mkdir -p /var/tmp/openclaw-compile-cache
export OPENCLAW_NO_RESPAWN=1
EOF
source ~/.bashrc
使用 /var/tmp，不要使用 /tmp——某些發行版會在開機時清除 /tmp，導致預熱快取遺失。 降低記憶體使用量——對無頭設定，釋放 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 模型——不要在 Pi 上執行本機 LLM，即使是小型模型也太慢，實用性不足： 
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-6",
        "fallbacks": ["openai/gpt-5.4-mini"]
      }
    }
  }
}

​
ARM 二進位檔備註

多數 OpenClaw 功能可在 ARM64 上無需變更即可運作（Node.js、Telegram、WhatsApp/Baileys、Chromium）。偶爾缺少 ARM 建置的二進位檔通常是 Skills 隨附的選用 Go/Rust 命令列介面工具。使用 uname -m 驗證架構（應顯示 aarch64），然後在改為從原始碼建置前，先檢查缺少的二進位檔發布頁面是否有 linux-arm64 / aarch64 成品。

​
持久化與備份

OpenClaw 狀態位於：
  • ~/.openclaw/——openclaw.json、每個代理的 auth-profiles.json、頻道/提供者狀態、工作階段。
  • ~/.openclaw/workspace/——代理工作區（SOUL.md、記憶、成品）。
這些資料會在重新開機後保留，且在效能與壽命方面都能受益於使用 SSD 而非 SD 卡。使用以下命令建立可攜式快照： 
openclaw backup create

​
疑難排解

記憶體不足——使用 free -h 驗證 swap 已啟用。停用未使用的服務（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。

​
下一步

  • 頻道——連接 Telegram、WhatsApp、Discord 等更多服務
  • 閘道設定——所有設定選項
  • 更新——讓 OpenClaw 保持最新

​
相關