Raspberry Pi で OpenClaw を動かす：完全ハードウェア＆セットアップガイド

ほとんどの人はクラウドサーバーや高性能デスクトップで AI エージェントを実行します。しかし、デスクの上にある静かな選択肢があります：Raspberry Pi。フルロードでも10ワット未満の消費電力で、Raspberry Pi 5 は月数十円の電気代で OpenClaw を24時間365日稼働させ、完全にコントロール可能なプライベートな常時稼働 AI エージェントを提供します。

このガイドでは、適切なハードウェア選定から systemd の自動起動とパフォーマンスチューニングまで、すべてをカバーします。

なぜ Raspberry Pi なのか？

VPS で AI エージェントを実行すると通常、月$5〜$20 かかります。Raspberry Pi は初期ハードウェア投資の後、電気代は月約$0.50〜$1.00 です^[1]。コスト削減に加えて、ホームネットワーク上の Pi はハードウェアの物理的な制御、ホームオートメーションシステムや NAS デバイスへのローカルネットワークアクセス、ローカル連携でのゼロレイテンシ、API プロバイダー以外の月額請求なしを提供します。

セットアップをスキップしたい場合、ClawTank のようなホスティングプラットフォームがすべてを処理します。しかし、ローカルネットワークアクセスが欲しいティンカラーにとって、Raspberry Pi は最高の選択です。

ハードウェア要件

Raspberry Pi 5 の 8 GB RAM モデルが推奨です。Node.js ランタイム、ゲートウェイプロセス、同時ツール実行のすべてが余裕の恩恵を受けます。

冷却は必須です。冷却なしでは、Pi 5 は持続的使用の数分以内にサーマルスロットリングが発生します。公式アクティブクーラーまたは Argon ONE のようなパッシブアルミケースを使用してください^[2]。

ストレージ：SD カード vs. SSD

これはほとんどの人が想像するよりも重要です。ランダム 4K IOPS（データベースとログに重要なメトリック）は、典型的な A2 対応 SD カードと比較して NVMe SSD では約30倍優れています。OpenClaw はログを書き込み、SQLite メモリデータベースを更新し、スキル実行中に頻繁な小さなファイル読み取りを行います。公式 Raspberry Pi M.2 HAT 付きの SSD により、これらすべてが劇的に高速化されます。

電源： 公式 Raspberry Pi 27W USB-C 電源を使用してください。SSD とクーラーが接続されていると、サードパーティの充電器はしばしば低電圧警告を引き起こします。

オプションの UPS： 真の常時稼働運用のために、PiSugar 3 または Waveshare UPS HAT が短時間の停電時にバッテリーバックアップを、長時間の停電時にクリーンシャットダウンを提供します。

OS セットアップ

Raspberry Pi Imager を使用して Raspberry Pi OS Lite（64ビット） をフラッシュします。Lite バージョンはデスクトップを省略し、ヘッドレスサーバー用に約600 MB の RAM を節約します。

# 64ビットで実行していることを確認
uname -m
# 期待値: aarch64

# すべてを更新
sudo apt update && sudo apt full-upgrade -y
sudo reboot

信頼性の高いアクセスのために静的 IP を設定：

sudo nmcli con mod "Wired connection 1" \
  ipv4.addresses 192.168.1.50/24 \
  ipv4.gateway 192.168.1.1 \
  ipv4.dns "1.1.1.1,8.8.8.8" \
  ipv4.method manual

sudo nmcli con up "Wired connection 1"

Node.js と OpenClaw のインストール

OpenClaw には Node.js 22 以上が必要です。NodeSource リポジトリからインストール：

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

node --version   # v22.x.x
npm --version    # 10.x.x

OpenClaw をインストールしてオンボーディング：

npm install -g openclaw
openclaw onboard

ウィザードが LLM プロバイダーの選択、API キーの入力、ワークスペースのセットアップ、最初のメッセージング連携の設定をガイドします。

ゲートウェイ設定

Raspberry Pi 用に ~/.openclaw/openclaw.json を編集：

{
  "gateway": {
    "port": 3700,
    "maxConcurrentTasks": 2,
    "taskTimeout": 120,
    "logLevel": "info"
  },
  "providers": {
    "anthropic": { "apiKey": "sk-ant-..." }
  },
  "defaultModel": "claude-sonnet-4-20250514"
}

キー設定：maxConcurrentTasks: 2 でメモリ圧力を管理し、taskTimeout: 120 で暴走タスクを防止します。

常時稼働のための systemd

サービスファイルを作成：

sudo tee /etc/systemd/system/openclaw.service > /dev/null <<'EOF'
[Unit]
Description=OpenClaw AI Agent Gateway
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=pi
WorkingDirectory=/home/pi
ExecStart=/usr/bin/openclaw gateway start
Restart=always
RestartSec=10
Environment=NODE_ENV=production
MemoryMax=2G
CPUQuota=80%
StandardOutput=journal
StandardError=journal
SyslogIdentifier=openclaw

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw

Restart=always ディレクティブにより、クラッシュや再起動後の自動復旧が保証されます。MemoryMax=2G で暴走するメモリ消費を防止します。

パフォーマンスベンチマーク

Pi 5（8 GB）+ NVMe SSD、Anthropic プロバイダー使用時の測定値：

メモリ使用量はアイドル時約180 MB、アクティブな会話中280 MB、ピーク時最大450 MB です。CPU 使用率は API レスポンス待機中5%未満、ツール実行中15〜40%です。Pi 5 はこれを快適に処理します。

SD カードの寿命

SD カードを使用する場合、書き込み増幅を削減してください：

echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

echo 'tmpfs /tmp tmpfs defaults,noatime,nosuid,size=256m 0 0' | \
  sudo tee -a /etc/fstab

sudo sed -i 's/#SystemMaxUse=/SystemMaxUse=50M/' /etc/systemd/journald.conf
sudo systemctl restart systemd-journald

これらの変更により SD カードの寿命が大幅に延びます^[3]。

OpenClaw をインターネットに公開する

Cloudflare Tunnel（推奨）

ポートを開ける必要なし、TLS は自動処理：

curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-arm64.deb -o cloudflared.deb
sudo dpkg -i cloudflared.deb
cloudflared tunnel login
cloudflared tunnel create openclaw-pi

# ~/.cloudflared/config.yml
tunnel: <TUNNEL_ID>
credentials-file: /home/pi/.cloudflared/<TUNNEL_ID>.json
ingress:
  - hostname: openclaw.yourdomain.com
    service: http://localhost:3700
  - service: http_status:404

Tailscale

公開せずに自分のデバイスからのプライベートアクセス：

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up

Raspberry Pi vs. VPS vs. ホスティング

メンテナンスゼロなら ClawTank がマネージドインスタンスを提供します。趣味やホームオートメーション愛好家には Pi が最適です。

トラブルシューティング

再起動後にゲートウェイが失敗する

journalctl -u openclaw --since "5 minutes ago" を確認してください。一般的な原因はネットワーク未準備（After=network-online.target を確認）、Node.js が PATH にない、~/.openclaw/ のパーミッション問題です。

# サービスで絶対パスを使用して PATH 問題を修正
ExecStart=/usr/local/bin/openclaw gateway start

# パーミッション修正
sudo chown -R pi:pi /home/pi/.openclaw
chmod 700 /home/pi/.openclaw
chmod 600 /home/pi/.openclaw/credentials/*

高いメモリ使用量

ゲートウェイがメモリ制限に近づいている場合：

systemctl status openclaw | grep Memory

openclaw.json で maxConcurrentTasks を 1 に減らし、サービスを再起動してください。

サーマルスロットリング

温度を継続的に監視：

vcgencmd measure_temp
# または継続的に監視
watch -n 1 vcgencmd measure_temp

温度が定期的に80度を超える場合、冷却ソリューションをアップグレードしてください。公式アクティブクーラーは持続的な OpenClaw ワークロード中も Pi 5 を60度以下に保ちます。

SD カードの破損

兆候はランダムな読み取りエラーとファイルシステムが読み取り専用になることです：

sudo fsck -y /dev/mmcblk0p2

破損が再発する場合は SSD への投資をお勧めします。信頼性の向上だけでコストが正当化されます。

まとめ

Raspberry Pi 5 は OpenClaw の優秀なプラットフォームです。$100〜$150 の初期ハードウェア投資は、VPS ホスティングと比較して1年以内に元が取れます。重要な判断：8 GB モデルを入手、NVMe SSD を使用、信頼性のために systemd を設定、リモートアクセスに Cloudflare Tunnel または Tailscale を使用。

参考文献

1. Raspberry Pi 5 power consumption measurements - Jeff Geerling
2. Raspberry Pi 5 thermal analysis - Tom's Hardware
3. SD card wear leveling and longevity - Raspberry Pi Documentation
4. OpenClaw documentation - Installation Guide
5. Cloudflare Tunnel documentation
6. Node.js on ARM64 - NodeSource