使用 Vercel AI Gateway 統一管理你的 AI 模型

以前我開發 AI 應用的時候，最痛苦的就是要管理一堆不同廠商的 API Key。一下要處理 Anthropic 的格式，一下又要去翻 OpenAI 的文件，程式碼裡面塞滿了各種判斷邏輯。後來我發現 Vercel AI Gateway 真的救了我，它把這些雜事都整合在一個 Endpoint，讓開發流程變得超級乾淨。

如果你也跟我一樣，不想要為了換個模型就重寫一半的代碼，直接用 Vercel AI Gateway 是最聰明的選擇。它相容 Anthropic Messages API，這代表你可以無縫切換各種模型，省下大把時間。

需要準備的東西

在開始之前，請確保你已經準備好以下東西：

• Vercel 帳號並取得 AI_GATEWAY_API_KEY
• 已經安裝好的 openclaw 環境

快速開始

只要 5 分鐘，你就能把 Gateway 跑起來。跟著下面這兩個步驟做：

1. 設定 API Key

最簡單的方法是直接執行 onboard 指令，然後貼上你的 Key。我建議直接把金鑰存在 Gateway 裡面，這樣最省事：

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

2. 設定預設模型

接著，打開你的設定檔，把預設模型指向 Vercel AI Gateway。這裡我推薦先用 Claude 系列來測試：

{
  agents: {
    defaults: {
      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
    },
  },
}

如果你是在自動化腳本或 CI/CD 環境中使用，可以用非互動模式（Non-interactive）直接完成設定：

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"

疑難排解

如果你發現 API 呼叫失敗，通常是以下兩個原因：

• 環境變數抓不到：如果你是把 Gateway 當成背景程式（Daemon，例如用 launchd 或 systemd）在跑，記得確認 AI_GATEWAY_API_KEY 有寫進 ~/.openclaw/.env 或是透過 env.shellEnv 傳進去。
• 模型路徑錯誤：檢查你的模型字串格式是否正確，必須包含 vercel-ai-gateway/ 前綴。

遇到搞不定的狀況？直接問 AI Setup Assistant 比較快。

下一步

• 設定 Anthropic 模型
• 管理多個 Gateway 帳號