clawrouter 外掛只會探索該金鑰允許的模型，透過每個模型宣告的通訊協定進行路由，並在 OpenClaw 使用量介面回報該金鑰的預算與彙總使用量。
上游憑證與提供者專屬轉送會保留在 ClawRouter 中，因此你不需要在 OpenClaw 主機上安裝或驗證每個上游提供者外掛。此外掛隨 OpenClaw 內建提供（enabledByDefault: true）；你只需要一組已核發的 ClawRouter 憑證。
| 屬性 | 值 |
|---|---|
| 提供者 | clawrouter |
| 外掛 | 內建（包含在 OpenClaw 中） |
| 驗證 | CLAWROUTER_API_KEY |
| 預設 URL | https://clawrouter.openclaw.ai |
| 模型目錄 | 透過 /v1/catalog 依憑證範圍限定 |
| 配額 | 透過 /v1/usage 提供每月預算與使用量 |
開始使用
設定 OpenClaw
clawrouter 是內建外掛，並預設啟用。如果你的設定有設定 plugins.allow，請先將 clawrouter 加入該清單，再啟用它。若是自訂部署，請將 models.providers.clawrouter.baseUrl 設為 ClawRouter 來源；預設值是 https://clawrouter.openclaw.ai。列出已授權的模型
clawrouter/openai/gpt-5.5、clawrouter/anthropic/claude-sonnet-4-6 或 clawrouter/google/gemini-3.5-flash。如果你的設定中 agents.defaults.models 是允許清單，請將每個選定的 ClawRouter 參照加入其中。模型探索
GET /v1/catalog 會回傳 { providers: [...] }，其中每個提供者項目會列出自己的 models[]（包含上游 ID、能力與定價）以及支援的請求路由。OpenClaw 不會隨附第二份固定的 ClawRouter 模型清單。目錄模型會在符合下列條件時公告為 OpenClaw 模型：
- 憑證的政策授權其提供者；
- 目錄模型公告支援的 LLM 能力（
llm.responses、llm.chat、llm.messages，或具備相符串流路由的llm.stream）；且 - 提供者針對下列其中一種傳輸公開相符路由。
通訊協定與提供者外掛
ClawRouter 擁有上游憑證；其目錄會告訴 OpenClaw 要使用哪種傳輸，因此你不需要安裝每家上游公司的驗證外掛。| 目錄能力 / 路由 | OpenClaw 傳輸 |
|---|---|
llm.responses（OpenAI 相容提供者） | openai-responses |
llm.chat（OpenAI 相容提供者） | openai-completions |
llm.messages + anthropic.messages 路由 | anthropic-messages |
llm.stream + 串流 google.generate_content 路由 | google-generative-ai |
配額與使用量
ClawRouter 的/v1/usage 回應會供給一般 OpenClaw 提供者使用量介面：請求、權杖與花費總計，以及金鑰有限額時的每月預算期間。未計量的金鑰仍會顯示彙總使用量，但不會顯示百分比期間。
配額查詢會使用與模型探索相同的範圍限定金鑰。配額查詢失敗不會阻擋模型執行。
使用以下命令檢查即時快照：
/status 與 OpenClaw 使用量 UI 取得。預算是整個政策共用的，因此另一個用戶端若使用相同 ClawRouter 政策提出請求，可能會改變剩餘百分比。
疑難排解
| 症狀 | 檢查 |
|---|---|
| 沒有 ClawRouter 模型 | 確認外掛已啟用，且 plugins.allow 允許它，然後檢查憑證是否有效，並授權至少一個就緒的提供者。 |
| 已設定的 ClawRouter 模型遺失 | 檢查其 /v1/catalog 能力與路由支援。不受支援的傳輸合約會有意被篩除。 |
Unknown model: clawrouter/... | 當該設定對應表作為允許清單使用時，請將精確的目錄參照加入 agents.defaults.models。 |
目錄或使用量回傳 401 或 403 | 重新核發或重新限定 ClawRouter 憑證範圍；OpenClaw 不會退回使用上游提供者金鑰。 |
| 探索後模型呼叫失敗 | 在 ClawRouter 中檢查提供者連線與上游健康狀態，然後在其就緒狀態恢復後重試。 |
| 使用量有總計但沒有百分比 | 該政策未計量；請在 ClawRouter 中加入每月預算，以公開百分比期間。 |
安全行為
- 目錄探索會限定於已設定的代理金鑰，並依憑證範圍快取（代理目錄、工作區目錄、驗證設定檔 ID 與基礎 URL）。
- 代理金鑰只會在請求分派時附加；不會儲存在模型中繼資料中。
- 原生 Anthropic 與 Gemini 模型 ID 只會在分派時改寫為其上游 ID。
- 不受支援或未授權的目錄列會採取失敗關閉，不可選取。
相關
模型提供者
提供者設定與模型選取。
使用量追蹤
OpenClaw 使用量與狀態介面。