CometAPI で OpenClaw を使う

CometAPI を OpenClaw の model provider として使用します — 1 つの API で 500 以上のモデルを利用できます。

前提条件

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

インストール

CometAPI API key を取得する

CometAPI コンソールにログインします。Add API Key をクリックし、CometAPI の API key をコピーします。

OpenClaw をインストールまたは更新する

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

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

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

npm install -g openclaw@latest

その後、セットアップウィザードを 1 回実行します:

openclaw onboard --install-daemon

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

openclaw gateway status
openclaw dashboard

設定

CometAPI キーを保存する

キーを ~/.openclaw/.env に書き込み、設定ファイルにハードコードしなくてもデーモンから利用できるようにします:

printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env

すでにシェル、サービスマネージャー、または secrets ワークフローを通じて COMETAPI_KEY を注入している場合は、この手順をスキップしてください。変数の設定方法に関係なく、以下の設定では $\{COMETAPI_KEY\} を使用します。

CometAPI プロバイダーを設定する

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

Provider	API Format	Endpoint called	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 ブロックに対応する CometAPI Models page の現在の model ID に置き換えてください。

OpenAI Responses API が必要なモデルには cometapi-openai-responses (api: "openai-responses") を使用してください。従来のチャット補完パス上のモデルには 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 が必要なのは、複数キー間でプロファイルごとの認証情報ローテーションを行いたい場合だけです。

検証

再起動して確認

.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 に関する config または auth エラーが報告されない

CometAPI provider が認証済みであることを示す OpenClaw models status

モデルを切り替える

# 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

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

概要

AIコーディングエージェント

AIエージェント

AIチャットクライアント

翻訳と言語

自動化プラットフォーム

可観測性と評価

AIフレームワーク

前提条件

インストール

設定

検証

モデルを切り替える

トラブルシューティング

​前提条件

​インストール

​設定

​検証

​モデルを切り替える

​トラブルシューティング

前提条件

インストール

設定

検証

モデルを切り替える

トラブルシューティング