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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

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

Cloudflare AI Gateway はプロバイダー API の前段に配置され、分析、キャッシュ、制御を追加できます。Anthropic の場合、OpenClaw は Gateway エンドポイント経由で Anthropic Messages API を使用します。
プロパティ
プロバイダーcloudflare-ai-gateway
ベース URLhttps://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
デフォルトモデルcloudflare-ai-gateway/claude-sonnet-4-6
APIキーCLOUDFLARE_AI_GATEWAY_API_KEY(Gateway 経由のリクエストに使用するプロバイダー APIキー)
Cloudflare AI Gateway 経由でルーティングされる Anthropic モデルでは、プロバイダーキーとして Anthropic APIキー を使用します。
Anthropic Messages モデルで thinking が有効な場合、OpenClaw は Cloudflare AI Gateway 経由でペイロードを送信する前に、末尾の assistant prefill ターンを取り除きます。Anthropic は extended thinking でのレスポンスの prefilling を拒否しますが、通常の thinking なしの prefill は引き続き利用できます。

はじめに

1

プロバイダー APIキーと Gateway 詳細を設定する

オンボーディングを実行し、Cloudflare AI Gateway の認証オプションを選択します。
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
これにより、アカウント ID、Gateway ID、APIキーの入力が求められます。
2

デフォルトモデルを設定する

OpenClaw 設定にモデルを追加します。
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },
    },
  },
}
3

モデルが利用可能であることを確認する

openclaw models list --provider cloudflare-ai-gateway

非対話型の例

スクリプトや CI のセットアップでは、すべての値をコマンドラインで渡します。
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice cloudflare-ai-gateway-api-key \
  --cloudflare-ai-gateway-account-id "your-account-id" \
  --cloudflare-ai-gateway-gateway-id "your-gateway-id" \
  --cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY"

高度な設定

Cloudflare で Gateway 認証を有効にした場合は、cf-aig-authorization ヘッダーを追加します。これはプロバイダー APIキーに加えて必要です。
{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}
cf-aig-authorization ヘッダーは Cloudflare Gateway 自体に対して認証し、プロバイダー APIキー(たとえば Anthropic キー)はアップストリームのプロバイダーに対して認証します。
Gateway がデーモン(launchd/systemd)として実行されている場合は、CLOUDFLARE_AI_GATEWAY_API_KEY がそのプロセスで利用できるようにしてください。
~/.profile のみに置かれたキーは、その環境もそこへインポートされていない限り、launchd/systemd デーモンには役立ちません。Gateway プロセスが読み取れるように、キーを ~/.openclaw/.env または env.shellEnv 経由で設定してください。

関連

モデル選択

プロバイダー、モデル参照、フェイルオーバー動作の選択。

トラブルシューティング

一般的なトラブルシューティングと FAQ。