OpenClaw on Raspberry Pi

目標

Raspberry Piで永続的で常時稼働のOpenClaw Gatewayを約$35〜80の1回限りのコスト（月額料金なし）で実行します。

最適な用途:

  • 24時間365日のパーソナルAIアシスタント
  • ホームオートメーションハブ
  • 低電力、常時利用可能なTelegram/WhatsAppボット

ハードウェア要件

PiモデルRAM動作?備考
Pi 54GB/8GB✅ 最適最速、推奨
Pi 44GB✅ 良好ほとんどのユーザーに最適
Pi 42GB✅ 可動作する、swapを追加
Pi 41GB⚠️ タイトswapで可能、最小限の設定
Pi 3B+1GB⚠️ 遅い動作するが遅い
Pi Zero 2 W512MB❌非推奨

最小スペック: 1GB RAM、1コア、500MBディスク 推奨: 2GB以上のRAM、64ビットOS、16GB以上のSDカード（またはUSB SSD）

必要なもの

  • Raspberry Pi 4または5（2GB以上推奨）
  • MicroSDカード（16GB以上）またはUSB SSD（パフォーマンス向上）
  • 電源（公式Pi PSU推奨）
  • ネットワーク接続（イーサネットまたはWiFi）
  • 約30分

1) OSをフラッシュ

**Raspberry Pi OS Lite（64ビット）**を使用 — ヘッドレスサーバーにはデスクトップは不要です。

  1. Raspberry Pi Imagerをダウンロード
  2. OSを選択: Raspberry Pi OS Lite (64-bit)
  3. 歯車アイコン（⚙️）をクリックして事前設定:
    • ホスト名を設定: gateway-host
    • SSHを有効化
    • ユーザー名/パスワードを設定
    • WiFiを設定（イーサネットを使用しない場合）
  4. SDカード/USBドライブにフラッシュ
  5. 挿入してPiを起動

2) SSH経由で接続

ssh user@gateway-host
# またはIPアドレスを使用
ssh [email protected]

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 22をインストール（ARM64）

# NodeSource経由でNode.jsをインストール
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 確認
node --version  # v22.x.xと表示されるはず
npm --version

5) Swapを追加（2GB以下の場合は重要）

Swapはメモリ不足クラッシュを防ぎます:

# 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

# 低RAM用に最適化（swappinessを減らす）
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

6) OpenClawをインストール

オプションA: 標準インストール（推奨）

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

オプションB: ハッカブルインストール（いじる場合）

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

ハッカブルインストールでは、ログとコードに直接アクセスできます — ARM固有の問題のデバッグに便利です。

7) オンボーディングを実行

openclaw onboard --install-daemon

ウィザードに従う:

  1. Gateway mode: Local
  2. Auth: APIキー推奨（OAuthはヘッドレスPiでは気まぐれな場合があります）
  3. Channels: Telegramが最も簡単に始められます
  4. Daemon: Yes（systemd）

8) インストールを確認

# ステータスを確認
openclaw status

# サービスを確認
sudo systemctl status openclaw

# ログを表示
journalctl -u openclaw -f

9) ダッシュボードにアクセス

Piはヘッドレスなので、SSHトンネルを使用:

# ラップトップ/デスクトップから
ssh -L 18789:localhost:18789 user@gateway-host

# その後ブラウザで開く
open http://localhost:18789

または、常時アクセスにTailscaleを使用:

# Pi上で
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up

# 設定を更新
openclaw config set gateway.bind tailnet
sudo systemctl restart openclaw

パフォーマンス最適化

USB SSDを使用（大幅な改善）

SDカードは遅く、摩耗します。USB SSDはパフォーマンスを劇的に向上させます:

# USBから起動しているか確認
lsblk

セットアップについては、Pi USB boot guideを参照してください。

メモリ使用量を削減

# GPUメモリ割り当てを無効化（ヘッドレス）
echo 'gpu_mem=16' | sudo tee -a /boot/config.txt

# 不要な場合はBluetoothを無効化
sudo systemctl disable bluetooth

リソースを監視

# メモリを確認
free -h

# CPU温度を確認
vcgencmd measure_temp

# ライブ監視
htop

ARM固有の注意事項

バイナリ互換性

ほとんどのOpenClaw機能はARM64で動作しますが、一部の外部バイナリにはARMビルドが必要な場合があります:

ツールARM64ステータス備考
Node.js✅完璧に動作
WhatsApp（Baileys）✅純粋なJS、問題なし
Telegram✅純粋なJS、問題なし
gog（Gmail CLI）⚠️ARMリリースを確認
Chromium（ブラウザ）✅sudo apt install chromium-browser

スキルが失敗した場合、そのバイナリにARMビルドがあるか確認してください。多くのGo/Rustツールには対応しています。一部は対応していません。

32ビット vs 64ビット

常に64ビットOSを使用してください。 Node.jsと多くの最新ツールには必要です。確認:

uname -m
# aarch64（64ビット）と表示されるはず、armv7l（32ビット）ではない

推奨モデルセットアップ

Piは単なるGateway（モデルはクラウドで実行）なので、APIベースのモデルを使用:

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

Piでローカル LLMを実行しようとしないでください — 小さなモデルでも遅すぎます。ClaudeやGPTに重い作業を任せましょう。

起動時の自動起動

オンボーディングウィザードがこれを設定しますが、確認するには:

# サービスが有効になっているか確認
sudo systemctl is-enabled openclaw

# 有効でない場合は有効化
sudo systemctl enable openclaw

# 起動時に開始
sudo systemctl start openclaw

トラブルシューティング

メモリ不足（OOM）

# メモリを確認
free -h

# さらにswapを追加（ステップ5を参照）
# またはPiで実行中のサービスを減らす

パフォーマンスが遅い

  • SDカードの代わりにUSB SSDを使用
  • 未使用のサービスを無効化: sudo systemctl disable cups bluetooth avahi-daemon
  • CPUスロットリングを確認: vcgencmd get_throttled（0x0を返すはず）

サービスが起動しない

# ログを確認
journalctl -u openclaw --no-pager -n 100

# 一般的な修正: 再ビルド
cd ~/openclaw  # ハッカブルインストールを使用している場合
npm run build
sudo systemctl restart openclaw

ARMバイナリの問題

スキルが「exec format error」で失敗した場合:

  1. バイナリにARM64ビルドがあるか確認
  2. ソースからビルドを試す
  3. またはARMサポートを持つDockerコンテナを使用

WiFiのドロップ

WiFiのヘッドレスPiの場合:

# WiFi電源管理を無効化
sudo iwconfig wlan0 power off

# 永続化
echo 'wireless-power off' | sudo tee -a /etc/network/interfaces

コスト比較

セットアップ1回限りのコスト月額コスト備考
Pi 4（2GB）約$45$0+ 電力（約$5/年）
Pi 4（4GB）約$55$0推奨
Pi 5（4GB）約$60$0最高のパフォーマンス
Pi 5（8GB）約$80$0オーバースペックだが将来性あり
DigitalOcean$0$6/月$72/年
Hetzner$0€3.79/月約$50/年

損益分岐点: Piはクラウド VPSに対して約6〜12ヶ月で元が取れます。

関連項目

← ドキュメントに戻る