OPENCLAW on Umbrel Home セットアップガイド

ichinaka

2026-02-20T10:28:07Z

claude に聞きながらやった内容をまとめてもらっただけの記事（精査してないので悪しからず）

前提条件

Umbrel Home が稼働中
SSH でアクセスできる状態 ssh umbrel@umbrel.local
OPENCLAW が Umbrel App Store からインストール済み

ステップ 1: OpenRouter のアカウントとAPIキーを取得する

https://openrouter.ai でアカウント作成（クレジットカード不要）
https://openrouter.ai/settings/keys で 「Create Key」 をクリック
APIキーをコピーして安全な場所に保管する

注意: APIキーは絶対にチャットやターミナルの出力として他人に見せないでください。漏れた場合はすぐに無効化して新しいキーを発行してください。

ステップ 2: openclaw.json を設定する

SSH でUmbrelにログインして以下を実行してください（ここにAPIキー の部分を置き換えること）:

cat > ~/umbrel/app-data/openclaw/data/.openclaw/openclaw.json << 'EOF'
{
  "browser": {
    "headless": true,
    "noSandbox": true,
    "defaultProfile": "openclaw"
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "openrouter/openrouter/free"
      }
    }
  },
  "gateway": {
    "mode": "local",
    "bind": "lan",
    "controlUi": {
      "allowInsecureAuth": true
    },
    "auth": {
      "mode": "token",
      "token": "09bbd09369b3d111f02f24c356508f1234344d57c89555f89f62cc37c1f8a93b"
    },
    "trustedProxies": [
      "127.0.0.1",
      "::1",
      "172.16.0.0/12",
      "192.168.0.0/16",
      "10.0.0.0/8"
    ]
  },
  "models": {
    "providers": {
      "openrouter": {
        "apiKey": "ここにAPIキー",
        "baseUrl": "https://openrouter.ai/api/v1",
        "api": "openai-completions",
        "models": [
          { "id": "openrouter/free", "name": "OpenRouter Free Auto" }
        ]
      }
    }
  }
}
EOF

ステップ 3: コンテナを再起動する

sudo docker restart openclaw_gateway_1

30秒ほど待ってから Umbrel の OPENCLAW アプリを開いてください。

ステップ 4: 動作確認

ブラウザで OPENCLAW のチャット画面を開いて hey などメッセージを送ってみてください。返信が来れば成功です。

返信が来ない場合はログを確認してください：

sudo docker logs openclaw_gateway_1 2>&1 | tail -20

モデルの選択肢

無料で使う場合（推奨）

モデルID 特徴 openrouter/openrouter/free ツール対応モデルを自動選択。最もお手軽 openrouter/arcee-ai/trinity-large-preview:free エージェント用途に最適化。安定動作 openrouter/mistralai/mistral-small-3.1-24b-instruct:free 高性能だが混雑時に429エラーが出ることがある

モデルを変える場合は openclaw.json の以下の2箇所を変更して再起動してください：

"primary": "openrouter/モデルID"
...
"models": [
  { "id": "モデルID（openrouter/を除く）", "name": "任意の名前" }
]

有料で高品質を求める場合

OpenRouter に $10 クレジットを追加すると Claude 3 Haiku などの有料モデルが使えます。無料枠より安定して動作し、1日1000リクエストまで使えます。

トラブルシューティング

chatで返信が来ない

# セッションログを確認
sudo docker exec openclaw_gateway_1 tail -3 \
  /data/.openclaw/agents/main/sessions/$(ls /data/.openclaw/agents/main/sessions/ | tail -1)

よくあるエラーと対処法：

エラー原因対処 400 status code (no body) APIキーが無効 or クォータゼロ新しいAPIキーを発行 404 No endpoints found that support tool use モデルがツール非対応別のモデルに変更 429 rate-limited upstream 一時的な混雑しばらく待つか別モデルに変更 402 spend limit exceeded APIキーの上限に達した OpenRouterでキー設定を確認 No API provider registered for api: undefined "api" フィールドが欠落 "api": "openai-completions" を追加

起動しない（JSONエラー）

sudo docker logs openclaw_gateway_1 2>&1 | tail -10

JSON構文エラーの場合は openclaw.json をステップ2のコマンドで書き直してください。

ポートに接続できない

bind: lan の設定でゲートウェイが 0.0.0.0 でリッスンしていることが必要です。以下で確認できます：

sudo docker exec openclaw_gateway_1 cat /proc/net/tcp

00000000:4966 のエントリがあれば正常です（7F000001 の場合は loopback のみでNG）。

重要な設定ファイルの場所

用途パスメイン設定ファイル ~/umbrel/app-data/openclaw/data/.openclaw/openclaw.json ログファイルコンテナ内 /tmp/openclaw/openclaw-YYYY-MM-DD.log セッション履歴コンテナ内 /data/.openclaw/agents/main/sessions/