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ボタン押下
以上
