OpenClaw

OpenClaw を CometAPI に接続する方法: curl または npm でインストールし、~/.openclaw/.env にキーを保存して、OpenAI/Anthropic/Google プロバイダーを設定し、500 以上のモデルを実行します。

CometAPI を OpenClaw のモデルプロバイダーとして使用できます。1 つの API で 500 以上のモデルを利用可能です。このガイドでは、現在のオンボーディングフロー（2026.3.8+）を説明します。

​

前提条件

• Node.js ≥ 22 — nvm 経由の利用を推奨
• 有効な API キーを持つ CometAPI アカウント — こちらから取得

1. CometAPI API キーを取得

   CometAPI コンソールにログインします。Add API Key をクリックし、sk-xxxxx キーをコピーします。

   

   
2. OpenClaw をインストールまたは更新

   推奨 — 公式インストーラーを使用します:

   curl -fsSL https://openclaw.ai/install.sh | bash
   

   または npm 経由でインストールします:

   npm install -g openclaw@latest
   

   次に、セットアップウィザードを一度実行します:

   openclaw onboard --install-daemon
   

   オンボーディング中に CometAPI を手動で設定したい場合は、Model/Auth ステップで Skip を選択します。オンボーディング後、gateway が実行中であることを確認します:

   openclaw gateway status
   openclaw dashboard
   
3. CometAPI キーを保存

   キーを ~/.openclaw/.env に書き込み、設定ファイルにハードコードせずに daemon から利用できるようにします:

   printf 'COMETAPI_KEY=%s\n' 'your-sk-xxxxx-key' >> ~/.openclaw/.env
   chmod 600 ~/.openclaw/.env
   

   すでに shell、service manager、または secrets workflow を通じて COMETAPI_KEY を注入している場合は、この手順はスキップしてください。下記の設定では、変数の設定方法に関係なく $\{COMETAPI_KEY\} を使用します。

4. CometAPI provider を設定

   CometAPI は 4 つの API フォーマット をサポートしています。~/.openclaw/openclaw.json に 1 つ以上の provider ブロックを追加します:

   Provider	API Format	呼び出されるエンドポイント	Base URL
   cometapi-openai	openai-completions	POST /v1/chat/completions	https://api.cometapi.com/v1
   cometapi-openai-responses	openai-responses	POST /v1/responses	https://api.cometapi.com/v1
   cometapi-claude	anthropic-messages	POST /messages	https://api.cometapi.com
   cometapi-google	google-generative-ai	POST /v1beta/...	https://api.cometapi.com/v1beta

   {
     "agents": {
       "defaults": {
         "model": {
           "primary": "cometapi-claude/your-claude-model-id"
         }
       }
     },
     "models": {
       "mode": "merge",
       "providers": {
         "cometapi-openai": {
           "baseUrl": "https://api.cometapi.com/v1",
           "apiKey": "${COMETAPI_KEY}",
           "api": "openai-completions",
           "models": [{ "id": "your-chat-model-id", "name": "OpenAI-compatible text model" }]
         },
         "cometapi-openai-responses": {
           "baseUrl": "https://api.cometapi.com/v1",
           "apiKey": "${COMETAPI_KEY}",
           "api": "openai-responses",
           "models": [{ "id": "your-responses-model-id", "name": "Responses API model" }]
         },
         "cometapi-claude": {
           "baseUrl": "https://api.cometapi.com",
           "apiKey": "${COMETAPI_KEY}",
           "api": "anthropic-messages",
           "models": [{ "id": "your-claude-model-id", "name": "Claude family model" }]
         },
         "cometapi-google": {
           "baseUrl": "https://api.cometapi.com/v1beta",
           "apiKey": "${COMETAPI_KEY}",
           "api": "google-generative-ai",
           "models": [{ "id": "your-gemini-model-id", "name": "Gemini family model" }]
         }
       }
     }
   }
   

   必要な provider だけを残しても構いませんし、4 つすべてを保持して provider/model 参照でフォーマット間のルーティングを行うこともできます。

   各 your-...-model-id プレースホルダーは、provider ブロックに対応する現在の model ID に CometAPI Models ページ から置き換えてください。

   OpenAI Responses API が必要な model には cometapi-openai-responses（api: "openai-responses"）を使用します。従来のチャット補完パス上の model には cometapi-openai（api: "openai-completions"）を使用します。どちらも同じ baseUrl（https://api.cometapi.com/v1）を共有しており、違いは OpenClaw がどの下流エンドポイントを呼び出すかだけです。

   このセットアップでは auth-profiles.json ファイルは 不要 です。provider キーは models.providers.*.apiKey から $\{COMETAPI_KEY\} env var 経由で解決されます。auth-profiles.json が必要なのは、複数キーにまたがるプロファイル単位の認証情報ローテーションを行いたい場合だけです。

5. 再起動して確認

   .env を追加した後、または provider 設定を変更した後は gateway を再起動します:

   openclaw gateway restart
   

   次に、診断を実行します:

   openclaw models status
   openclaw models list --provider cometapi-claude
   openclaw doctor
   

   セットアップが成功すると、次のようになります:

   • openclaw models status で primary model が cometapi-claude/your-claude-model-id に解決され、CometAPI provider に missing-auth 警告が表示されない
   • openclaw models list --provider cometapi-claude で設定済みの model が一覧表示される
   • openclaw doctor で CometAPI provider に関する設定または認証エラーが報告されない

   
6. model を切り替える

   # Set the default model in config
   openclaw models set cometapi-claude/your-claude-model-id
   
   # Switch for the current chat session
   /model cometapi-openai/your-chat-model-id
   /model cometapi-openai-responses/your-responses-model-id
   /model cometapi-claude/your-claude-model-id
   /model cometapi-google/your-gemini-model-id
   

クリーン再インストール（任意）

古い壊れたセットアップを修復する場合は、gateway を停止し、~/.openclaw を削除してから、CometAPI 設定を適用する前にオンボーディングを再実行します:

openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon

これにより、ローカル設定、セッション、ログ、認証状態、workspace がすべて削除されます。その後、手順 3〜5 をもう一度実行してください。