跳到正文
aihot(aihot.news)· noreply@aihot.news (OpenClaw:Blog)·· 17 天前品質評分65

OpenClaw 無需更新即可使用新模型,改為三個模型列表來源

OpenClaw 無需更新即可使用新模型:改為三個模型列表來源

重點導讀

OpenClaw 透過三條模型列表來源,實現無需更新即可接入新模型。

  • 模型來源: - 每 4 小時重建的 catalog.openclaw.ai 目錄(約 1。

AI 伴隨問答

自備 Key 深度分析

針對這篇報導有疑問?可直接點選快捷問題或向 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 安裝包裡的。提供商以外掛形式釋出,外掛又繫結在某個版本上。

Before: a provider ships a model, we edit the model manifest, we cut a release, and you update OpenClaw. After: the hosted catalog, your account's model list, and your installed Codex all feed the model picker directly.
圖 1. 以前新模型是怎麼進入你的選擇器的,現在又是怎麼進入的。

現在 OpenClaw 從三個地方填充你的模型列表。

1. 會自動更新的目錄

我們在 catalog.openclaw.ai 託管了一份模型目錄,每四小時由任務重建一次。它從 models.dev 獲取模型資料,再疊加我們自己的清單、補上價格,然後釋出結果。目前收錄約 1,000 個模型。

models.dev, plugin manifests, price feeds, and providers' model lists go into a publisher that runs every four hours. It publishes to catalog.openclaw.ai, and your running Gateway picks the catalog up without a restart.
圖 2. 託管目錄的輸入內容,以及它如何到達執行中的 Gateway。

執行中的 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 失敗。我們只是把失敗從選擇器挪到了第一條訊息,這更糟。於是我們回滾了。

Three cases. Before: the model list and the turns both use Codex 0.158.0, so GPT-6.1 Sol stays hidden. First try: the list asks as 0.161.0 but turns run on 0.160.0, so a model is listed and then fails with HTTP 400. Now: the list and the turns use the same binary, your newest Codex, so the model is listed and runs.
圖 3. 各方案中,請求模型列表的 Codex 版本與執行對話輪次的版本。

現在的釋出方案

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 個。因此目錄現在為每個服務商附帶一份簡短的推薦列表,選擇器會把它放在最前面。

Before: a picker with hundreds of models in catalog order, old ones mixed with new. After: Default, then your current model, then a few recommended models, then a collapsed All models row.
圖 4. 選擇器中 OpenRouter 分組的示意圖。搜尋仍然會查詢所有模型。

這是我們自己某個 Gateway 上的同一個選擇器。在 OpenAI 分組中,當前模型排在最前,然後是兩個推薦模型,其餘 33 個則收在一行後面。

The OpenClaw chat model picker. The OpenAI group shows 36 models: GPT-6 Astra as the current default, then GPT-6.1 Sol and GPT-6 Luna, then a collapsed All models (33) row.
圖 5. Control UI 聊天選擇器中的 OpenAI 分組,擷取自正在執行的 Gateway。

推薦列表由人工整理,並根據我們自身的經驗以及多種基準測試每天更新。

要點

  • 列出某個模型的版本,也必須能執行它。報告的是一個 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

來源: aihot (aihot.news)
開啟原文

讀者討論

理性交流 · 即時討論