Cloudflare AI gateway

Cloudflare AI Gateway 位於供應商 API 之前，可讓您新增分析、快取和控制。對於 Anthropic，OpenClaw 會透過您的 Gateway 端點使用 Anthropic Messages API。

屬性	值
提供者	`cloudflare-ai-gateway`
Base 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 金鑰)

當為 Anthropic Messages 模型啟用思考功能時，OpenClaw 會在透過 Cloudflare AI Gateway 發送載荷之前，移除結尾的助手預填輪次。Anthropic 拒絕在擴展思考模式下進行回應預填，而普通的非思考預填仍然可用。

開始使用

設定提供商 API 金鑰和 Gateway 詳細資訊
執行 onboarding 並選擇 Cloudflare AI Gateway 驗證選項：
Terminal window
```
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
```
這將提示您輸入帳戶 ID、gateway ID 和 API 金鑰。

設定預設模型

將模型新增至您的 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"

進階設定

已驗證的 Gateway

如果您在 Cloudflare 中啟用了 Gateway 驗證，請新增 cf-aig-authorization 標頭。這是除了您的提供商 API 金鑰之外的設定。

{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer

”, }, }, }, }, } ```

環境提示

如果 Gateway 作為守護進程 (launchd/systemd) 運行，請確保 CLOUDFLARE_AI_GATEWAY_API_KEY 對該進程可用。