使用 Cloudflare AI Gateway 控管你的 AI 請求

開發者最怕的就是 API 成本失控，或者是當你想回溯某個請求卻發現什麼紀錄都沒留。每次都要自己寫快取邏輯或監控工具真的很累，而且還得擔心不同 Provider 之間的 API 管理變得一團亂。

透過 Cloudflare AI Gateway，你可以直接在 Provider API 前面擋一層，輕鬆搞定分析、快取跟流量控制。在 OpenClaw 中，我們會透過你的 Gateway 端點來呼叫 Anthropic Messages API。

需要準備的東西

Cloudflare Account ID
Cloudflare AI Gateway ID
Anthropic API Key

快速開始

只要 5 分鐘，就能把你的 Gateway 設定好：

設定 API 金鑰與 Gateway 資訊 執行以下指令開始設定：
Terminal window
```
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
```

設定預設模型 在你的設定檔中加入模型配置：

{
  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 驗證功能，除了 Provider API 金鑰外，你還需要額外加上 cf-aig-authorization header：

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

疑難排解

環境變數讀取失敗：如果你的 Gateway 是以守護進程（daemon，例如 launchd 或 systemd）方式執行，請確保該程序可以存取到 CLOUDFLARE_AI_GATEWAY_API_KEY。
變數配置建議：你可以將金鑰放在 ~/.openclaw/.env 檔案中，或是透過 env.shellEnv 來確保環境變數正確載入。

設定上有遇到困難嗎？直接問問 AI Setup Assistant 吧！

下一步

OpenClaw Expert

還是卡住了？

如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。