🚀 OpenClaw / Clawdbot を CodingPlanX カスタムモデルと連携する

本チュートリアルでは、Clawdbot (OpenClaw) のインストールおよびカスタム API 中継サーバー（Proxy）の設定手順をご案内し、GPT-4o、Claude 3.5、Gemini などのモデルを柔軟に呼び出せるようにします。

🛠️ ステップ1：環境の準備と初期化

始める前に、システムに Node.js 環境がインストールされていることを確認してください。

1. Clawdbot のグローバルインストール

ターミナル（CMD または PowerShell）を開き、以下のコマンドを実行します：

npm i -g clawdbot

2. 初期化ウィザードの実行

ウィザードを実行して基本設定を完了させます。画面の指示に従って操作してください：

clawdbot onboard

> [!IMPORTANT] > Windows ユーザーへの注意： ネイティブ環境でシステムが openclaw は内部コマンドではないというエラーを出した場合は、必ず clawdbot コマンドで統一して使用してください。

⚙️ ステップ2：メイン設定ファイル `clawdbot.json` の編集

この手順では、メイン設定ファイルを編集し、中継サーバーの API アドレスとモデルのマッピング関係を定義します。

ファイルパス： C:\Users\あなたのユーザー名\.clawdbot\clawdbot.json (注：元のチュートリアルのパスは Administrator です。実際のユーザー名に合わせて変更してください)

ファイル内の agents、auth、および models セクションを以下の内容を参考に編集してください：

{
  "agents": {
    "defaults": {
      "workspace": "C:\\Users\\Administrator\\clawd",
      "models": {
        "api-proxy-gpt/gpt-4o": { "alias": "GPT-4o" },
        "api-proxy-claude/claude-sonnet-4-5-20250929": { "alias": "Claude Sonnet 4.5" },
        "api-proxy-google/gemini-3-pro-preview": { "alias": "Gemini 3 Pro" }
      },
      "model": {
        "primary": "api-proxy-claude/claude-sonnet-4-5-20250929"
      }
    }
  },
  "auth": {
    "profiles": {
      "api-proxy-gpt:default": { "provider": "api-proxy-gpt", "mode": "api_key" },
      "api-proxy-claude:default": { "provider": "api-proxy-claude", "mode": "api_key" },
      "api-proxy-google:default": { "provider": "api-proxy-google", "mode": "api_key" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "api-proxy-gpt": {
        "baseUrl": "https://api.codingplanx.ai/v1",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-4o", "name": "GPT-4o", "contextWindow": 128000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-claude": {
        "baseUrl": "https://api.codingplanx.ai",
        "api": "anthropic-messages",
        "models": [
          { "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5", "contextWindow": 200000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-google": {
        "baseUrl": "https://api.codingplanx.ai/v1beta",
        "api": "google-generative-ai",
        "models": [
          { "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro", "contextWindow": 2000000, "maxTokens": 8192 }
        ]
      }
    }
  }
}

🔑 ステップ3：認証ファイル `auth-profiles.json` の設定

この手順では、中継サーバーから取得した実際の API Key を入力する必要があります。

ファイルパス： C:\Users\あなたのユーザー名\.clawdbot\agents\main\agent\auth-profiles.json

key フィールドをあなた自身の API キーに変更してください：

{
  "version": 1,
  "profiles": {
    "api-proxy-gpt:default": {
      "type": "api_key",
      "provider": "api-proxy-gpt",
      "key": "sk-あなたの実際のGPTキー"
    },
    "api-proxy-claude:default": {
      "type": "api_key",
      "provider": "api-proxy-claude",
      "key": "sk-あなたの実際のClaudeキー"
    },
    "api-proxy-google:default": {
      "type": "api_key",
      "provider": "api-proxy-google",
      "key": "sk-あなたの実際のGoogleキー"
    }
  },
  "lastGood": {
    "api-proxy-gpt": "api-proxy-gpt:default",
    "api-proxy-claude": "api-proxy-claude:default",
    "api-proxy-google": "api-proxy-google:default"
  }
}

🚦 ステップ4：サービスの確認と起動

設定が完了したら、以下の手順で確認と実行を行います。

1. ヘルスチェックの実行

設定の構文と接続性が正常か確認します：

clawdbot doctor

2. Gateway サービスの起動

ゲートウェイサービスを実行して AI エージェントを起動します：

clawdbot gateway

3. Web コンソールへのアクセス

ブラウザを開き、以下にアクセスします：http://127.0.0.1:18789/
ログイン認証： ステップ1で clawdbot onboard を実行した最後に表示された Token を使用してログインします。
これで、AI エージェントを調整して使用する準備が整いました！

💡 ヒント： 中継サーバーのプロバイダーを変更した場合は、clawdbot.json の対応する baseUrl を変更し、auth-profiles.json の key を更新するだけでOKです。