分享一下 openclaw 快速切换模型的方式，越用越发现这玩意儿太牛了。现在每天都在用它，每天都在研究一些使用场景。如果用的正嗨的时候，突然 openclaw 罢工，回复 request ended without sending any chunks，那真是有点扫兴了。
这个报错不是 OpenClaw 本身出了问题，而是有时候接入渠道模型不稳定。
这种情况下OpenClaw 也没办法帮你修复渠道问题，只能自己手动操作。如果不知道怎么切换模型，就比较难受了。
我前后遇到过好几次这种情况，还是要分享一下。
就比如今天和 OpenClaw 聊选题的事情，想让它帮我搭建选题池、整理和提炼内容方向。聊到一半，bot 突然不响应了。是Claude Code 渠道不太稳定，如果你的中转厂商支持多个模型渠道，可以换一个渠道试试，或者直接切到另一个模型顶上。
硬切换
我的情况比较简单，同一个模型、同一个厂商，只是厂商支持多个渠道，所以我换了一个渠道的 API key 就恢复了。操作方式是 SSH 到服务器，编辑配置文件，找到对应 provider 下的 apiKey 字段，替换成新渠道的 key。
不过更常见的情况是切换默认模型。在配置文件里找到默认模型字段，改成备用模型的 ID，保存后重启 Gateway。
# 硬切换的完整流程
ssh user@your-server
nano ~/.openclaw/openclaw.json
# 换 key：找到对应 provider 的 apiKey 字段，替换成新的 key
# 换模型：找到 agents.defaults.model.primary，改成备用模型 ID
# 保存退出
openclaw gateway restart
不管是换 key 还是换模型，都得走这套流程。这个方式对小白很不友好而且麻烦，一是容易改错，JSON 格式少个逗号多个引号就启动不了，配置文件内容也不少，找到要改的字段需要时间。二是不确定改完是不是就行了，还需要重启 Gateway 才能生效。
/model 命令
恢复之后，我立马做了一件事：让 bot 帮我把最新的 Codex 5.3 模型也加到配置里，codex 相对比较稳定，cc 出问题了 codex 可以立马顶上。然后问它有没有更快的切换方式。
OpenClaw 自带一个 /model 命令，可以在聊天框里直接切换模型，不需要 SSH、不需要改配置文件、不需要重启服务，即时生效。比如：
/model aigocode-gpt/gpt-5.3-codex
一行命令，当前会话立刻切换到 Codex 5.3。等 Claude Code 渠道恢复了，再切回来：
/model cc/claude-opus-4-6
或者直接重置为配置文件里的默认模型：
/model reset
需要注意的是，/model 命令切换的是当前会话的模型，不会修改配置文件。新会话或 Gateway 重启后，会回到配置文件中设置的默认模型。这其实也合理，临时切换用 /model，长期变更才去改配置。
还有一点容易忽略：/model 命令只能切换到配置文件白名单里的模型。配置文件中有一个 models 字段专门控制这个，只有列在里面的模型才允许通过 /model 切换。默认模型不需要额外加，但新增的备用模型一定要记得加到白名单里，否则会提示不允许切换。
如果你配置了模型别名（alias），切换起来更方便。比如在配置文件里给模型设好别名后，直接 /model opus 或 /model codex 就行，不用记那一长串模型 ID。
为了以防万一，我让 bot 把目前可用的模型都列了出来，方便随时通过 /model 命令切换，也方便需要手动改配置文件时参考。
这里解释一下模型 ID 里 cc 和 aigocode-gpt 这些前缀，它们是自定义的供应商名称（Provider ID）。
因为我用的是第三方中转而不是官方 API，所以自定义一个名称来区分不同的渠道。这样做的好处是每个渠道可以独立配置 API Key 和 Base URL，互不干扰，出了问题也能一眼看出是哪个渠道的锅。
配多个模型走不同的渠道，基本上不会同时挂掉。日常用 Claude Opus，一旦出问题，/model 一行命令切到 Codex，几秒钟就能恢复对话。
更进一步：自动故障切换
写这篇文章的时候翻了一下 OpenClaw 的文档，发现其实还有一个 fallback chains 功能，可以配置模型的自动故障切换。在配置文件里，除了设置主模型，还可以设置 fallbacks 数组，当主模型挂了（比如超时、认证失败、触发限流），OpenClaw 会自动按顺序尝试备用模型，不需要手动干预。
{
"agents": {
"defaults": {
"model": {
"primary": "cc/claude-opus-4-6",
"fallbacks": ["aigocode-gpt/gpt-5.3-codex", "aigocode-gpt/gpt-5.2-codex"]
}
}
}
}
配好之后，Claude 渠道不稳定的时候，OpenClaw 会自动切到 Codex，不需要你手动操作。等主模型恢复了，新的会话又会自动回到 Claude。
这个功能我之前完全不知道，配置很简单，把上述的代码贴给 OpenClaw 操作，它会检查配置结构和你的实际模型。
丝滑切换模型
简单来说就三件事：多配几个不同渠道的模型做备用；记住 /model 命令可以在聊天框里即时切换；配好 fallback chains 让它自动处理。做好这些，又可以节省时间了。
💡 AI 工具的爆发，让普通人也能快速做出产品。
但如何做？如何变现？如何真正走向海外市场？
👇 想了解更多 AI 编程 & 出海实战信息，扫码添加好友了解更多
🔗 更多教程请访问 ipengtao.com
文章评论