Qwen
Qwen Cloud 是 OpenClaw 的官方外部提供商插件,其规范 ID 为 qwen。它面向 Qwen Cloud / 阿里云 DashScope 的 Standard 和 Coding Plan 端点,将 Token Plan 以 qwen-token-plan 的形式提供,保留 modelstudio 作为兼容性别名,并独立持有阿里云文档中记录的 bailian-token-plan 自定义提供商 ID。
| 属性 | 值 |
|---|---|
| 提供商 | qwen |
| Token Plan 提供商 | qwen-token-plan |
| 首选环境变量 | QWEN_API_KEY |
| Token Plan 环境变量 | QWEN_TOKEN_PLAN_API_KEY |
| 也接受(兼容) | MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY |
| API 风格 | OpenAI 兼容 |
Tip
qwen3.7-plus 和 qwen3.6-plus 可用于 Coding Plan 和 Standard 端点。
对于 qwen3.8-max 或 qwen3.8-flash,请使用 Standard(按量付费) 或 Token Plan。
较旧的 Coding Plan 不包含这些模型。qwen3.7-max 和 qwen3.6-flash
同样要求使用 Standard 或 Token Plan。
安装插件¶
qwen 作为官方外部插件提供,不与核心捆绑。安装方式如下:
安装会自动应用到正在运行的 Gateway;否则将在下次启动时生效。请参阅 应用更改并检查。
快速开始¶
选择你的方案类型,然后按照设置步骤操作。
**适用场景:** 通过 Qwen Coding Plan 获得基于订阅的访问。
1. 获取你的 API 密钥
从 home.qwencloud.com/api-keys 创建或复制 API 密钥。
2. 运行引导流程
对于 Global(全球) 端点:
对于 China(中国大陆) 端点:
3. 设置默认模型
4. 验证模型可用
Note
旧的 modelstudio-* auth-choice ID 和 modelstudio/... 模型引用仍然
可作为兼容别名使用,但新的设置流程应优先使用规范的
qwen-* auth-choice ID 和 qwen/... 模型引用。如果你定义了
具有其他 api 值的精确自定义 models.providers.modelstudio 条目,
则该自定义提供商会拥有 modelstudio/... 引用,而不是 Qwen 的兼容
别名。
**适用场景:** 通过 Standard Model Studio 端点获得按量付费访问,包括 `qwen3.8-max` 和 `qwen3.8-flash` —— 这些模型在较旧的 Coding Plan 中不可用。
1. 获取你的 API 密钥
从 home.qwencloud.com/api-keys 创建或复制 API 密钥。
2. 运行引导流程
对于 Global(全球) 端点:
对于 China(中国大陆) 端点:
3. 设置默认模型
4. 验证模型可用
Note
旧的 modelstudio-* auth-choice ID 和 modelstudio/... 模型引用仍然
可作为兼容别名使用,但新的设置流程应优先使用规范的
qwen-* auth-choice ID 和 qwen/... 模型引用。如果你定义了
具有其他 api 值的精确自定义 models.providers.modelstudio 条目,
则该自定义提供商会拥有 modelstudio/... 引用,而不是 Qwen 的兼容
别名。
**适用场景:** 通过阿里云 Model Studio,以基于额度的团队订阅方式访问 Qwen 和受支持的第三方模型。
1. 获取你的专属密钥
分配一个 Token Plan 席位,并创建其专属的 sk-sp-... 密钥。Token Plan、Coding Plan 和按量付费密钥不可互换。请参阅 Global Token Plan 概览 或 China Token Plan 概览。
2. 运行引导流程
对于位于新加坡的 Global / International(全球/国际) 端点:
对于位于北京的 China(中国大陆) 端点:
3. 验证提供商
openclaw models list --provider qwen-token-plan
openclaw agent --model qwen-token-plan/qwen3.7-plus --message "Reply with: token plan ready"
Note
阿里云的 OpenClaw 指南使用 bailian-token-plan 作为手动自定义提供商的 ID。
该插件将此 ID 注册为兼容所有者,但新配置应使用 qwen-token-plan。
精确的自定义 models.providers.bailian-token-plan 条目会保留对其已配置
传输和目录的所有权;它永远不会被合并到规范的 OpenAI 目录中。
Warning
仅将 Token Plan 用于交互式 OpenClaw 会话。不要为 cron 任务、 无人值守脚本或应用程序后端选择它。阿里云声明,非交互式使用 可能导致订阅被暂停或 API 密钥被吊销。
已停用的 Qwen Portal 认证¶
qwen-oauth Portal 提供商及其旧版 OAuth 流程已被移除。
Portal 令牌不能与 Qwen Cloud 或 DashScope API 密钥互换。
使用当前的 Qwen 插件需要为所选端点重新进行 API 密钥认证,
并更新模型配置。请按照
安装插件 和
快速开始 操作;现有的 Portal 凭据
不会被自动转换。
套餐类型与端点¶
| 套餐 | 区域 | 认证方式 | 端点 |
|---|---|---|---|
| Coding Plan(订阅) | 中国 | qwen-api-key-cn |
coding.dashscope.aliyuncs.com/v1 |
| Coding Plan(订阅) | 全球 | qwen-api-key |
coding-intl.dashscope.aliyuncs.com/v1 |
| Standard(按量付费) | 中国 | qwen-standard-api-key-cn |
dashscope.aliyuncs.com/compatible-mode/v1 |
| Standard(按量付费) | 全球 | qwen-standard-api-key |
dashscope-intl.aliyuncs.com/compatible-mode/v1 |
| Token Plan(团队版) | 中国 | qwen-token-plan-cn |
token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 |
| Token Plan(团队版) | 全球 | qwen-token-plan |
token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 |
提供商会根据你的认证方式自动选择端点。标准选择使用 qwen-* 系列;modelstudio-* 仅作兼容性保留。可通过配置中的自定义 baseUrl 进行覆盖。
Tip
管理密钥: home.qwencloud.com/api-keys | 文档: docs.qwencloud.com
内置目录¶
设置会保留连接设置和模型别名(包括 modelstudio 别名),而不会将生成的目录行复制到你的配置中。显式设置 models.mode: "replace" 会保持目录种子填充功能启用;自定义模型行将保持不变。
OpenClaw 会从已配置端点的经过认证的 /models API 发现模型。该插件保留以下种子元数据,用于离线发现以及仅返回模型 ID 的端点。Coding Plan 配置会省略该套餐不包含的模型;Standard 模型列表并不代表拥有 Token Plan 或 Coding Plan 的访问权限。
| 模型引用 | 输入 | 上下文 | 备注 |
|---|---|---|---|
qwen/qwen3.5-plus |
文本、图像 | 1,000,000 | 默认模型 |
qwen/qwen3.6-flash |
文本、图像 | 1,000,000 | 仅 Standard 端点 |
qwen/qwen3.6-plus |
文本、图像 | 1,000,000 | Coding Plan + Standard |
qwen/qwen3.7-max |
文本 | 1,000,000 | 仅 Standard 端点 |
qwen/qwen3.7-plus |
文本、图像 | 1,000,000 | Coding Plan + Standard |
qwen/qwen3.8-max |
文本、图像 | 1,000,000 | 仅 Standard 端点 |
qwen/qwen3.8-flash |
文本、图像 | 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 |
Token Plan 目录¶
Token Plan 使用单独的精确字符串允许列表。内置目录显示阿里巴巴当前推荐的套餐模型,并将较新的 Qwen3-Coder 兼容层级保持可选但隐藏状态。其他被列入允许列表的模型 ID 仍可作为自定义模型引用使用。仅用于图像生成的套餐模型不包含在此处,因为它们使用不同的 API。
| 模型引用 | 输入 | 上下文 | 选择器状态 |
|---|---|---|---|
qwen-token-plan/qwen3.7-plus |
文本、图像 | 1,000,000 | 可见 |
qwen-token-plan/qwen3.8-max |
文本、图像 | 1,000,000 | 可见 |
qwen-token-plan/qwen3.8-flash |
文本、图像 | 1,000,000 | 可见 |
qwen-token-plan/qwen3.6-plus |
文本、图像 | 1,000,000 | 可见 |
qwen-token-plan/qwen3-coder-next |
文本 | 262,144 | 隐藏 |
qwen-token-plan/kimi-k2.5 |
文本、图像 | 262,144 | 可见 |
qwen-token-plan/glm-5 |
文本 | 202,752 | 可见 |
qwen-token-plan/MiniMax-M2.5 |
文本 | 196,608 | 可见 |
思考控制¶
Agent 运行和独立补全使用相同的模型特定思考控制,包括 Token Plan 的工具选择和推理重放要求。
qwen3.8-max 和 qwen3.8-flash 支持 off、low、medium 和 xhigh 思考级别,默认值为 xhigh。minimal 映射为 low;high 和 max 映射为 xhigh。这适用于 Standard 和 Token Plan。两个模型都支持 131,072 个输出 Token。在工具使用期间,OpenClaw 会将返回的推理内容保留在独立的 reasoning_content 重放字段中,而不是将其放入可见的答案文本中。
请求参数中的显式 thinking_budget 优先于映射后的 reasoning_effort:Qwen 会拒绝同时包含两者的请求。请参阅 Qwen 思考参考。
qwen3.7-max、qwen3.7-plus、qwen3.6-flash 和 qwen3.6-plus 在内置目录中已启用推理。对于 qwen 系列中的推理模型,提供商会将 OpenClaw 思考级别映射到 DashScope 的顶层 enable_thinking 请求标志:禁用思考时发送 enable_thinking: false,任何其他级别发送 enable_thinking: true。自定义模型可以通过在模型条目上设置 compat.thinkingFormat: "qwen-chat-template" 来选择使用备用的聊天模板思考负载。
Token Plan 模型也被标记为具备推理能力。kimi-k2.7-code 和
MiniMax-M2.5 仅支持思考,因此即使会话请求 /think off,OpenClaw 也会保持思考启用。DeepSeek V4 将 minimal 到 high 映射到服务端的 high 强度,并将 xhigh 或 max 映射到 max。GLM 5.2 接受完整的 minimal 到 max 范围;GLM 5.1 和 GLM 5 接受到 xhigh,并且三者默认均为 high。其他混合模型遵循请求的开启/关闭状态。
多模态附加功能¶
qwen 插件仅在 Standard DashScope 端点上暴露多模态能力,不适用于 Coding Plan 端点:
- 图像和视频理解 通过
qwen3.6-plus - Wan 视频生成 通过
wan2.6-t2v(默认)、wan2.6-i2v、wan2.6-r2v、wan2.6-r2v-flash、wan2.7-r2v
媒体理解会从已配置的 Qwen 认证中自动解析;无需额外配置。请确保使用 Standard(按量付费)端点,媒体理解才能正常工作。
视频生成¶
使用来自 Standard 端点的 QWEN_API_KEY。要将 Qwen 设为默认视频提供商:
当恰好有一个参考图像且没有视频时,wan2.6-t2v 会自动使用 wan2.6-i2v;结果会报告解析后的模型。此路由仅当已知模型目录中存在同代图生视频同级模型时适用。其他请求使用所选模型的模式:
| 模式 | 模型 | 参考限制 | 最大时长 | 支持的参数 |
|---|---|---|---|---|
| 文生视频 | wan2.6-t2v |
不适用 | 15 秒 | size、aspectRatio、resolution、audio、watermark |
| 图生视频 | wan2.6-i2v |
1 张图片 | 15 秒 | resolution、audio、watermark |
| 参考生视频(Wan 2.6) | wan2.6-r2v、wan2.6-r2v-flash |
共 5 个图片/视频;最多 3 个视频 | 10 秒 | size、aspectRatio、resolution、audio、watermark |
| 参考生视频(Wan 2.7) | wan2.7-r2v |
共 5 个图片/视频;最多 3 个视频 | 10 秒 | size、aspectRatio、resolution、watermark;音频始终开启 |
Wan 2.6 文本/参考模型会将 resolution 加上 aspectRatio 转换为文档中规定的精确 size。Wan 2.6 图生视频会发送 resolution 级别,并使用输入图像的宽高比。Wan 2.7 参考生视频会发送 media、resolution 和 ratio,并且始终生成音频。
图生视频和 Wan 2.7 参考图像接受本地文件或远程 http(s) URL。本地图像以 base64 data URI 发送,编码前每张图像最大 20 MB,符合 Wan 图像输入限制。参考视频和 Wan 2.6 参考生视频图像仍要求使用远程 http(s) URL。
Note
有关共享工具参数、提供商选择和故障转移行为,请参阅 视频生成。
高级配置¶
Qwen 模型可用性
qwen3.7-plus 和 qwen3.6-plus 可在 Coding Plan 和 Standard 端点上使用。对于 qwen3.8-max、qwen3.8-flash、qwen3.7-max 或 qwen3.6-flash,请使用 Standard 或 Token Plan。Standard(按量付费)端点如下:
- 中国:
dashscope.aliyuncs.com/compatible-mode/v1 - 全球:
dashscope-intl.aliyuncs.com/compatible-mode/v1
OpenClaw 会从 Coding Plan 目录中省略这些模型。如果 Coding Plan 端点返回“不支持的模型”错误,请切换到对应的 Standard 或 Token Plan 端点及其专用密钥。
视频生成区域路由
OpenClaw 在提交视频任务之前,会将已配置的 Qwen 区域映射到对应的 DashScope AIGC 主机:
- 全球/国际:
https://dashscope-intl.aliyuncs.com - 中国:
https://dashscope.aliyuncs.com
普通的 models.providers.qwen.baseUrl 即使指向 Coding Plan 或 Standard Qwen 主机,视频生成仍会路由到对应的区域性 DashScope 视频端点。
流式用量兼容性
原生 Qwen 端点在共享的 openai-completions 传输层上声明支持流式用量兼容性,因此指向相同原生主机的 DashScope 兼容自定义 provider id 会继承相同行为,而不需要特别使用内置的 qwen provider id。这适用于 Coding Plan、Standard 和 Token Plan 端点:
https://coding.dashscope.aliyuncs.com/v1https://coding-intl.dashscope.aliyuncs.com/v1https://dashscope.aliyuncs.com/compatible-mode/v1https://dashscope-intl.aliyuncs.com/compatible-mode/v1https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
功能计划
qwen 插件目前覆盖 Qwen Cloud 功能面的哪些部分:
- 文本/聊天模型: 通过插件可用
- 工具调用、结构化输出、思考: 继承自 OpenAI 兼容传输层
- 图像/视频理解: 通过插件在 Standard 端点上可用
- 视频生成: 通过插件借助共享的视频生成功能可用
- 图像生成: 插件未暴露
- 语音/音频: 插件未暴露
- 记忆嵌入/重排序: 插件未暴露
环境和守护进程设置
如果 Gateway 作为守护进程(launchd/systemd)运行,请确保 QWEN_API_KEY
或 QWEN_TOKEN_PLAN_API_KEY 对该进程可用(例如,在
~/.openclaw/.env 中或通过 env.shellEnv)。
相关¶
选择提供商、模型引用和故障转移行为。
共享视频工具参数和提供商选择。
同一 DashScope 平台上捆绑的 Wan 视频生成提供商。
通用故障排查和常见问题解答。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw