跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Cloudflare AI Gateway 位於 Provider API 前方，讓你新增分析、快取與控制。對於 Anthropic，OpenClaw 會透過你的 Gateway 端點使用 Anthropic Messages API。
屬性值
Providercloudflare-ai-gateway
基礎 URLhttps://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
預設模型cloudflare-ai-gateway/claude-sonnet-4-6
API 金鑰CLOUDFLARE_AI_GATEWAY_API_KEY（你用於透過 Gateway 發出請求的 Provider API 金鑰）
對於透過 Cloudflare AI Gateway 路由的 Anthropic 模型，請使用你的 Anthropic API 金鑰 作為 Provider 金鑰。
為 Anthropic Messages 模型啟用思考時，OpenClaw 會在透過 Cloudflare AI Gateway 傳送承載資料前，移除尾端的 assistant 預填回合。 Anthropic 會拒絕搭配延伸思考的回應預填，而一般 非思考預填仍可使用。

​
開始使用

1

設定 Provider API 金鑰與 Gateway 詳細資料

執行 onboarding 並選擇 Cloudflare AI Gateway 驗證選項：
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
這會提示你輸入帳戶 ID、Gateway ID 與 API 金鑰。
2

設定預設模型

將模型新增至你的 OpenClaw 設定：
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },
    },
  },
}
3

確認模型可用

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 有幫助，除非該環境也已匯入至該處。請在 ~/.openclaw/.env 中設定金鑰，或透過 env.shellEnv 設定，以確保 Gateway 程序能讀取它。

​
相關

模型選擇

選擇 Provider、模型 refs 與容錯移轉行為。

疑難排解

一般疑難排解與常見問題。