在 Raspberry Pi 上運行 OpenClaw：打造低成本、永不離線的 AI 閘道器

你是否曾經想過跑一個 24 小時在線的 AI 助理或機器人，但看到雲端主機的月費帳單就縮手了？或者你有一台閒置的電腦，但為了跑個簡單的 Telegram 機器人而整天開著它，電費又讓你心痛。這正是 Raspberry Pi 大顯身手的時候，只要幾十美金的硬體成本，就能擁有一個專屬的 AI 運算中心。

這篇教學會帶你把 OpenClaw Gateway 部署在 Raspberry Pi 上。這是一個非常划算的方案，適合用來跑個人 AI 助理、家庭自動化中心，或是全天候運作的 Telegram/WhatsApp 機器人。

需要準備的東西

在開始之前，請確保你手邊有這些東西：

• Raspberry Pi 4 或 5 (建議 2GB RAM 以上)
• MicroSD 卡 (16GB+) 或 USB SSD (效能更好)
• 電源供應器 (建議使用官方版本)
• 網路連接 (乙太網路或 WiFi)
• 大約 30 分鐘的空檔

快速開始

跟著以下步驟，在 5 分鐘內完成核心路徑的安裝。

1. 燒錄 OS

使用 Raspberry Pi OS Lite (64-bit)。因為是作為伺服器使用，我們不需要圖形介面。

1. 下載 Raspberry Pi Imager。
2. 選擇 OS：Raspberry Pi OS Lite (64-bit)。
3. 點擊齒輪圖示 (⚙️) 進行預先設定：
   • 設定 Hostname：gateway-host
   • 開啟 SSH
   • 設定使用者名稱與密碼
   • 設定 WiFi (如果你不打算接網路線)
4. 燒錄至你的 SD 卡或 USB 磁碟，然後插入 Pi 並開機。

2. 透過 SSH 連線

ssh user@gateway-host
# 或者使用 IP 位址
ssh user@192.168.x.x

3. 系統初始化與安裝 Node.js

連線成功後，先更新系統並安裝 Node.js 22：

# 更新系統
sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl build-essential

# 設定時區
sudo timedatectl set-timezone America/Chicago  # 請改成你的時區

# 安裝 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

4. 設定 Swap (針對 2GB RAM 以下機型)

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

# 優化低記憶體表現
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

5. 安裝 OpenClaw 並執行 Onboarding

直接使用官方指令進行安裝：

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

安裝完成後，執行設定精靈：

openclaw onboard --install-daemon

在引導過程中，建議選擇：

1. Gateway mode: Local
2. Auth: API keys (在無頭模式的 Pi 上 OAuth 較難處理)
3. Channels: 建議先從 Telegram 開始
4. Daemon: Yes (使用 systemd)

6. 驗證運行狀態

# 檢查 OpenClaw 狀態
openclaw status

# 查看日誌
journalctl -u openclaw -f

疑難排解

如果你在 Raspberry Pi 上遇到問題，通常是以下幾種情況：

• 記憶體不足 (OOM): 檢查記憶體狀態 free -h。如果經常當機，請參考步驟 5 增加更多的 Swap 空間。
• 效能緩慢: 建議改用 USB SSD 取代 SD 卡。另外可以嘗試關閉不必要的服務：sudo systemctl disable cups bluetooth avahi-daemon。
• 服務無法啟動: 使用 journalctl -u openclaw --no-pager -n 100 查看詳細日誌。如果你是使用手動安裝 (Hackable Install)，請確保執行過 npm run build。
• ARM Binary 錯誤: 如果某個 Skill 報錯 “exec format error”，代表該工具可能沒有 ARM64 版本。請檢查該工具是否有提供 ARM 建置版本或嘗試從原始碼編譯。
• WiFi 斷線: 針對無頭模式的 Pi，關閉 WiFi 電源管理可以增加穩定性：

  sudo iwconfig wlan0 power off

效能優化建議

雖然 Raspberry Pi 很強大，但它畢竟不是工作站。為了獲得最佳體驗，我推薦以下做法：

1. 使用 USB SSD: SD 卡的讀寫速度是最大的瓶頸，改用 SSD 會讓你感覺像換了一台新機器。
2. 減少記憶體占用: 在 /boot/config.txt 中加入 gpu_mem=16 來釋放顯示記憶體。
3. 模型選擇: 讓 Pi 負責 Gateway 的轉發工作就好，不要嘗試在 Pi 上運行本地 LLM。請在設定中將模型指向雲端 API（如 Claude 3.5 Sonnet 或 GPT-4o-mini），這能確保回應速度在水準之上。

有任何安裝上的疑難雜症嗎？歡迎諮詢 AI Setup Assistant。

下一步

• Linux guide — 通用的 Linux 設定說明
• DigitalOcean guide — 如果你決定改用雲端方案
• Tailscale — 讓你隨時隨地遠端存取 Pi 的 Dashboard
• Nodes — 將你的筆電或手機與 Pi Gateway 配對