メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

CometAPI を OpenClaw のモデルプロバイダーとして使用します — 1 つの API で 500 以上のモデルを利用できます。

​
前提条件

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

​
インストール

1

CometAPI API キーを取得する

CometAPI コンソールにログインします。Add API Key をクリックし、$COMETAPI_KEY キーをコピーします。
Add API Key ボタンが表示された CometAPI ダッシュボード
base URL が表示された CometAPI API キーの詳細
2

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

推奨 — 公式インストーラーを使用します:
curl -fsSL https://openclaw.ai/install.sh | bash
または npm 経由でインストールします:
npm install -g openclaw@latest
次に、セットアップウィザードを一度実行します:
openclaw onboard --install-daemon
オンボーディング中に CometAPI を手動で設定したい場合は、Model/Auth ステップで Skip を選択します。オンボーディング後、ゲートウェイが実行中であることを確認します:
openclaw gateway status
openclaw dashboard

​
設定

1

CometAPI キーを保存する

キーを ~/.openclaw/.env に書き込み、設定ファイルにハードコードせずに daemon から利用できるようにします:
printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env
すでにシェル、サービスマネージャー、または secrets ワークフロー経由で COMETAPI_KEY を注入している場合は、この手順をスキップしてください。変数の設定方法に関係なく、以下の設定では $\{COMETAPI_KEY\} を使用します。
2

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

CometAPI は 4 つの API 形式 をサポートしています。~/.openclaw/openclaw.json に 1 つ以上の provider ブロックを追加します:
ProviderAPI 形式呼び出されるエンドポイントBase URL
cometapi-openaiopenai-completionsPOST /v1/chat/completionshttps://api.cometapi.com/v1
cometapi-openai-responsesopenai-responsesPOST /v1/responseshttps://api.cometapi.com/v1
cometapi-claudeanthropic-messagesPOST /messageshttps://api.cometapi.com
cometapi-googlegoogle-generative-aiPOST /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 だけを残すことも、provider/model 参照を使って形式間でルーティングできるように 4 つすべてを残すこともできます。各 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 が必要なのは、複数のキー間でプロファイルごとの認証情報ローテーションを行いたい場合のみです。

​
検証

1

再起動して確認する

.env を追加した後、または provider 設定を変更した後は、ゲートウェイを再起動します:
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 で設定済みモデルが一覧表示される
  • openclaw doctor で CometAPI provider に関する設定または認証エラーが報告されない
CometAPI プロバイダーが認証済みであることを示す OpenClaw models status

​
モデルを切り替える

1

モデルを切り替える

# 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

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

古い壊れたセットアップを修正している場合は、ゲートウェイを停止し、~/.openclaw を削除してから、CometAPI 設定を適用する前にオンボーディングを再実行します:
openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon
これにより、すべてのローカル設定、セッション、ログ、認証状態、ワークスペースが削除されます。その後、手順 3〜5 をもう一度実行してください。