OpenClaw 模型列表
OpenClaw 在 2026 年 11 月 6 日发布了一次架构改动：模型列表不再跟着客户端发版走，新模型发布当天就能出现在选择器里。起因是 GPT-6.1 Sol 上线时，用 ChatGPT 账号登录的 OpenClaw 用户选不到它——内置的 Codex 是 0.158.0，而 ChatGPT 只向 0.159.2 及更新版本开放 Sol。团队花了约五周、近 80 个 PR，把模型发现机制整个重做了一遍。
三条通道分别解决什么
第一是托管目录 catalog.openclaw.ai，每四小时重建一次，目前收录约 1000 个模型，数据来自 models.dev，再叠加自家清单与价格。网关在后台拉取新目录，新旧切换时，正在进行的对话用旧目录跑完，新对话直接用新目录。第二是账号自己的模型列表：登录服务商后，OpenClaw 直接问对方要一份可用模型清单，账号能用的聊天模型都会出现，哪怕它比当前安装版本还新。第三是本机已装的 Codex：如果 PATH 里有更新的同主版本稳定版，OpenClaw 会和它做一次真实握手，通过后就用这个版本取列表并跑任务，失败则回退内置版本，不会替用户装任何东西。
一次走弯路的修复
团队最早的修复是上报最新的 Codex 版本号，Sol 确实出现在了选择器里，但跑任务的仍是内置的旧版本，需要新版本的模型会在第一条消息报 HTTP 400。失败从选模型挪到了发消息之后，这个方案被撤回了。现在的握手做法保证了“报出哪个版本，就用哪个版本跑”。这次改动还修了几个让列表无故变少的问题：OpenRouter 超时曾让可选模型从 466 个掉到 3 个，得手动刷新才回来，现在会自动重试，从 30 秒起逐步拉长到 30 分钟；切换目录时曾短暂只剩 54 个，现在旧列表会一直用到新目录完整下载；改默认模型曾让网关卡住 68 到 142 秒，现在只要 0.6 到 1.4 秒。
还有两件事仍要等发版
模型一多，列表本身也变长，目录里因此给每个服务商加了一份人工推荐清单，每天按实际体验与基准更新，推荐的先排在前面，搜索仍能覆盖全部。本机没有更新的 Codex 时，ChatGPT 侧能看到的模型仍由内置版本决定；比目录更新的模型会显示费用未知，并以谨慎的默认额度运行。用户可以用 openclaw models list --refresh 随时查看当前安装能触及哪些模型。之前从 OpenClaw 迁走的工具链，迁移前先看这份 dry-run 注意事项仍然适用。
