我是如何搞定 Open Claw 模型查询与 Kimi 到 Qwen 切换的

这篇文章整理了我日常使用 OpenClaw CLI 的经验，和仓库里的官方文档保持一致。如果你想查看所有命令的详细用法，可以参考这份 OpenClaw CLI 命令参考手册。

一、当前到底在用哪个模型？我的查询方法

每次打开终端，想确认一下 Open Claw 背后是哪位“大脑”在为我工作，我的首选命令永远是：

openclaw models status

这个命令的输出非常清晰，你只需要找到 Default: 这一行，它后面跟着的就是当前默认的对话模型。比如，你可能会看到 moonshot/kimi-k2.5 或者 qwen-portal/coder-model。这个信息最直接，也最可靠。

当然，根据不同的场景，我还会用到下面这些查询命令，它们各有各的妙用：

有些版本可能还支持用 openclaw config get default_model 来查看配置。但根据我的经验，如果这个命令的结果和 models status 显示的 Default 不一致，请务必以 openclaw models status 的输出以及实际会话中的状态为准，配置项有时会“骗人”。

二、从 Kimi 切换到 Qwen 的实战步骤

我常用的 Kimi 模型是 moonshot/kimi-k2.5（或者它的代码变体 kimi-code），而 Qwen 门户这边，我偏爱 qwen-portal/coder-model。切换过程其实不复杂，但有几个关键点。

1. 第一步：启用 Qwen 的认证插件
   这是切换的前提。启用后，一定要重启 Gateway，否则插件可能不会生效。这是我的血泪教训。

   openclaw plugins enable qwen-portal-auth
   

2. 第二步：完成 Qwen 的 OAuth 登录
   这一步会打开浏览器，引导你完成授权。加上 --set-default 参数可以顺便把它设为默认的认证提供方，很方便。

   openclaw models auth login --provider qwen-portal --set-default
   

3. 第三步：设置默认模型
   现在，把我们的目标模型设为默认。如果你之前配置过别名（比如 qwen），用别名会更简洁。

   openclaw models set qwen-portal/coder-model
   # 或者，如果配置了别名：openclaw models set qwen
   

4. 第四步：验证切换结果
   切换完别急着用，先验证一下。我习惯先用 status 看状态，再用 --check 确保认证没问题。如果还有疑问，--probe 能给你最底层的凭证状态。

   openclaw models status
   openclaw models status --check
   # 必要时：openclaw models status --probe
   

如果后续发现 OAuth 令牌失效了（比如提示 refresh token 无效），别慌，重新登录一次就行：

openclaw models auth login --provider qwen-portal

如果你想看更完整、更详细的步骤拆解，我强烈建议你参考这两篇指南：Open Claw 从 Moonshot 切换到 Qwen 模型指南 和 Open Claw Qwen 模型配置指南。

三、切换模型时，我踩过的那些“坑”

模型切换看着简单，但细节决定成败。下面是我总结的几个需要特别注意的地方，希望能帮你避开我走过的弯路。

1. 认证方式天差地别
   Moonshot/Kimi 通常用 API Key，而 Qwen 门户用的是 OAuth。如果你只执行了 models set 切换模型，却没有完成对应 provider 的认证，那么调用时一定会失败。记住，模型和认证是绑定的。

2. 插件与 Gateway 的联动
   第一次启用 qwen-portal-auth 插件后，务必重启 Gateway。我有好几次忘了重启，结果配置半天不生效，还以为是命令出错了。

3. 眼见不一定为实
   偶尔会遇到界面或配置显示已经切到了 Qwen，但对话的感觉还是像 Kimi。这时候，不要相信“感觉”，要以会话侧的状态（比如检查 /status 或 session_status）以及再次执行 openclaw models status 的结果为准。

4. 小心 Token 过期
   Qwen 的 OAuth 令牌（尤其是 refresh token）有时会失效。如果遇到认证错误，别想太多，直接重新执行登录命令 openclaw models auth login --provider qwen-portal 就行。我的具体踩坑记录可以看这里：Kimi切换Qwen模型切换记录。

5. 图像模型需要单独设置
   如果你需要模型具备“看图说话”的能力，比如使用 qwen-portal/vision-model，那么你需要单独设置图像模型。只切换对话模型是不会影响图像能力的。

   openclaw models set-image qwen-portal/vision-model
   

6. 模型 ID 与别名
   我建议在设置时使用完整的 provider/model 格式（如 qwen-portal/coder-model），或者使用你明确配置过的别名。如果省略 provider，系统可能会尝试解析为别名或使用默认 provider，很容易指错模型。

7. 多 Agent 环境
   如果你的环境里有多个 agent，记得用 openclaw models status --agent <id> 来分别确认每个 agent 的模型状态，避免张冠李戴。

四、我的常用文档索引

为了方便查阅，我把相关的重要文档整理成了下面这个表格，这些都是我解决问题时经常翻看的“秘籍”。

当然，最权威的还是官方文档：CLI - models，当你有不确定的细节时，去那里查证总是没错的。