Cloudflare AI Gateway

Cloudflare AI GatewayはプロバイダーAPIの前段に配置され、分析、キャッシュ、アクセス制御を追加できます。Anthropicの場合、OpenClawはGatewayエンドポイント経由でAnthropic Messages APIを使用します。

  • プロバイダー:cloudflare-ai-gateway
  • ベースURL:https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
  • デフォルトモデル:cloudflare-ai-gateway/claude-sonnet-4-5
  • APIキー:CLOUDFLARE_AI_GATEWAY_API_KEY(Gateway経由リクエスト用のプロバイダーAPIキー)

Anthropicモデルの場合はAnthropic APIキーを使用してください。

クイックスタート

  1. プロバイダーAPIキーとGateway情報を設定します:
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
  1. デフォルトモデルを設定します:
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-5" },
    },
  },
}

非対話モードの例

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>",
        },
      },
    },
  },
}

環境に関する注意

Gatewayがデーモン(launchd/systemd)として実行されている場合、CLOUDFLARE_AI_GATEWAY_API_KEYがそのプロセスから利用可能であることを確認してください(例:~/.openclaw/.envenv.shellEnvで設定)。