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

​
Cloudflare AI Gateway

Cloudflare AI Gateway は provider API の前段に配置され、分析、キャッシュ、制御を追加できます。Anthropic については、OpenClaw は Gateway エンドポイントを通じて Anthropic Messages API を使用します。
PropertyValue
Providercloudflare-ai-gateway
Base URLhttps://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
Default modelcloudflare-ai-gateway/claude-sonnet-4-5
API keyCLOUDFLARE_AI_GATEWAY_API_KEY（Gateway 経由のリクエストに使う provider API キー）
Cloudflare AI Gateway 経由でルーティングされる Anthropic モデルでは、provider キーとして Anthropic API キー を使用してください。

​
はじめに

1

Set the provider API key and Gateway details

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

Set a default model

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

Verify the model is available

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 ヘッダーを追加してください。これは provider API キーに加えて必要です。
{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}
cf-aig-authorization ヘッダーは Cloudflare Gateway 自体を認証し、provider API キー（たとえば Anthropic キー）は上流 provider を認証します。
Gateway が daemon（launchd/systemd）として実行される場合は、CLOUDFLARE_AI_GATEWAY_API_KEY がそのプロセスから利用可能であることを確認してください。
~/.profile にだけ置かれたキーは、その環境がそこにも取り込まれていない限り、launchd/systemd daemon には役立ちません。gateway プロセスが読み取れるように、キーを ~/.openclaw/.env または env.shellEnv で設定してください。

​
関連

Model selection

provider、model ref、フェイルオーバー動作の選び方。

Troubleshooting

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