用 OpenRouter 一次搞定所有 LLM 模型

如果你跟我一樣，每天都在切換不同模型的 API Key，一下要補 OpenAI 的點數，一下要看 Anthropic 的帳單，那你一定懂那種崩潰感。我之前為了測試一個功能，得開好幾個分頁去複製貼上 Token，這根本是在浪費生命。自從換了 OpenRouter 之後，我只需要一個 API Key 就能呼叫市面上幾乎所有的模型。

需要準備的東西

• 一個 OpenRouter 帳號
• 準備好你的 OPENROUTER_API_KEY（在 OpenRouter 後台建立）
• 已安裝 OpenClaw CLI

快速開始

OpenRouter 最棒的地方就是它相容 OpenAI 的 API 格式，你只要換個 base URL 就能直接跑，不用改寫整套程式碼。

1. 快速綁定 CLI

直接在你的終端機執行這行指令，把你的 API Key 餵給 CLI：

openclaw onboard --auth-choice apiKey --token-provider openrouter --token "$OPENROUTER_API_KEY"

2. 配置你的設定檔

在你的設定檔裡指定你想用的模型。我個人推薦直接上 claude-3-5-sonnet，反應速度跟智商的平衡點抓得最好。記得模型路徑一定要加上 openrouter/ 前綴：

{
  env: { OPENROUTER_API_KEY: "sk-or-..." },
  agents: {
    defaults: {
      model: { primary: "openrouter/anthropic/claude-3.5-sonnet" },
    },
  },
}

疑難排解

• 模型名稱對不上：OpenRouter 的格式是 openrouter/<provider>/<model>，少寫一個斜槓都會噴錯。
• 額度問題：OpenRouter 雖然是統一入口，但你還是要在它的後台儲值（Credits）才能正常運作。
• 連線逾時：有些特定的 Provider 可能偶爾會抽風，建議在 primary 之外多設一個備用模型。
• 權限報錯：檢查你的 API Key 是否有正確開啟對應模型的權限。

設定上有任何卡關嗎？直接問我們的 AI Setup Assistant 幫你 debug。

下一步

• /concepts/model-providers
• /guides/configuration