CometAPI で OpenClaw を使用する

このガイドを使用して OpenClaw を CometAPI に接続します。最初の設定では、 API 形式とモデル ID を 1 つ選択してください。

OpenClaw v2026.8.1 は OpenClaw 2.0 としてもブランド化されています。このパッケージでは 2.x のバージョン番号を使用しません。次を参照してください： OpenClaw 2.0 の発表および v2026.8.1 リリースノート.

OpenClaw の公式リファレンス：

前提条件

Node.js 22.22.3+、24.15+、または 25.9+。Node 26 を推奨します。Node 23 はサポートされていません。
有効な API キーを持つ CometAPI アカウント（API キーは次のダッシュボード.
次のページにあるモデル ID： CometAPI Models ページ.

インストールとアップグレード

初回インストール
インストールをアップグレードする

公式インストーラーを使用すると、オンボーディングを開始せずに CLI をインストールできます。これにより、モデル設定を別の手順として行えます。

macOS / Linux / WSL2
Windows PowerShell

次のコマンドで公式インストーラーを実行します：

curl -fsSL https://openclaw.ai/install.sh \
  | bash -s -- --no-onboard

次のコマンドで公式 PowerShell インストーラーを実行します：

& ([scriptblock]::Create(
  (iwr -useb https://openclaw.ai/install.ps1)
)) -NoOnboard

Node.js と npm を自分で管理している場合、npm 11.16+ および npm 12 ではこの --allow-scripts オプションを使用できます。次のコマンドは、OpenClaw をオンボーディングを開始せずにインストールします：

npm install -g openclaw@latest --allow-scripts=openclaw

npm 11.15 以前では、その npm バージョンはこのオプションを認識しないため、--allow-scripts=openclaw を省略してください。バージョンはこのオプションを認識しません。インストールされた CLI が、このガイドで必要な最小バージョンを満たしていることを確認してください：

openclaw --version

次に進みます： CometAPI を設定する。通常のオンボーディングを先に実行しないでください。ガイド付きフローでは、すべてのカスタム API アダプターが表示されないためです。

大規模な更新の前に、バックアップを作成して検証してください。アーカイブには API キー、チャネルの状態、認証データが含まれる可能性があるため、】【s0048 OpenClaw の状態ディレクトリと同様に保護してください。次のコマンドでバックアップを作成し、OpenClaw を更新します：

mkdir -p ~/Backups/openclaw
openclaw backup create --output ~/Backups/openclaw --verify
openclaw update

更新後、サポートされている移行を修復し、Gateway の健全性を確認してください：

openclaw doctor --fix
openclaw gateway restart
openclaw health

更新によって設定済みのモデルルートは維持されます。オンボーディングを繰り返さないでくださいモデルプロバイダーまたはその認証を変更する場合を除きます。

CometAPI を構成する

従来のオンボーディングを使用する

従来のオンボーディングは、チャット補完、レスポンス、Anthropic メッセージの初回インストールに推奨される方法です。次のコマンドで従来のオンボーディングを開き、バックグラウンドサービスをインストールします:

openclaw onboard --classic --install-daemon

で、 モデル/認証から カスタムプロバイダーを選択します。次に、次のいずれかの互換性オプションの値を入力します:

API 形式	プロバイダー ID	互換性オプション	ベース URL
チャット補完	`cometapi-openai`	OpenAI 互換	`https://api.cometapi.com/v1`
レスポンス	`cometapi-openai-responses`	OpenAI レスポンス互換	`https://api.cometapi.com/v1`
Anthropic メッセージ	`cometapi-claude`	Anthropic 互換	`https://api.cometapi.com`

プロンプトが表示されたら、一致するプロバイダー ID、your-model-id、および CometAPI API キーを入力します。ターミナルウィザードでは、API キーの入力内容はマスクされます。従来のカスタムプロバイダーメニューには、Google Generative AI アダプターは含まれていません。このアダプターを使用するには、構成コマンドでプロバイダーを構成する, を完了し、プライマリモデルを設定してから従来のオンボーディングを実行します。そのオプションがウィザードに表示されたら、 既存のモデル設定 を選択します。

構成コマンドでプロバイダーを構成する

Google アダプターを使用する場合や、制御された構成変更を行う場合は、この方法を使用します。 OpenClaw は JSON5 をサポートしているため、openclaw.json を厳密な JSON ツールで解析して書き換えないでください。厳密な JSON ツールは使用しないでください。

OpenClaw のネイティブ構成ライターは JSON5 を検証しますが、書き込み時にファイルを JSON に正規化します。既存のコメント、末尾のカンマ、書式設定は削除される場合があります。これらの詳細が重要な場合は、パッチを適用する前に検証済みのバックアップを作成してください。重要な場合は、パッチを適用する前に検証済みのバックアップを作成してください。

まず、アクティブな構成パスを出力し、その内容を検証します:

openclaw config file
openclaw config validate

OpenClaw は、プロバイダー API キーをプロセス環境またはグローバル状態の .env ファイルから読み取ります。プロバイダー API キーについては、ワークスペースの .env ファイルを信頼しません。グローバルファイルは ~/.openclaw/.env です。あるいは、 $OPENCLAW_STATE_DIR/.env OPENCLAW_STATE_DIR が設定されている場合は、従来のオンボーディングで API キーを保存した場合は、次の手順を省略します。そうでない場合は、 API キーを表示せずに保存するには、お使いのオペレーティングシステムのタブを使用します。 API キーを表示せずに保存します。

macOS / Linux / WSL2
Windows PowerShell

次のコマンドは COMETAPI_KEY をアトミックに更新し、空の値を拒否します:

state_dir="${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
install -d -m 700 "$state_dir"
read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
if [ -z "$COMETAPI_KEY" ]; then
  echo "The CometAPI API key cannot be empty." >&2
  unset COMETAPI_KEY
  exit 1
fi
umask 077
env_file="$state_dir/.env"
temp_file="$(mktemp "${env_file}.XXXXXX")"
if [ -f "$env_file" ]; then
  awk -F= '$1 != "COMETAPI_KEY"' "$env_file" > "$temp_file"
fi
printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> "$temp_file"
chmod 600 "$temp_file"
mv "$temp_file" "$env_file"
unset COMETAPI_KEY temp_file env_file state_dir

次のコマンドは、表示せずに COMETAPI_KEY を更新します:

$stateDir = if ($env:OPENCLAW_STATE_DIR) {
  $env:OPENCLAW_STATE_DIR
} else {
  Join-Path $HOME ".openclaw"
}
New-Item -ItemType Directory -Force -Path $stateDir | Out-Null
$secureKey = Read-Host "CometAPI API key" -AsSecureString
$plainKey = [Net.NetworkCredential]::new("", $secureKey).Password
if ([string]::IsNullOrWhiteSpace($plainKey)) {
  throw "The CometAPI API key cannot be empty."
}
$envFile = Join-Path $stateDir ".env"
$lines = @()
if (Test-Path $envFile) {
  $lines = @(Get-Content $envFile | Where-Object {
    $_ -notmatch '^COMETAPI_KEY='
  })
}
$lines += "COMETAPI_KEY=$plainKey"
$tempFile = Join-Path $stateDir ".$([guid]::NewGuid()).tmp"
[IO.File]::WriteAllLines($tempFile, $lines)
Move-Item -Force $tempFile $envFile
$plainKey = $null
$secureKey = $null

プロバイダーを追加する前に、そのターゲットパスを確認します。次のコマンドのプロバイダー ID を、選択したタブの ID に置き換えます:

openclaw config get models.providers.cometapi-openai --json

コマンドが構成済みのプロバイダーを返した場合は、例を適用せずに停止してください。 config patch オブジェクトはマージされますが、配列は置き換えられます。新しいモデルを配列を書き込む前に、プロバイダーのモデル配列にマージしてください。これによりモデルのメタデータ、カスタムヘッダー、その他のプロバイダー設定が保持されます。 API 形式を 1 つ選択します。各パッチは環境変数をバックエンドとする SecretRef を使用し、対象の構成パスのみを変更し、他の構成セクションはそのまま保持します。

モデル ID がすべての API アダプターと自動的に互換になるわけではありません。正確な CometAPI モデルとルートがサポートするアダプターを選択し、ライブリクエストでそのプロバイダー、モデル、アダプターの組み合わせを検証してください。以下の your-model-id 値は構成用プレースホルダーであり、汎用的な互換性を示すものではありません。

チャット補完
レスポンス
Anthropic メッセージ
Google Generative AI

プロバイダー ID: cometapi-openai
OpenClaw アダプター: openai-completions
ベース URL: https://api.cometapi.com/v1
プライマリモデル参照: cometapi-openai/your-model-id

このプロバイダーパッチを含む cometapi.patch.json5 を作成します:

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-openai": {
        baseUrl: "https://api.cometapi.com/v1",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "openai-completions",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

OpenClaw が構成を書き込む前にパッチを検証します:

openclaw config patch --file ./cometapi.patch.json5 --dry-run

検証が成功した場合は、同じパッチを適用します:

openclaw config patch --file ./cometapi.patch.json5

プライマリモデルが構成されていない場合は、このモデルをデフォルトとして設定します:

openclaw models set cometapi-openai/your-model-id

プロバイダー構成を検証し、最小限のモデルリクエストを送信します:

openclaw models list --provider cometapi-openai
openclaw models status --probe \
  --probe-provider cometapi-openai
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-openai/your-model-id \
  --thinking off \
  --json

アクティブな OpenClaw チャットセッションを切り替えるには、次のチャットコマンドを実行します:

/model cometapi-openai/your-model-id

プロバイダー ID: cometapi-openai-responses
OpenClaw アダプター: openai-responses
ベース URL: https://api.cometapi.com/v1
プライマリモデル参照: cometapi-openai-responses/your-model-id

このプロバイダーパッチを含む cometapi.patch.json5 を作成します:

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-openai-responses": {
        baseUrl: "https://api.cometapi.com/v1",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "openai-responses",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

OpenClaw が構成を書き込む前にパッチを検証します:

openclaw config patch --file ./cometapi.patch.json5 --dry-run

検証が成功した場合は、同じパッチを適用します:

openclaw config patch --file ./cometapi.patch.json5

プライマリモデルが構成されていない場合は、このモデルをデフォルトとして設定します:

openclaw models set cometapi-openai-responses/your-model-id

プロバイダー構成を検証し、最小限のモデルリクエストを送信します:

openclaw models list --provider cometapi-openai-responses
openclaw models status --probe \
  --probe-provider cometapi-openai-responses
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-openai-responses/your-model-id \
  --thinking off \
  --json

アクティブな OpenClaw チャットセッションを切り替えるには、次のチャットコマンドを実行します:

/model cometapi-openai-responses/your-model-id

プロバイダー ID: cometapi-claude
OpenClaw アダプター: anthropic-messages
ベース URL: https://api.cometapi.com
プライマリモデル参照: cometapi-claude/your-model-id

このプロバイダーパッチを含む cometapi.patch.json5 を作成します:

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-claude": {
        baseUrl: "https://api.cometapi.com",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "anthropic-messages",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

OpenClaw が構成を書き込む前にパッチを検証します:

openclaw config patch --file ./cometapi.patch.json5 --dry-run

検証が成功した場合は、同じパッチを適用します:

openclaw config patch --file ./cometapi.patch.json5

プライマリモデルが構成されていない場合は、このモデルをデフォルトとして設定します:

openclaw models set cometapi-claude/your-model-id

プロバイダー構成を検証し、最小限のモデルリクエストを送信します:

openclaw models list --provider cometapi-claude
openclaw models status --probe \
  --probe-provider cometapi-claude
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-claude/your-model-id \
  --thinking off \
  --json

アクティブな OpenClaw チャットセッションを切り替えるには、次のチャットコマンドを実行します:

/model cometapi-claude/your-model-id

プロバイダー ID: cometapi-google
OpenClaw アダプター: google-generative-ai
ベース URL: https://api.cometapi.com/v1beta
プライマリモデル参照: cometapi-google/your-model-id

このプロバイダーパッチを含む cometapi.patch.json5 を作成します:

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-google": {
        baseUrl: "https://api.cometapi.com/v1beta",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "google-generative-ai",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

OpenClaw が構成を書き込む前にパッチを検証します:

openclaw config patch --file ./cometapi.patch.json5 --dry-run

検証が成功した場合は、同じパッチを適用します:

openclaw config patch --file ./cometapi.patch.json5

プライマリモデルが構成されていない場合は、このモデルをデフォルトとして設定します:

openclaw models set cometapi-google/your-model-id

プロバイダー構成を検証し、最小限のモデルリクエストを送信します:

openclaw models list --provider cometapi-google
openclaw models status --probe \
  --probe-provider cometapi-google
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-google/your-model-id \
  --thinking off \
  --json

アクティブな OpenClaw チャットセッションを切り替えるには、次のチャットコマンドを実行します:

/model cometapi-google/your-model-id

構成ですでに cometapi-gemini プロバイダー ID が使用されている場合は、その ID を維持し、モデル参照とコマンドで使用してください。名前を変更したり、このガイドに合わせるためだけに重複するプロバイダーを作成したりしないでください。

4 種類の CometAPI プロバイダー形式を含む OpenClaw 2026.8.1 モデルリスト

新しいプロバイダーでは、openclaw config set により同じスキーマと SecretRef チェックが提供されます。書き込み前に --strict-json、--merge、および --dry-run を使用します。次の代替方法では、チャット補完プロバイダーをプレビューします:

openclaw config set models.providers.cometapi-openai \
  '{
    "baseUrl": "https://api.cometapi.com/v1",
    "apiKey": {
      "source": "env",
      "provider": "default",
      "id": "COMETAPI_KEY"
    },
    "api": "openai-completions",
    "models": [
      {
        "id": "your-model-id",
        "name": "CometAPI model",
        "input": ["text"]
      }
    ]
  }' \
  --strict-json --merge --dry-run

ドライランが成功した場合は、保存するために --dry-run を付けずにコマンドを繰り返します。この例を構成済みのプロバイダーに適用しないでください。書き込み前に、models 配列にはプロバイダーの完全にマージされたモデルリストを含める必要があります。

モデルメタデータを理解する

最小限のパッチではテキスト専用モデルを宣言します。オプションのメタデータは、モデルの仕様を検証した場合にのみ追加してください:

フィールド	効果
`input`	受け付ける入力モダリティを宣言します。モデルがネイティブ画像入力を受け付ける場合にのみ `["text", "image"]` を使用してください。
`contextWindow`	モデル本来のコンテキストウィンドウ（Context Window）容量を記録します。
`contextTokens`	変更せずに、アクティブな入力予算を制限します。 `contextWindow`.
`maxTokens`	OpenClaw がモデルに要求する出力トークン（Token）を制限します。

不正な値により、サポートされている入力が非表示になったり、使用可能なコンテキストが過大に示されたり、サポートされていない出力サイズが要求されたりする可能性があります。再利用可能な例では your-model-id を維持し、次の CometAPI モデルページでモデル ID を選択してください。

完全なセットアップを確認する

config またはグローバル .env ファイルを変更した後、Gateway を再起動します：

openclaw gateway restart

次に、config と Gateway の状態を検証します：

openclaw config validate
openclaw doctor
openclaw health

選択した API 形式タブから、プロバイダー固有のコマンドを実行します。モデル一覧またはステータス確認では、構成のみを確認できます。openclaw agent exec コマンドは実際のモデルリクエストを送信します。OPENCLAW_OK が返されることを確認し、未解決の認証、アダプター、またはモデルエラーがないことを確認してください。OpenClaw がリクエストを再試行する場合は、すべての試行を記録して調査し、最終マーカーを単一試行の成功とみなさないでください。

トラブルシューティング

API キーがない

COMETAPI_KEY がプロセス環境またはグローバル状態の .env ファイルに存在することを確認してください。値をターミナル出力に表示しないでください。信頼できるキーソースを修正した後、Gateway を再起動して確認します：

openclaw gateway restart
openclaw health

プロバイダー ID の設定が異なる

baseUrl、api、カスタムヘッダー、またはモデルメタデータが異なるプロバイダーを上書きしないでください。まず対象のプロバイダーを調べます：

openclaw config get models.providers.cometapi-openai --json
openclaw config validate

両方の構成が意図したものである場合は、別のプロバイダー ID を使用してください。差異が偶発的なものである場合は、対象のプロバイダーを変更する前に検証済みのバックアップを作成してください。対象のプロバイダーを変更してください。

更新が完了しなかった

インストールを修復する前に、更新状態を調べます：

openclaw update status --json
openclaw update repair
openclaw doctor --fix
openclaw health

これらのコマンドは状態ディレクトリを保持します。

コードのロールバックが必要である

状態ディレクトリを保持したまま、既知のパッケージバージョンを再インストールします。まず、操作をプレビューします：

openclaw update --tag 2026.8.1 --dry-run

プレビューが正しければ、--dry-run なしで同じ操作を実行します：

openclaw update --tag 2026.8.1
openclaw doctor --fix
openclaw health

インストール済みのコードが状態を読み取れない場合にのみ、状態バックアップを復元してください。状態を復元すると、バックアップ後に作成されたセッションおよび構成変更が破棄される可能性があります。

概要

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

AIエージェント

AIチャットクライアント

翻訳と言語

自動化プラットフォーム

可観測性と評価

AIフレームワーク

前提条件

インストールとアップグレード

CometAPI を構成する

従来のオンボーディングを使用する

構成コマンドでプロバイダーを構成する

モデルメタデータを理解する

完全なセットアップを確認する

トラブルシューティング

​前提条件

​インストールとアップグレード

​CometAPI を構成する

​従来のオンボーディングを使用する

​構成コマンドでプロバイダーを構成する

​モデルメタデータを理解する

​完全なセットアップを確認する

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

前提条件

インストールとアップグレード

CometAPI を構成する

従来のオンボーディングを使用する

構成コマンドでプロバイダーを構成する

モデルメタデータを理解する

完全なセットアップを確認する

トラブルシューティング