Appearance
本页介绍如何在 OpenClaw 中配置通义千问（Qwen）提供商。旧版 Qwen OAuth 免费接入（qwen-portal）已下线；现推荐使用官方 API Key，支持 Coding Plan（按订阅计费）和 Standard（按量付费）两种套餐、国内外双端点。内置模型目录包含 qwen3.5-plus、qwen3.6-plus、qwen3-coder-next 等主流模型，并支持 Wan 视频生成能力。
通义千问（Qwen）
警告：Qwen OAuth 已下线。 原来通过
portal.qwen.ai端点的免费 OAuth 接入（qwen-portal）已不可用。详见 Issue #49557。
OpenClaw 现将 Qwen 作为一级内置提供商，规范 ID 为 qwen，支持阿里云 DashScope 的 Coding Plan 和 Standard 端点，并保留旧版 modelstudio ID 作为兼容别名。
- Provider：
qwen - 优先环境变量：
QWEN_API_KEY - 兼容别名：
MODELSTUDIO_API_KEY、DASHSCOPE_API_KEY - API 风格：OpenAI 兼容
快速上手
bash
# 全球 Coding Plan 端点
openclaw onboard --auth-choice qwen-api-key
# 中国区 Coding Plan 端点
openclaw onboard --auth-choice qwen-api-key-cn
# 全球 Standard（按量付费）端点
openclaw onboard --auth-choice qwen-standard-api-key
# 中国区 Standard（按量付费）端点
openclaw onboard --auth-choice qwen-standard-api-key-cn接入后设置默认模型：
json5
{
agents: {
defaults: {
model: { primary: "qwen/qwen3.5-plus" },
},
},
}套餐与端点对应表
| 套餐 | 区域 | Auth 选项 | 端点 |
|---|---|---|---|
| Standard（按量付费） | 中国区 | qwen-standard-api-key-cn | dashscope.aliyuncs.com/compatible-mode/v1 |
| Standard（按量付费） | 全球 | qwen-standard-api-key | dashscope-intl.aliyuncs.com/compatible-mode/v1 |
| Coding Plan（订阅） | 中国区 | qwen-api-key-cn | coding.dashscope.aliyuncs.com/v1 |
| Coding Plan（订阅） | 全球 | qwen-api-key | coding-intl.dashscope.aliyuncs.com/v1 |
如果需要
qwen3.6-plus，优先选择 Standard 按量付费端点——Coding Plan 端点可能滞后于公开目录更新。
获取 API Key
内置模型目录
| 模型 | 输入 | 上下文 | 备注 |
|---|---|---|---|
qwen/qwen3.5-plus | 文本、图像 | 1,000,000 | 默认模型 |
qwen/qwen3.6-plus | 文本、图像 | 1,000,000 | 推荐 Standard 端点 |
qwen/qwen3-max-2026-01-23 | 文本 | 262,144 | Qwen Max 系列 |
qwen/qwen3-coder-next | 文本 | 262,144 | 编码专用 |
qwen/qwen3-coder-plus | 文本 | 1,000,000 | 编码专用 |
qwen/MiniMax-M2.5 | 文本 | 1,000,000 | 推理模型 |
qwen/glm-5 | 文本 | 202,752 | GLM 系列 |
qwen/glm-4.7 | 文本 | 202,752 | GLM 系列 |
qwen/kimi-k2.5 | 文本、图像 | 262,144 | 通过阿里云接入的 Moonshot AI |
即使模型在内置目录中，实际可用性仍取决于你的端点和计费套餐。
多模态能力
Qwen 扩展还提供：
- 视频理解：
qwen-vl-max-latest - 视频生成（Wan 系列）：
wan2.6-t2v（默认）、wan2.6-i2v、wan2.6-r2v、wan2.6-r2v-flash、wan2.7-r2v
多模态功能使用 Standard DashScope 端点，不走 Coding Plan 端点。
设置 Qwen 为默认视频提供商：
json5
{
agents: {
defaults: {
videoGenerationModel: { primary: "qwen/wan2.6-t2v" },
},
},
}当前 Qwen 视频生成限制：
- 每次最多 1 个输出视频
- 参考输入：最多 1 张图像，或最多 4 段视频
- 最长时长：10 秒
- 支持
size、aspectRatio、resolution、audio、watermark - 参考图像/视频必须是远程 https URL——DashScope 视频端点不接受本地文件路径
旧版 ModelStudio 迁移
旧版 modelstudio-* auth 选项和 modelstudio/... 模型 ID 仍作为兼容别名保留，但新配置应优先使用规范的 qwen-* auth 选项和 qwen/... 模型 ID。
环境注意事项
如果 Gateway 作为守护进程（launchd/systemd）运行，确保 QWEN_API_KEY 对该进程可用（例如在 ~/.openclaw/.env 中或通过 env.shellEnv）。
常见问题
Q: Qwen OAuth 已下线，我现有的配置怎么迁移？
A: 运行 openclaw onboard --auth-choice qwen-api-key（或 cn 版本）重新完成接入向导，用正式 API Key 替换旧的 OAuth 配置。模型 ID 从 qwen-portal/... 改为 qwen/...，其余配置结构不变。
Q: qwen3.6-plus 总是提示"不支持此模型"，怎么解决？
A: qwen3.6-plus 仅在 Standard（按量付费）DashScope 端点上可用，Coding Plan 端点可能尚未上线。切换到 qwen-standard-api-key 或 qwen-standard-api-key-cn，再重新测试即可。
Q: Wan 视频生成时提示本地文件路径不被支持，怎么办？
A: DashScope 视频端点只接受远程 https:// URL 作为参考图像或视频输入，不支持上传本地文件。需要先将本地文件上传到 OSS 或其他可公开访问的存储，再将 URL 传入参数。