OpenClaw 改为从托管目录和账号读取模型清单,新模型不再等发版
Use new models in OpenClaw without an update
OpenClaw 从 11 月 6 日起改为从三处获取模型清单,包括每四小时重建一次的托管目录 catalog.openclaw.ai(约 1000 个模型)、用户在各服务商账号下的模型列表,以及本机 PATH 上更新的 Codex。
OpenClaw 不再把模型清单写进版本里,改从托管目录、账号和本机 Codex 三处读取,新模型上线当天就能选,但没装新版 Codex 的人仍要等发版。
无需更新即可在 OpenClaw 中使用新模型
OpenClaw 现在会从托管目录、你的服务商账户以及已安装的 Codex 中获知新模型,因此模型发布后不必再等 OpenClaw 发版。
2026年11月6日 · 8 分钟阅读

OpenAI 发布 GPT-6.1 Sol 时,用 ChatGPT 登录方式使用 OpenClaw 的人却选不到它。OpenClaw 内置的是 Codex 0.158.0,而 ChatGPT 只向 Codex 0.159.2 及更新版本提供 Sol,要改这个版本号,唯一的办法就是我们发一个版本。
发布当天正是大家最想试用新模型的时候,而让他们不得不等的,恰恰是我们。于是我们花了大约五周、约 80 个 PR,重做了 OpenClaw 发现模型的方式。
本文介绍 OpenClaw 现在从哪三个地方获取模型列表、一个我们上线后又回滚的修复,以及还有哪些情况需要发版。
过去模型是如何到达用户手中的
每个服务商插件都在一个清单文件里带着自己的模型列表,而这个文件是打包在 OpenClaw 安装包里的。服务商以插件形式发布,插件又绑定在某个版本上。

图 1. 新模型过去如何进入你的选择器,现在又如何进入。
OpenClaw 现在从三个地方填充你的模型列表。
1. 会自动更新的目录
我们在 catalog.openclaw.ai 托管了一个模型目录,每四小时重建一次。它从 models.dev 获取模型数据,在上面叠加我们自己的清单,补充价格,然后发布结果。目前收录约 1,000 个模型。

图 2. 托管目录的输入内容,以及它如何到达运行中的 Gateway。
运行中的 Gateway 会在后台检查是否有更新的目录,并实时切换过去。
- 之前:Gateway 下载新目录后仍继续使用旧目录,直到你重启它。
- 之后:新的轮次使用新目录。已经进行中的轮次会用启动时的目录跑完,因此它的模型列表和价格始终一致。
发布端还会移除已下线或服务商不再提供的模型。
例如,NVIDIA 已停止在其 API 上提供 2 个模型,但目录里仍然列着它们。
它是怎么出问题的
9 月 21 日,models.dev 把它的 kimi-for-coding 条目拆成了两个新条目。我们的发布程序把一个缺失的服务商当成致命错误,于是每次运行都失败。那段时间里,GPT-6 Sol 和 Luna 没能进入已有安装。现在缺失服务商只会记录一条警告,也只有该服务商拿不到最新数据。
2. 账户里列出的,就能选
目录知道公开存在哪些模型,你的账户知道你能用哪些。当你登录某个服务商时,OpenClaw 会向它请求你的模型列表,并显示其中所有对话模型,包括比你安装版本更新的模型,或只有你的账户才能访问的模型。
- OpenAI API 密钥。之前:
Unknown model: openai/gpt-5.2,尽管账户里列出了它。之后:账户列出的对话模型会显示并可运行。 - Anthropic API 密钥。之前:新的 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 失败。我们只是把失败从选择器挪到了第一条消息,这更糟。我们回滚了这次改动。

图 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 个。因此目录现在会为每个服务商附带一份简短的推荐列表,选择器会把它放在最前面。

图 4。选择器中 OpenRouter 分组的示意图。搜索仍然会查找每一个模型。
这是我们自己某个 Gateway 上的同一个选择器。在 OpenAI 分组中,当前模型排在最前,然后是两个推荐模型,接着是另外 33 个,收在一行后面。

图 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 的选择、发现重试、选择器中的推荐模型。
按 Enter 或空格键展开或收起此图片。
本页内容
模型过去如何到达用户1. 自动更新的目录它是怎么坏的2. 账号列出了,就能选3. Codex 版本问题第一次尝试:报告最新的 Codex 版本我们从中吸取的教训现在发布的内容一份不再缩水的列表一千个模型太多了要点仍需发版的部分下一步致谢
相关文档


拉把椅子坐下。
AI 的未来有你的位置。加入 Reddit、Discord 和 X 上的社区。
来源:OpenClaw Blog · openclaw.ai
