从 Moonshot 到 Qwen：我的 Open Claw 模型切换实战

今天我想和大家分享一下，我是如何将我的 Open Claw 从 Moonshot（也就是 Kimi）模型切换到 Qwen（通义千问）模型的。整个过程比我想象的要顺畅，但也有些细节需要注意，希望能帮你少走弯路。

切换前后的核心区别，我帮你整理好了：

项目	Moonshot	Qwen
认证方式	API Key	OAuth
免费额度	按量计费	2,000 请求/天
端点	api.moonshot.ai/v1	portal.qwen.ai/v1

---

我是如何一步步切换的

第一步：启用 Qwen 插件

切换的第一步，是启用对应的插件。这步很简单，只需要一条命令：

openclaw plugins enable qwen-portal-auth

注意： 启用插件后，记得重启 Gateway 服务才能生效哦。

第二步：搞定 Qwen 的 OAuth 认证

这是和 Moonshot 最大的不同点。Moonshot 用的是 API Key，而 Qwen 用的是 OAuth 授权。执行下面的命令：

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

这个命令会做几件事：
- 自动打开你的默认浏览器，跳转到 Qwen 的授权页面。
- 完成授权后，它会自动获取 device-code。
- 将你的认证信息安全地写入本地的 models.json 配置文件。
- 为了方便，它还会创建一个 qwen 的别名，后续切换模型时可以直接用。

我第一次用的时候，感觉这种浏览器授权的方式比复制粘贴 API Key 要方便和安全一些。

第三步：正式切换到 Qwen 模型

认证成功后，就可以切换模型了。我主要用代码生成，所以选择了 Coder 模型：

# 直接使用完整的 provider 名
openclaw models set qwen-portal/coder-model

# 或者使用上一步创建的别名（如果创建了的话）
openclaw models set qwen/coder-model

第四步：验证一下是否切换成功

切换完当然要检查一下，确保一切正常：

# 查看当前模型状态，这是最直观的
openclaw models status

# 如果想更详细地检查认证是否有效，可以加上 --check 参数
openclaw models status --check

看到状态显示为 qwen-portal/coder-model，并且认证状态正常，就说明切换成功啦！

---

手动修改配置文件（可选方案）

如果你和我一样，喜欢直接看配置文件，或者需要手动调整一些细节，可以直接编辑 models.json 文件。下面是我切换前后的配置对比，一目了然。

切换前：Moonshot 的配置

{
  "env": {
    "MOONSHOT_API_KEY": "sk-..."
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "moonshot/kimi-k2.5"
      }
    }
  }
}

切换后：Qwen 的配置

{
  "providers": {
    "qwen-portal": {
      "baseUrl": "https://portal.qwen.ai/v1"
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "qwen-portal/coder-model"
      }
    }
  }
}

可以看到，Qwen 的配置里没有了 env 里的 API Key，取而代之的是 providers 里定义的 baseUrl。

---

保留 Moonshot，实现多模型自由切换

我个人建议，先别急着删除 Moonshot 的配置。把它们都保留下来，这样你就可以根据任务需求，随时在两个模型之间切换，非常灵活。

这是我的完整配置示例

{
  "env": {
    "MOONSHOT_API_KEY": "sk-..."
  },
  "providers": {
    "qwen-portal": {
      "baseUrl": "https://portal.qwen.ai/v1"
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "qwen-portal/coder-model"
      }
    },
    "models": {
      "moonshot/kimi-k2.5": { "alias": "Kimi K2.5" },
      "qwen-portal/coder-model": { "alias": "Qwen Coder" },
      "qwen-portal/vision-model": { "alias": "Qwen Vision" }
    }
  }
}

快速切换命令，记下这几个就够用了

# 想用 Qwen 写代码时
openclaw models set qwen-portal/coder-model

# 想切回熟悉的 Moonshot (Kimi) 时
openclaw models set moonshot/kimi-k2.5

# 看看我目前配置了哪些模型
openclaw models list

---

Qwen 有哪些模型可用？

目前我测试下来，Qwen 提供了两个主要的模型，各有侧重：

模型 ID	说明	我主要用它来干嘛
qwen-portal/coder-model	Qwen Coder	代码生成、代码审查、Debug，写脚本和函数时很顺手
qwen-portal/vision-model	Qwen Vision	图像理解、OCR、分析图表，处理带图的文档时用

---

关于 Qwen 认证，你需要知道的

Qwen OAuth 的特点

• 免费额度： 每天有 2,000 次请求，对于日常开发和小项目来说，基本够用了。
• Token 自动刷新： 这是我最喜欢的一点，不用老惦记着去手动续期，省心。
• 设备码认证： 通过浏览器授权，感觉比直接处理密钥更安全一些。

如何管理 Token

# 如果 Token 过期了或者刷新失败，重新登录一下就好
openclaw models auth login --provider qwen-portal

# 想查看详细的认证信息（比如过期时间），可以用 --json 参数
openclaw models status --json

---

我遇到过的常见问题及解法

Q1: 启用插件后，命令还是提示 qwen-portal provider 不存在

症状： 执行 openclaw models auth login 时报错。

我的解决步骤：

# 首先，再确认一遍插件确实启用了
openclaw plugins enable qwen-portal-auth
# 关键一步：重启 Gateway 服务（或者直接重启你的终端）

通常重启服务后问题就解决了。

Q2: OAuth 认证流程走完了，但还是提示失败

症状： 浏览器显示授权成功，但命令行里还是报认证错误。

我是这么排查的：
1. 确认浏览器页面确实跳转到了“授权成功”的提示页，而不仅仅是登录。
2. 检查电脑的网络连接，特别是代理设置。
3. 关掉终端，重新运行一遍认证命令。

Q3: 怎么快速确认现在用的是哪个模型？

# 最直接的方法
openclaw models status

# 或者在 Open Claw 的对话里，直接问它：“你现在是什么模型？”

后者有时候也挺有趣的。

Q4: 切换到 Qwen 后，又想用回 Moonshot 了怎么办？

很简单，一条命令切回去：

openclaw models set moonshot/kimi-k2.5

这就是保留旧配置的好处，切换毫无压力。

---

命令速查表（Moonshot vs Qwen）

为了方便对比记忆，我把两个模型的关键操作命令列在了一起：

操作	Moonshot	Qwen
认证	openclaw onboard --auth-choice moonshot-api-key	openclaw models auth login --provider qwen-portal
切换模型	openclaw models set moonshot/kimi-k2.5	openclaw models set qwen-portal/coder-model
查看状态	openclaw models status	openclaw models status

---

我的切换检查清单

按照这个清单一步步来，基本不会出错：

• [ ] 已启用 qwen-portal-auth 插件
• [ ] 已完成 Qwen 的 OAuth 认证（浏览器授权成功）
• [ ] 已执行命令将默认模型切换到 Qwen（如 coder-model）
• [ ] 已运行 openclaw models status 验证显示正确
• [ ] （可选）已简单测试 Qwen 模型，能正常对话和生成代码

---

相关文档

如果你想了解更多细节，可以查阅这些文档：

• Open Claw 切换模型操作手册
• Open Claw Qwen 模型配置指南
• Open Claw Moonshot AI 模型配置指南

---

最后更新：2026-03-08