我在 OpenClaw 中配置 Qwen（通义千问）模型的实战经验

概述

今天我想和大家分享一下，我是如何在 OpenClaw 中配置和使用 Qwen（通义千问）模型的。Qwen 提供了免费的 OAuth 认证流程，并且支持 Qwen Coder 和 Qwen Vision 这两个非常实用的模型。

免费额度方面，目前是每天 2,000 次请求，不过这个额度会受到 Qwen 官方速率限制的影响，大家在使用时需要注意一下。

---

快速开始：我的配置步骤

步骤 1：启用插件

首先，我们需要启用对应的插件。打开终端，输入以下命令：

openclaw plugins enable qwen-portal-auth

注意：启用插件后，一定要记得重启 Gateway 服务，否则插件不会生效。

步骤 2：认证登录

接下来就是进行认证了。运行这个命令：

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

这个命令会做几件事：
- 启动 Qwen 的 device-code OAuth 流程，你只需要按照提示在浏览器中完成授权即可。
- 在你的 models.json 配置文件中写入 provider 条目。
- 自动创建一个 qwen 别名，方便我们后续快速切换模型。

步骤 3：切换模型

认证成功后，我们就可以切换到具体的模型了。比如，我想用代码模型：

openclaw models set qwen-portal/coder-model

整个过程非常顺畅，几分钟就能搞定。

---

可用模型

目前 OpenClaw 支持以下两个 Qwen 模型，大家可以根据自己的需求选择：

模型 ID	说明
qwen-portal/coder-model	Qwen Coder 代码模型，编程助手
qwen-portal/vision-model	Qwen Vision 视觉模型，支持图像理解

---

复用 Qwen Code CLI 的登录状态

如果你和我一样，之前已经在本地使用过 Qwen Code CLI 并且登录过了，那么 OpenClaw 可以非常方便地复用你的凭证，省去了重复登录的麻烦。

自动同步机制

OpenClaw 在加载认证信息时，会自动从以下路径同步凭证：

~/.qwen/oauth_creds.json

仍需创建 provider 条目

不过，即使凭证同步过来了，我们仍然需要运行一次登录命令，目的是在 OpenClaw 的配置中创建对应的 provider 条目。命令很简单：

openclaw models auth login --provider qwen-portal

---

配置细节说明

默认 Base URL

Qwen 模型的默认 API 地址是：

https://portal.qwen.ai/v1

如何自定义 Base URL

如果未来 Qwen 提供了不同的 endpoint，或者你有特殊需求，可以在配置文件中覆盖这个地址。这是我的配置示例：

models:
  providers:
    qwen-portal:
      baseUrl: https://custom-endpoint.qwen.ai/v1

---

关于认证，你需要知道这些

Token 的自动刷新

好消息是，认证令牌（Token）会自动刷新，你一般不需要手动干预。但我也遇到过刷新失败的情况，通常是因为访问权限被撤销了。

访问被撤销后怎么办？

如果遇到 Token 失效或者访问被撤销，解决起来也很简单，重新登录一次就好：

# 重新登录
openclaw models auth login --provider qwen-portal --set-default

---

我的常用命令清单

为了方便大家查阅，我把整个配置和使用过程中最常用的命令整理成了表格：

操作	命令
启用插件	openclaw plugins enable qwen-portal-auth
认证登录	openclaw models auth login --provider qwen-portal --set-default
切换Coder模型	openclaw models set qwen-portal/coder-model
切换Vision模型	openclaw models set qwen-portal/vision-model
查看当前状态	openclaw models status
重启Gateway服务	openclaw restart（或者手动重启）

---

我的配置示例

models.json 配置示例

下面是我自己用的 models.json 配置文件，大家可以参考：

{
  "providers": {
    "qwen-portal": {
      "baseUrl": "https://portal.qwen.ai/v1"
    }
  },
  "agents": {
    "default": {
      "models": [
        {
          "id": "qwen-portal/coder-model"
        }
      ]
    }
  }
}

使用 qwen 别名的小技巧

登录命令会自动创建 qwen 这个别名，所以我们可以用更简短的命令来切换模型，非常方便：

# 以下两个命令是等价的
openclaw models set qwen-portal/coder-model
openclaw models set qwen/coder-model

---

我遇到过的故障及解决方法

在实际使用中，我也踩过一些坑，这里分享给大家，希望能帮你节省时间。

问题：插件未启用

症状： 运行认证命令时，提示 provider 不存在。

我的解决方法：

openclaw plugins enable qwen-portal-auth
# 然后一定要重启 Gateway

问题：Token 过期

症状： 调用 API 时返回 401 错误。

我的解决方法：

openclaw models auth login --provider qwen-portal

问题：无法同步 Qwen Code CLI 凭证

症状： 明明已经用 Qwen Code CLI 登录了，但 OpenClaw 就是识别不到。

我的排查步骤：
1. 首先确认 ~/.qwen/oauth_creds.json 这个文件是否存在。
2. 如果文件存在，就运行 openclaw models auth login --provider qwen-portal 重新创建一下 provider 条目。

问题：遇到速率限制

症状： 请求被拒绝，提示超过限制。

说明： 这是 Qwen 官方的限制，免费额度就是每天 2,000 次请求。如果不够用，需要去查阅 Qwen 的官方文档，看看是否有其他配额方案。

---

相关文档

如果你想深入了解 OpenClaw 的其他功能，可以看看这些文档：
- Open Claw 切换模型操作手册
- Open Claw Anthropic 模型配置指南
- 官方文档 - Qwen 配置

---

最后更新：2026-03-08