OpenClaw 無需更新即可使用新模型,改為三個模型列表來源
OpenClaw 無需更新即可使用新模型:改為三個模型列表來源
OpenClaw 透過三條模型列表來源,實現無需更新即可接入新模型。
- 模型來源: - 每 4 小時重建的
catalog.openclaw.ai目錄(約 1。
AI 伴隨問答
針對這篇報導有疑問?可直接點選快捷問題或向 AI 追問背景脈絡與技術細節:
OpenClaw:Blog·2026-11-06 08:00· 18 小時前精選AI 評分63
Use new models in OpenClaw without an update
AI 導讀
OpenClaw 重構模型列表獲取方式,約五週、80 個 PR,新模型不再等客戶端發版。現在從三處取模型列表:每 4 小時重建的 catalog.openclaw.ai 目錄(約 1000 個模型)、賬號可用的模型列表,以及 PATH 上已安裝的 Codex(需同主版本且握手通過,否則回退內建版本)。
推薦理由
官方復盤了無需發版即可接入新模型的架構改動,讀者可以瞭解模型目錄、賬號列表和已裝 Codex 三條路徑的具體取捨。
OpenAI 釋出 GPT-6.1 Sol 時,用 ChatGPT 賬號登入 OpenClaw 的使用者卻選不到它。OpenClaw 內建的是 Codex 0.158.0,而 ChatGPT 只向 Codex 0.159.2 及更新版本提供 Sol,想改掉這個版本號,唯一的辦法就是我們發一個新版本。
釋出當天正是大家最想試用新模型的時候,卻因為我們,使用者不得不等。於是我們花了大約五週時間、提交了約 80 個 PR,重做了 OpenClaw 獲取模型列表的方式。
本文介紹 OpenClaw 現在從哪三個地方獲取模型列表、一個我們上線後又回滾的修復,以及還有哪些地方仍然需要發版。
以前模型是怎麼到使用者手裡的
每個提供商外掛都在一個清單檔案裡帶著自己的模型列表,而這個檔案是打包在 OpenClaw 安裝包裡的。提供商以外掛形式釋出,外掛又繫結在某個版本上。
現在 OpenClaw 從三個地方填充你的模型列表。
1. 會自動更新的目錄
我們在 catalog.openclaw.ai 託管了一份模型目錄,每四小時由任務重建一次。它從 models.dev 獲取模型資料,再疊加我們自己的清單、補上價格,然後釋出結果。目前收錄約 1,000 個模型。
執行中的 Gateway 會在後臺檢查是否有更新的目錄,並即時切換過去。
- 之前:Gateway 下載新目錄後仍繼續使用舊目錄,直到你重啟它。
- 之後:新的輪次使用新目錄。已經進行中的輪次會用啟動時的目錄跑完,因此它的模型列表和價格始終一致。
釋出端還會移除已下線或提供商不再提供的模型。
例如,NVIDIA 已停止在其 API 上提供 2 個模型,但目錄裡仍然列著它們。
故障是怎麼發生的
9 月 21 日,models.dev 把它的 kimi-for-coding 條目拆成了兩個新條目。我們的釋出程式把一個缺失的提供商當成致命錯誤,導致每次執行都失敗。那段時間裡,GPT-6 Sol 和 Luna 沒能進入已有的安裝。現在缺失提供商會記錄一條警告,只有該提供商拿不到最新資料。
2. 你的賬號列出的,你就能選
目錄知道公開存在哪些模型,你的賬號知道你能用哪些。當你登入某個提供商時,OpenClaw 會向它請求你的模型列表,並顯示其中所有對話模型,包括比你安裝版本更新的模型,或只有你的賬號能訪問的模型。
- OpenAI API key。之前:
Unknown model: openai/gpt-5.2,儘管賬號裡列出了它。之後:賬號列出的對話模型會出現並可執行。 - Anthropic API key。之前:新的 Claude 模型要等 OpenClaw 發版才會出現。之後:只要 Anthropic 的模型列表返回它,它就會出現。
- Claude Code。之前:一份由我們維護的固定列表。之後:Claude Code 為你的賬號報告的模型選單。
- GitHub Copilot。之前:
kimi-k3第一輪就因unsupported_api_for_model失敗。之後:我們會讀取每個模型接受哪個端點,並使用那個端點。 - Grok 訂閱。之前:
grok-4.7-build-fast提供兩檔思考級別,關閉和 ultra。之後:按它的列表說明,提供 low、medium、high 和 xhigh。 - Ollama。之前:你執行
ollama pull,模型卻始終不出現。之後:下次重新整理時它就會出現。 - OpenCode Go。之前:你的賬號可用的四個模型缺失。之後:列表中每個模型都會出現。
這項工作有一半講的是模型能做什麼。OpenClaw 過去會根據模型名稱來猜測思考等級和請求格式,一旦遇到從未見過的新模型就會失效。其實服務商已經在自己的列表裡公佈了這些資訊,所以我們改為直接從那裡讀取。
3. Codex 版本問題
這就是文章開頭提到的 Sol 缺陷。ChatGPT 根據客戶端上報的 Codex 版本決定提供哪些模型。版本舊,拿到的列表就短。
第一次嘗試:上報最新的 Codex 版本
我們最初的修復很簡單:向 npm 查詢最新的 Codex 版本號,在拉取列表時上報這個數字。Sol 出現在了選擇器裡。
一次教訓
可惜的是,列表請求上報的是 0.161.0,但對話輪次仍然跑在隨附的 0.160.0 上,而這個二進位制檔案會在每次請求時上報自己的版本。需要更新版本的模型會出現在選擇器裡,然後以 HTTP 400 失敗。我們只是把失敗從選擇器挪到了第一條訊息,這更糟。於是我們回滾了。
現在的釋出方案
OpenClaw 會在你的 PATH 上尋找 Codex。如果它是穩定版、比隨附版本新且主版本號相同,OpenClaw 就會與它做一次真正的握手。如果握手通過,同一個二進位制檔案負責拉取模型列表並執行你的對話輪次。任何一步失敗,OpenClaw 就使用隨附的 Codex。它絕不會替你安裝任何東西。
這是在裝有 Codex 0.162.1 的 Mac 上測試執行時,Gateway 的日誌行:
[agent/embedded] Codex app-server: using installed ~/.local/bin/codex 0.162.1 (newer than bundled 0.161.0)現在只要更新全域性 Codex,就足以用上需要它的模型。
一個不再縮水的列表
找到模型是一個問題,讓它們留在螢幕上則是另一個問題。過去,列表會因為與使用者毫無關係的原因丟失模型。
OpenRouter 超時一次
- 之前:466 → 3 個模型。在有人手動重新整理之前,它們一直消失。
- 之後:它會自行重試。首次在 30 秒後,之後間隔逐漸拉長,最長 30 分鐘。
Gateway 切換到新目錄
- 之前:599 → 54 個模型,在生產 Gateway 上最長持續四分鐘。
- 之後:全程保持 599。舊列表會一直保留,直到新列表完整。
你更改預設模型
- 之前:68–142 秒。Gateway 在重新載入每個大型外掛時會卡住。
- 之後:0.6–1.4 秒。它會複用已經載入的外掛。
選擇器現在也會立即開啟。它們先顯示 OpenClaw 已知的模型,其餘的在後臺補齊。過去它們要等發現流程完成,最長五秒。
一千個模型太多了
一旦所有模型都顯示出來,列表就會變得很長。僅 OpenRouter 就有 466 個。因此目錄現在為每個服務商附帶一份簡短的推薦列表,選擇器會把它放在最前面。
這是我們自己某個 Gateway 上的同一個選擇器。在 OpenAI 分組中,當前模型排在最前,然後是兩個推薦模型,其餘 33 個則收在一行後面。
推薦列表由人工整理,並根據我們自身的經驗以及多種基準測試每天更新。
要點
- 列出某個模型的版本,也必須能執行它。報告的是一個 Codex 版本、實際執行的卻是另一個,只會把故障從選擇器挪到第一條訊息。
- 能力資訊要從列表裡讀,而不是從名字裡猜。服務商的列表本來就寫明瞭某個模型支援哪些思考級別和端點。靠模型名字推斷的規則,遇到第一個沒見過的模型就會失效。
- 保留上一份可用的列表。重新整理失敗或切換目錄,都不該讓選擇器裡的模型比之前更少。
- 一個來源出問題,不該拖累其他來源。models.dev 上一個改了名的服務商曾讓所有服務商的目錄更新全部停擺,直到我們把它降級為警告。
仍需發版才能解決的問題
- 如果你沒有安裝更新的 Codex,那麼你看到哪些 ChatGPT 模型,仍由內建版本決定。
- 比目錄更新的模型還沒有價格。OpenClaw 會把它的成本顯示為未知,並在目錄跟上之前,用保守的預設限制來執行它。
想看你當前的安裝現在能訪問到什麼,執行 openclaw models list --refresh。
下一步
我們會持續改進體驗,並支援更多服務商。如果你的賬號裡列出了某個模型,而 OpenClaw 沒有顯示,請提交 issue,並附上該命令的輸出。
致謝
本文由 Ayaan Zaidi 撰寫。感謝 @vincentkoc 貢獻目錄 v2 和按路由定價,@ly85206559 貢獻 models.dev 服務商別名,@mcooks-cmd 修復目錄 worker 的記憶體問題,以及 @steipete 讓多服務商目錄重新整理更快。
主要 PR:來自 models.dev 的目錄、即時目錄接入、賬號模型列表、已安裝 Codex 的選擇、發現重試、選擇器中的推薦模型。
來源:OpenClaw:Blog · openclaw.ai