Providers

Cloudflare AI 閘道

Cloudflare AI Gateway 位於供應商 API 前方,提供分析、快取與控制功能。針對 Anthropic,OpenClaw 會透過您的閘道端點使用 Anthropic Messages API。

屬性
供應商 cloudflare-ai-gateway
外掛 官方外部套件(@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(透過閘道發出請求時使用的供應商 API 金鑰)

為 Anthropic Messages 模型啟用思考功能時,OpenClaw 會先移除尾端的助理預填輪次,再透過 Cloudflare AI Gateway 傳送承載資料。Anthropic 不允許在延伸思考模式下預填回應,但一般非思考模式仍可使用預填功能。

安裝外掛

安裝官方外掛,然後重新啟動閘道:

bash
openclaw plugins install @openclaw/cloudflare-ai-gateway-provideropenclaw gateway restart

開始使用

  • 設定供應商 API 金鑰與閘道詳細資料

    執行初始設定並選擇 Cloudflare AI Gateway 驗證選項:

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

    系統會提示您輸入帳戶 ID、閘道 ID 與 API 金鑰。

  • 設定預設模型

    將模型新增至您的 OpenClaw 設定:

    json5
    {  agents: {    defaults: {      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },    },  },}
  • 確認模型可用

    bash
    openclaw models list --provider cloudflare-ai-gateway
  • 非互動式範例

    若要用於指令碼或 CI 設定,請透過命令列傳入所有值:

    bash
    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 中啟用閘道驗證,請新增 cf-aig-authorization 標頭。這是對供應商 API 金鑰的額外要求

    json5
    {  models: {    providers: {      "cloudflare-ai-gateway": {        headers: {          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",        },      },    },  },}
    環境注意事項

    若閘道以背景服務(launchd/systemd)執行,請確保該程序可存取 CLOUDFLARE_AI_GATEWAY_API_KEY

    相關內容

    Was this useful?
    On this page

    On this page