一、版本概覽

2026年4月25日，ollama 發布了v0.21.2版本。
這次更新雖然版本號不大，但改動非常集中，主要圍繞launch 啟動體驗、OpenClaw 集成、模型推薦順序固定、managed integration 配置漂移修復、文檔補充這幾條主線展開。

從官方更新記錄來看，本次版本包含：

• ? 改進 OpenClaw onboarding 流程在ollama launch中的可靠性

• ?ollama launch中的推薦模型按固定且規范的順序展示

• ? OpenClaw 集成現在會捆綁 Ollama 的 web search 插件

• ? 結構化輸出文檔補充了云端限制說明

此外，從代碼變更和測試變化可以看出，這次更新并不是簡單的文檔或表面修復，而是對啟動流程、推薦列表排序邏輯、managed integration 配置一致性、以及 OpenClaw 相關體驗做了較大范圍的加固。

下面我們按照“發布內容—代碼變化—測試驗證—文檔變化”四個部分，完整拆解這次 v0.21.2 更新。

二、v0.21.2 官方更新要點

官方列出的 What's Changed 只有三條，但每一條背后都對應了較實質的行為變化：

1）提升了ollama launch中 OpenClaw onboarding 流程的可靠性

這是本次更新的重點之一。
所謂 onboarding 流程，就是用戶在通過ollama launch openclaw首次接入 OpenClaw 時，Ollama 自動幫你完成的一整套準備動作，例如：

• ? 如果 OpenClaw 沒安裝，則提示通過 npm 安裝

• ? 展示安全提示，說明工具訪問的風險

• ? 讓用戶選擇模型

• ? 自動配置 provider

• ? 安裝 gateway daemon

• ? 設置 primary model

• ? 啟用相關 web search 能力

• ? 啟動后臺 gateway 并打開 OpenClaw TUI

這次更新的“可靠性提升”，從測試變化看，不只是單點修復，而是包括：

• ? live config 漂移時能重新寫回配置

• ? 運行時刷新失敗時能及時停止

• ? 選擇器不會被錯誤打亂

• ? 已選模型與推薦模型之間的排序不會互相干擾

也就是說，這次主要是把 launch 流程中的一些邊界問題處理得更穩。

2）ollama launch里的推薦模型按固定、規范順序展示

這條看似簡單，實際影響很大。
之前推薦模型雖然也會顯示，但在一些交互場景中，排序可能會受到“已勾選模型”“本地/云端模型”“當前默認模型”等因素干擾，導致推薦區塊的順序不穩定。

本次更新后，推薦模型展示被明確固定為 canonical order，也就是規范順序。

這意味著推薦列表會嚴格按推薦模型定義的順序展示，而不會因為用戶選擇、安裝狀態、云端/本地混合情況而隨意變化。

從代碼和測試來看，這次排序規則的核心目標可以概括為一句話：

推薦區塊固定不變，勾選和默認優先級只影響 More 區塊。

3）OpenClaw 集成現在會捆綁 Ollama 的 web search 插件

這是對 OpenClaw 集成體驗的重要變化。
以前文檔里描述的是 OpenClaw 會安裝 web search 和 fetch 插件；現在更新后，說明調整為：

• ? OpenClaw 集成會啟用 OpenClaw 內置的 Ollamaweb_searchprovider

• ? Web search 能力通過 Ollama host 來提供

• ? 用戶通過ollama launch openclaw時會自動啟用

這說明 OpenClaw 的搜索能力路徑發生了變化，重點從“安裝外部插件”變成了“捆綁使用 Ollama 的 web search”。

三、代碼層面的變化詳解

這次版本對應的改動一共涉及 8 個文件、5 個 commits，增刪幅度不小。下面逐個拆開看。

1）cmd/launch/integrations_test.go：推薦模型順序測試全面改造

這份測試文件里最明顯的變化，是增加了一個輔助函數：

func recommendedNames(extra ...string) []string

這個函數的作用很直接：
它會按照recommendedModels的固定順序，把推薦模型名字全部收集起來，再拼接額外模型。

這說明測試不再手寫固定數組，而是通過推薦模型源數據生成預期值。
這樣做的好處是：只要推薦模型定義順序不變，測試就會穩定；如果推薦列表變了，測試也會更準確反映真實規則。

測試調整重點

原來很多測試里直接寫死了類似這樣的預期：

• ?kimi-k2.6:cloud

• ?qwen3.5:cloud

• ?glm-5.1:cloud

• ?minimax-m2.7:cloud

• ?gemma4

• ?qwen3.5

現在統一換成：

want := recommendedNames()

或者：

want := recommendedNames("llama3.2", "qwen2.5")

這種寫法本質上是在強調：
推薦區塊的順序完全由 recommendedModels 決定，不要再在測試中人為寫死另一個順序。

具體變化的測試場景

更新中覆蓋了多類場景：

• ? 沒有已有模型時，推薦項按固定順序展示

• ? 只有本地模型時，云端推薦依舊排在前面

• ? 本地和云端模型混合時，推薦項仍然固定在頂部

• ? 預勾選的非推薦模型在 More 區塊中出現，但不應破壞推薦順序

• ? 已勾選的推薦模型不會打亂推薦塊的順序

• ? 舊的、過時的 saved 配置也不應讓推薦區重新洗牌

特別值得注意的是，原本某些測試名稱和斷言邏輯也進行了調整，比如：

• ?TestBuildModelList_PreCheckedFirst

• ?TestBuildModelList_PreCheckedNonRecommendedFirstInMore

• ?TestBuildModelList_CheckedBeforeRecs

• ?TestBuildModelList_CheckedRecommendedDoesNotReshuffleRecommendedOrder

• ?TestBuildModelList_StaleSavedKimiK25DoesNotReshuffleRecommendedOrder

這些測試名稱本身就說明了本次排序邏輯的設計意圖：
checked、saved、current 這些狀態只能影響局部，不能破壞推薦區塊的固定順序。

2）cmd/launch/launch.go：managed single integration 的觸發條件更嚴謹

這里有一處很關鍵的小改動：

原邏輯大致是：

if (current == "" || needsConfigure || req.ModelOverride != "" || target != current) && !savedMatchesModels(saved, []string{target}) {

更新后變成：

if needsConfigure || req.ModelOverride != "" || (current != "" && target != current) || !savedMatchesModels(saved, []string{target}) {

雖然只是條件順序和邏輯表達方式的調整，但它反映出啟動配置判斷變得更精細。

這次調整的核心含義

新的條件更明確地表達：

• ? 如果需要配置，就重配

• ? 如果用戶顯式覆蓋了模型，就重配

• ? 如果當前模型已存在且與目標不同，就重配

• ? 如果 saved 配置和目標模型不匹配，也重配

這與后面的測試變化是配套的。
它說明 launch 過程中不再只看表面的 current，而是會更加關注“當前運行態、保存態、目標態”之間是否一致。

3）cmd/launch/launch_test.go：新增 live config drift 場景測試

這次測試文件新增了一個非常重要的場景：

TestLaunchIntegration_ManagedSingleIntegrationRewritesWhenLiveConfigDrifts

這個測試模擬的是：

• ? 已保存的 managed integration 配置是gemma4

• ? 但當前 live config 中實際運行的模型是qwen3:8b

• ? 當用戶 launch 這個 integration 時，系統應該識別到漂移，并重新寫入配置

• ? 同時運行時刷新應該執行一次

• ? 最終啟動的模型應該是 live 配置對應的qwen3:8b

• ? 重新加載 saved config 后，也應該變成qwen3:8b

這個測試說明，v0.21.2 重點修復了一個很現實的問題：

保存的配置和實際 live config 不一致時，launch 現在會主動糾偏。

這對 managed integration 的穩定性很重要。
因為如果只看本地保存配置，不看 live config，就容易出現：

• ? 顯示一個模型

• ? 實際跑另一個模型

• ? 重啟后狀態不一致

• ? 用戶以為配置生效，實際上運行目標不是當前真實目標

這次測試正是為了保證這種 drift 場景可以被正確處理。

另一個重要測試

新增了：

• ?TestLaunchIntegration_ManagedSingleIntegrationStopsWhenRuntimeRefreshFails

這說明系統還考慮了 runtime refresh 失敗的邊界情況。
如果刷新失敗，則應該停止后續流程，而不是繼續冒險運行。

這體現的是 launch 穩定性加固：
能糾偏時糾偏，糾偏失敗時及時停止。

選擇器相關測試也做了調整

在編輯器強制配置相關測試中，原來更關注“某個模型是否排在第一位”，現在則更強調“推薦順序是否保持固定”。這也是這次更新的核心變化之一。
比如在TestLaunchIntegration_EditorForceConfigure_FloatsCheckedModelsInPicker里，原先的判斷更偏向于“被勾選的模型浮到頂部”；而現在，測試更強調：

• ? 傳給選擇器的 items 必須保持固定推薦順序

• ? 被預勾選的模型可以被記錄下來

• ? 但推薦列表本身不能因為勾選狀態而改變排序

這一點非常關鍵，因為它說明launch的交互邏輯被重新劃分了職責：

• ?推薦區塊：固定順序，不能亂

• ?More 區塊：允許根據勾選、默認模型、安裝狀態做調整

也就是說，本次更新解決的是“排序干擾問題”，而不是單純把某個模型置頂。

4）cmd/launch/models.go：模型列表構建邏輯重構，推薦區塊徹底固定

如果說測試是為了驗證規則，那么models.go就是規則真正落地的地方。
這次在buildModelList里的排序邏輯調整非常大，雖然你給出的片段只展示了一部分，但足以看出核心思路發生了變化。

舊邏輯的問題

從修改痕跡可以看出，舊邏輯中對以下因素的處理是交織在一起的：

• ? 是否被勾選checked

• ? 是否是推薦模型recRank

• ? 是否是云端模型cloudModels

• ? 是否未安裝notInstalled

• ? 是否為當前默認模型current

這樣一來，在某些情況下，推薦模型和非推薦模型會因為這些條件交叉而產生排序波動。

新邏輯的核心目標

更新后的代碼明確表達了一個原則：

推薦模型區塊必須保持固定的順序，且 cloud recommended 還要優先于 local recommended。

從測試和注釋中可以看出，排序被重新拆成了兩層：

1. 1.推薦區塊

• ? 按recommendedModels定義順序排列

• ? 云端推薦在前，本地推薦在后

• ? 不受 checked、current 等狀態干擾

2.More 區塊

• ? 非推薦模型按勾選和默認優先級排序

• ? 當前模型可以優先

• ? 但不會反向影響推薦區塊

這正是本次版本中“canonical order”的真正含義：
推薦模型名單的順序是固定的，交互狀態不能把它打亂。

為什么這個變化重要

從用戶視角看，這種固定順序帶來的體驗提升很明顯：

• ? 每次打開 launch 面板，推薦項位置都一致

• ? 不會因為之前選過某個模型，下一次推薦列表就重新排列

• ? 不會因為本地/云端模型混在一起，推薦塊就看起來“跳來跳去”

• ? 更容易形成穩定認知，減少選擇成本

從系統視角看，這種改動也更利于測試和維護：
排序規則變得明確，測試可預期性更強，未來再改動推薦列表也更容易驗證。

5）cmd/launch/openclaw.gocmd/launch/openclaw_test.go：OpenClaw 集成加固

這兩個文件的變動幅度很大，說明 OpenClaw 是本次版本的重點集成對象之一。雖然大部分 diff 沒有完整展開，但從提交信息和測試變化可以確認，主要涉及以下幾類內容：

• ? 改進 OpenClaw onboarding 流程

• ? 綁定 Ollama 的 web search 能力

• ? 處理 live config drift

• ? 驗證啟動過程中的各種邊界條件

• ? 強化與選擇器、配置保存、運行時刷新相關的邏輯

結合文檔變化，可以把這次 OpenClaw 相關更新總結為：

1. 組件安裝邏輯更可靠

OpenClaw 的首次啟動不再只是簡單提示安裝，而是更完整地處理整個配置鏈路。

2. 搜索能力改為捆綁式啟用

不再強調外部插件安裝流程，而是改為啟用 Ollama 內置web_searchprovider。

3. Onboarding 流程更穩

選擇模型、配置 provider、安裝 gateway、設置 primary model、啟用搜索能力、啟動 gateway 這些步驟之間的銜接更可靠。

4. 異常狀態可被識別和修正

比如 live config 漂移時能重寫配置，runtime refresh 失敗時能停止流程。

四、文檔更新內容

除了代碼和測試，這次版本還更新了兩份文檔，分別是：

• ?docs/capabilities/structured-outputs.mdx

• ?docs/integrations/openclaw.mdx

在docs/capabilities/structured-outputs.mdx頂部新增了一個 Note：

Ollama's Cloud currently does not support structured outputs.

這條說明非常直接，意思是：

Ollama Cloud 當前不支持結構化輸出。

這次補充的價值在于，它把原本可能讓用戶困惑的能力邊界說清楚了。
因為結構化輸出本身是很實用的能力，用戶自然會期待它在所有環境都可用，但現在文檔明確告訴你：云端暫不支持。

這類說明雖然簡短，但很重要，能夠減少誤解和試錯成本。

2）OpenClaw 文檔更新：web search 的描述改了

docs/integrations/openclaw.mdx中有兩處明顯變化。

第一個變化：Onboarding 第四步描述更新

原先寫的是：

• ? 安裝 web search 和 fetch 插件

現在改成：

• ? 啟用 OpenClaw bundled 的 Ollama web search

這表明文檔已經從“外部插件安裝”切換到了“內置捆綁能力啟用”。

第二個變化：Web search and fetch 章節整體重寫

原來的描述是：

• ? OpenClaw ships with a web search and fetch plugin

• ? 通過openclaw plugins install @ollama/openclaw-web-search

• ? 再openclaw configure --section web

而更新后改為：

• ? OpenClaw ships with a bundled Ollamaweb_searchprovider

• ? 通過 Ollama host 提供 web search 能力

• ?ollama launch openclaw時自動啟用

• ? 如果要手動配置，則使用：

  openclaw plugins install @ollama/openclaw-web-search
  openclaw configure --section web

同時原文中的提示：

• ? “Web search for local models requiresollama signin.”

也被更新為：

• ? “Ollama web search for local models requiresollama signin.”

這說明文檔已經統一成“圍繞 Ollama web search provider”的表述方式。

五、本次版本的整體意義

從這次 v0.21.2 的變化可以看出，Ollama 并沒有去做大而空的功能擴展，而是在幾個很關鍵的用戶路徑上做了精細打磨：

1）啟動體驗更穩定

ollama launch尤其是 OpenClaw 相關啟動流程，明顯更可靠了。
模型選擇、配置寫入、運行時刷新、啟動執行這幾個環節都更穩。

2）推薦列表更可預期

推薦模型固定順序展示，解決了“看起來會亂跳”的問題。
這對交互體驗和測試穩定性都非常有價值。

3）配置漂移問題被補上

managed integration 在 live config 和 saved config 不一致時，現在會重新寫回并糾正，避免狀態漂移。

4）OpenClaw 集成更一致

搜索能力從“外部插件描述”轉向“bundled web search provider”描述，OpenClaw onboarding 也因此更統一。

5）文檔邊界更清晰

結構化輸出在云端不可用這一點被明確寫進文檔，減少用戶誤判。

六、總結

代碼地址：github.com/ollama/ollama

整體來看，ollama v0.21.2雖然表面上只是一個小版本更新，但實際內容非常扎實，核心關鍵詞可以概括為：

• ?更穩

• ?更準

• ?更固定

• ?更一致

具體來說：

• ? OpenClaw 的 onboarding 流程被加固

• ?ollama launch的推薦模型順序固定為 canonical order

• ? OpenClaw 集成啟用 Ollama bundled web search

• ? managed single integration 對 live config drift 的處理更嚴謹

• ? 文檔補充了結構化輸出在 Cloud 下不支持的說明

• ? OpenClaw 文檔同步更新了 web search 的實現與手動配置方式

如果你最近正在使用ollama launch、OpenClaw 集成，或者關注模型推薦順序與配置一致性，這次 v0.21.2 是值得升級和仔細了解的一版。

我們相信人工智能為普通人提供了一種“增強工具”，并致力于分享全方位的AI知識。在這里，您可以找到最新的AI科普文章、工具評測、提升效率的秘籍以及行業洞察。 歡迎關注“福大大架構師每日一題”，發消息可獲得面試資料，讓AI助力您的未來發展。