Claw-Empire VPSデプロイ手順書

概要

Claw-Empire（AIエージェントオフィスUI）を VPS（162.43.15.17）にデプロイし、https://claw.siruera.com で公開した。

構成

[ブラウザ] → [Caddy (Docker:443)] → [pm2 Node.js (0.0.0.0:8790)]
                                          ↓
                                   /opt/claw-empire/

項目	値
URL	https://claw.siruera.com
サーバー	pm2 + tsx (server/index.ts)
ポート	8790
リバースプロキシ	Docker Caddy (n8n-caddy-1)
SSL	Let’s Encrypt（Caddy自動管理）
認証	API_AUTH_TOKEN（.env）

デプロイ手順

1. ローカルでビルド

cd "c:\ai_work\quartz-site\obsidian valut\claw-empire"
npm run build

2. VPSへ転送

cd "c:\ai_work\quartz-site\obsidian valut\claw-empire"
tar -czf /tmp/claw-deploy.tar.gz dist/ server/ package.json package-lock.json .env
scp /tmp/claw-deploy.tar.gz root@n8n.siruera.com:/tmp/
 
# VPS上で解凍
ssh root@n8n.siruera.com "cd /opt/claw-empire && tar -xzf /tmp/claw-deploy.tar.gz && npm install --production"

3. pm2 再起動

ssh root@n8n.siruera.com "pm2 restart claw-empire --update-env && pm2 save"

設定ファイル

.env (/opt/claw-empire/.env)

PORT=8790
HOST=0.0.0.0
API_AUTH_TOKEN=<設定済み>
ALLOWED_ORIGINS=https://claw.siruera.com

Caddyfile

claw.siruera.com {
  reverse_proxy 172.19.0.1:8790
}

UFW ルール

ufw allow from 172.19.0.0/16 to any port 8790 proto tcp comment 'Caddy Docker to Claw-Empire'

トラブルシューティング

→ 詳細は Claw-Empire_トラブルシューティング記録

症状	原因	対策
502 Bad Gateway	pm2停止 or HOST=127.0.0.1	pm2 restart / HOST=0.0.0.0
403 Forbidden	CORS未設定	ALLOWED_ORIGINS追加
SSL証明書エラー	DNS未反映	DNS設定後Caddy再起動

関連

• Claw-Empire
• VPS運用情報