Cloudflare AI Gateway はプロバイダー API の前段に配置され、分析、キャッシュ、制御を追加します。Anthropic では、OpenClaw は Gateway エンドポイント経由で Anthropic Messages API を使用します。
| プロパティ | 値 |
|---|
| プロバイダー | cloudflare-ai-gateway |
| Plugin | 公式外部パッケージ (@openclaw/cloudflare-ai-gateway-provider) |
| ベース URL | https://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 キーを使用してください。
Pluginをインストール
公式 Plugin をインストールしてから、Gateway を再起動します。
openclaw plugins install @openclaw/cloudflare-ai-gateway-provider
openclaw gateway restart
はじめに
プロバイダー API キーと Gateway 詳細を設定する
オンボーディングを実行し、Cloudflare AI Gateway 認証オプションを選択します。openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
デフォルトモデルを設定する
OpenClaw 設定にモデルを追加します。{
agents: {
defaults: {
model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },
},
},
}
モデルが利用可能であることを確認する
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 がそのプロセスで利用できることを確認してください。対話型シェルでのみエクスポートされたキーは、その環境もそこにインポートされていない限り、launchd/systemd デーモンでは役に立ちません。Gateway プロセスが読み取れるように、キーを ~/.openclaw/.env または env.shellEnv 経由で設定してください。
モデル選択
プロバイダー、モデル参照、フェイルオーバー動作の選択。
トラブルシューティング
一般的なトラブルシューティングと FAQ。
