> ## 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 を使う

> base URL、API key、model または provider オプションを設定して、OpenClaw で CometAPI を構成するためのガイドです。

[CometAPI](https://www.cometapi.com) を [OpenClaw](https://openclaw.ai) の model provider として使用します — 1 つの API で 500 以上のモデルを利用できます。

## 前提条件

* Node.js ≥ 22 — [nvm](https://github.com/nvm-sh/nvm) 経由を推奨
* 有効な API key を持つ CometAPI アカウント — [こちらから取得](https://www.cometapi.com/console/token)

## インストール

<Steps>
  <Step title="CometAPI API key を取得する">
    [CometAPI コンソール](https://www.cometapi.com/console/token)にログインします。**Add API Key** をクリックし、CometAPI の API key をコピーします。

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="Add API Key ボタンが表示された CometAPI ダッシュボード" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="base URL が表示された CometAPI API key の詳細" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="OpenClaw をインストールまたは更新する">
    **推奨** — 公式インストーラーを使用します:

    ```bash theme={null}
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```

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

    ```bash theme={null}
    npm install -g openclaw@latest
    ```

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

    ```bash theme={null}
    openclaw onboard --install-daemon
    ```

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

    ```bash theme={null}
    openclaw gateway status
    openclaw dashboard
    ```
  </Step>
</Steps>

## 設定

<Steps>
  <Step title="CometAPI キーを保存する">
    キーを `~/.openclaw/.env` に書き込み、設定ファイルにハードコードしなくてもデーモンから利用できるようにします:

    ```bash theme={null}
    printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> ~/.openclaw/.env
    chmod 600 ~/.openclaw/.env
    ```

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

  <Step title="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` |

    ```json theme={null}
    {
      "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](https://www.cometapi.com/models/) の現在の model ID に置き換えてください。

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

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

## 検証

<Steps>
  <Step title="再起動して確認">
    `.env` を追加した後、または provider 設定を変更した後は、gateway を再起動します:

    ```bash theme={null}
    openclaw gateway restart
    ```

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

    ```bash theme={null}
    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 エラーが報告されない

    <Frame>
      <img src="https://mintcdn.com/cometapi/3HbSFe0pH45ETcjq/images/integrations/810968_371721.png?fit=max&auto=format&n=3HbSFe0pH45ETcjq&q=85&s=928b6faed91c5c2cb2eceea6bfac630d" alt="CometAPI provider が認証済みであることを示す OpenClaw models status" width="1906" height="296" data-path="images/integrations/810968_371721.png" />
    </Frame>
  </Step>
</Steps>

## モデルを切り替える

<Steps>
  <Step title="モデルを切り替える">
    ```bash theme={null}
    # 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
    ```
  </Step>
</Steps>

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

<AccordionGroup>
  <Accordion title="クリーン再インストール（任意）">
    壊れた古いセットアップを修復する場合は、gateway を停止し、`~/.openclaw` を削除してから、CometAPI の設定を適用する前にオンボーディングを再実行してください:

    ```bash theme={null}
    openclaw gateway stop
    rm -rf ~/.openclaw
    openclaw onboard --install-daemon
    ```

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

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/openclaw#howto",
        "name": "CometAPI で OpenClaw を使う",
        "description": "このガイドでは、base URL、API key、および model または provider のオプションを設定して、OpenClaw を CometAPI で構成する方法を説明します。",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-1",
            "position": 1,
            "name": "CometAPI の API key を取得する",
            "text": "CometAPI アカウントを作成または開き、ダッシュボードから有効な API key をコピーします。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-2",
            "position": 2,
            "name": "OpenClaw をインストールまたは更新する",
            "text": "「CometAPI で OpenClaw を使う」ガイドの「OpenClaw をインストールまたは更新する」ステップを完了してください。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-3",
            "position": 3,
            "name": "CometAPI key を保存する",
            "text": "「CometAPI で OpenClaw を使う」ガイドの「CometAPI key を保存する」ステップを完了してください。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-4",
            "position": 4,
            "name": "CometAPI provider を設定する",
            "text": "「CometAPI で OpenClaw を使う」ガイドの「CometAPI provider を設定する」ステップを完了してください。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-5",
            "position": 5,
            "name": "再起動して確認する",
            "text": "「CometAPI で OpenClaw を使う」ガイドの「再起動して確認する」ステップを完了してください。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-6",
            "position": 6,
            "name": "model を切り替える",
            "text": "「CometAPI で OpenClaw を使う」ガイドの「model を切り替える」ステップを完了してください。"
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI ドキュメント",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "連携",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "CometAPI で OpenClaw を使う",
            "item": "https://apidoc.cometapi.com/integrations/openclaw"
          }
        ]
      }
    ]
    }
    `}
</script>