Claw EmpireをRaspberry Pi 5にセットアップする

1.前提条件

• Raspberry Pi 5にRaspberry Pi OS(21 Apr 2026)がインストールされていること
• Raspberry Pi 5にRaspberry Pi OSをインストールし、SSHでアクセスできる状態にしておくこと
• Raspberry Pi 5がインターネットに接続されていること
• 以下のアカウントを用意しておくこと（無料で作成可能）：
• Claude Pro以上
• OpenCode Go
• GitHub アカウント
• GitHub OAuth (Settings -> Developer settings -> OAuth Apps) で新規OAuth Appを作成し、Client IDとClient Secretをメモしておくこと
• Google アカウント（Gemini CLI用）

2. セットアップ手順

Step 1: Raspberry Pi OSの更新

SSHでRaspberry Pi 5に接続し、以下のコマンドを実行してOSを最新状態に更新する：
sudo apt-get update
sudo apt-get upgrade -y
# nvm/node 24 LTSのインストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
\. "$HOME/.nvm/nvm.sh"
nvm install 24
# 出力文字列はOAUTH_ENCRYPTION_SECRETに使用する
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
# IPアドレスをメモしておく
ip a

Step 2: Dockerのインストール

以下のコマンドを実行してDockerをインストールする：

sudo apt-get install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt-get update -y

sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

sudo systemctl enable docker
sudo usermod -aG docker $USER
sudo systemctl restart docker
sudo systemctl status docker
sudo reboot

Step 3: Claw Empireのクローンとビルド

Raspberry Pi 5に再度SSH接続し、以下のコマンドを実行してClaw Empireのリポジトリをクローンし、Dockerイメージをビルドする：

mkdir -p ~/projects
cd ~/projects
git clone https://github.com/GreenSheep01201/claw-empire.git
cd claw-empire
git submodule update --init --recursive

Step 4: .env.docker/.env.docker.privateファイルの作成

プロジェクトルートに `.env.docker` ファイルを作成する：

cd ~/projects/claw-empire
cp .env.example .env.docker
vi .env.docker

`.env.docker` ファイルの以下の箇所をコメントアウトして編集する：

:
HOST=＜Step1でメモしたIPアドレス＞
:
ALLOWED_ORIGINS="http://<Step1でメモしたIPアドレス>:8790,https://localhost:8790,http://127.0.0.1:8790"
ALLOWED_ORIGIN_SUFFIXES=".groq.com,.moonshot.ai"
:

プロジェクトルートに `.env.docker.private` ファイルを作成する：

cd ~/projects/claw-empire
vi .env.docker.private

`.env.docker.private` ファイルの以下の箇所を編集する：

OAUTH_ENCRYPTION_SECRET=＜Step 1で生成した文字列＞
API_AUTH_TOKEN="Geheim" # 任意の文字列でOK。APIリクエストの認証に使用される。
OAUTH_GITHUB_CLIENT_ID=＜GitHub OAuth AppのClient ID＞
OAUTH_GITHUB_CLIENT_SECRET=＜GitHub OAuth AppのClient Secret＞
INBOX_WEBHOOK_SECRET=<任意の文字列>
## Anthropic Alt kimi APIキー
ANTHROPIC_BASE_URL=https://api.moonshot.ai/anthropic
ANTHROPIC_API_KEY=sk-...

Step 5: Docker Composeを使用してClaw Empireを起動

cd ~/projects/claw-empire
docker compose build
docker compose up -d
docker compose logs -f # エラーがないことを確認したらCtrl+Cでログのフォローを終了

GitHub Copilot CLI/KimiCode CLIを使用する場合

# GitHub Copilot CLI
docker compose exec --user root claw-empire npm install -g @github/copilot
# KimiCode CLI
#docker compose exec --user root claw-empire curl -L code.kimi.com/install.sh | bash

Step 6: コード生成ツールの認証

以下のコマンドを実行して、各コード生成ツールの認証を行う：

docker compose exec claw-empire bash

Claude CodeのOAuth認証

    `claude`コマンドを実行しサブスクを選択、表示されたURLをコピーしPCのブラウザでアクセスしてClaude.aiにログインし、Authorizeをクリックして認証を完了させる

OpenCode GoのAPIキー設定

• `opencode`コマンドを実行し、`/models`を選択
• Ctrl+a
• OpenCode Go
• APIキー設定を選択
• 適当なモデルを選択

Gemni CLIのOAuth認証

`gemini`コマンドを実行しサブスクを選択、表示されたURLをコピーしPCのブラウザでアクセスしてGoogleアカウントでログインし、Authorizeをクリックして認証を完了させる

Codex CLIのOAuth認証

• `codex`コマンドを実行
• デバイス認証を選択
• PCのブラウザで指定のURLを開き、表示されたコードを入力して認証を完了させる
• Raspberry Pi上に表示されたコードを入力

GitHub Copilot CLIのOAuth認証

`copilot`コマンドを実行し、`/login`を選択、GitHub.comを選択し、指示されたURLをPCのブラウザで開いてGitHubアカウントでログインし、コードを入力して認証を完了させる

3. 動作確認

同一セグメントのPCからブラウザを起動し、以下のURLにアクセスしてClaw EmpireのWebUIが表示されることを確認する：

• http://＜Step1でメモしたIPアドレス＞:8790

3.1 日本語指定

• Settings
• Japaneseを選択しSaveボタン押下

以上