Cloudflare AI Gateway を使った AI アプリケーションの管理

AI アプリケーションを開発していると、API の利用状況が把握しきれなかったり、同じようなリクエストを繰り返してコストがかさんだりすることに悩まされることがあります。リクエストの制御やキャッシュの仕組みを自分で一から構築するのは手間がかかりますが、これらを一箇所でまとめて管理できると開発が非常にスムーズになります。

Cloudflare AI Gateway は、プロバイダーの API の前に配置することで、分析、キャッシュ、コントロール機能を簡単に追加できるツールです。OpenClaw では、この Gateway エンドポイントを経由して Anthropic Messages API を利用できます。

必要なもの

設定を始める前に、以下の情報を用意してください。

• Cloudflare の account_id と gateway_id
• Anthropic API キー（CLOUDFLARE_AI_GATEWAY_API_KEY として使用）
• OpenClaw の実行環境

クイックスタート

5 分ほどで設定を完了できます。まずは以下の手順でセットアップを行いましょう。

1. プロバイダーの API キーと Gateway の詳細を設定します。

openclaw onboard --auth-choice cloudflare-ai-gateway-api-key

2. デフォルトで使用するモデルを config.json5 などで設定します。

{
  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"

認証済み Gateway を使用する場合

Cloudflare 側で Gateway 認証を有効にしている場合は、プロバイダーの API キーに加えて cf-aig-authorization ヘッダーを追加する必要があります。

{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer \<cloudflare-ai-gateway-token\>",
        },
      },
    },
  },
}

トラブルシューティング

環境変数の認識

Gateway を launchd や systemd などのデーモンとして実行する場合、CLOUDFLARE_AI_GATEWAY_API_KEY がそのプロセスから参照可能であるか確認してください。例えば、~/.openclaw/.env ファイルに記述するか、env.shellEnv を介して渡す必要があります。

API キーの不一致

Anthropic のモデルを使用する場合は、必ず Anthropic の API キーを CLOUDFLARE_AI_GATEWAY_API_KEY として設定してください。

さらに詳しい設定方法や個別のケースについて知りたい場合は、AI Setup Assistant で質問してみてください。

次のステップ

• OpenClaw Configuration
• Anthropic Provider Details
• Managing API Keys
• Cloudflare AI Gateway Documentation