提供商
Qwen
Qwen Cloud 是官方外部 OpenClaw 提供商插件,规范 id 为 qwen。它面向 Qwen Cloud / Alibaba DashScope Standard 和 Coding Plan 端点,将 Token Plan 公开为 qwen-token-plan,保留 modelstudio 作为兼容性别名,并独立拥有 Alibaba 文档中所述的 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 兼容 |
安装插件
qwen 作为官方外部插件发布,不与核心捆绑。安装它并重启 Gateway 网关:
openclaw plugins install @openclaw/qwen-provideropenclaw gateway restart入门指南
选择你的计划类型,然后按照设置步骤操作。
Coding Plan(订阅)
**最适合:**通过 Qwen Coding Plan 获得基于订阅的访问权限。
获取 API 密钥
在 home.qwencloud.com/api-keys 创建或复制 API 密钥。
运行新手引导
对于全球端点:
openclaw onboard --auth-choice qwen-api-key对于中国端点:
openclaw onboard --auth-choice qwen-api-key-cn设置默认模型
{ agents: { defaults: { model: { primary: "qwen/qwen3.5-plus" }, }, },}验证模型是否可用
openclaw models list --provider qwenStandard(按量付费)
**最适合:**通过 Standard Model Studio 端点进行按量付费访问,包括 Coding Plan 不提供的 qwen3.7-max 和 qwen3.6-flash。
获取 API 密钥
在 home.qwencloud.com/api-keys 创建或复制 API 密钥。
运行新手引导
对于全球端点:
openclaw onboard --auth-choice qwen-standard-api-key对于中国端点:
openclaw onboard --auth-choice qwen-standard-api-key-cn设置默认模型
{ agents: { defaults: { model: { primary: "qwen/qwen3.5-plus" }, }, },}验证模型是否可用
openclaw models list --provider qwenToken Plan(团队版)
**最适合:**通过 Alibaba Cloud Model Studio,以基于额度的团队订阅方式访问 Qwen 和支持的第三方模型。
获取专用密钥
分配一个 Token Plan 席位,并创建其专用的 sk-sp-... 密钥。Token Plan、Coding Plan 和按量付费密钥不可互换。请参阅全球 Token Plan 概览或中国 Token Plan 概览。
运行新手引导
对于位于新加坡的全球 / 国际端点:
openclaw onboard --auth-choice qwen-token-plan对于位于北京的中国端点:
openclaw onboard --auth-choice qwen-token-plan-cn验证提供商
openclaw models list --provider qwen-token-planopenclaw agent --model qwen-token-plan/qwen3.7-plus --message "Reply with: token plan ready"计划类型和端点
| 计划 | 区域 | 身份验证选择 | 端点 |
|---|---|---|---|
| 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 覆盖。
内置目录
OpenClaw 随附此 Qwen 静态目录。该目录能够感知端点:Coding Plan 配置会省略仅适用于 Standard 端点的模型。
| 模型引用 | 输入 | 上下文 | 说明 |
|---|---|---|---|
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-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 | 通过 Alibaba 使用 Moonshot AI |
Token Plan 目录
Token Plan 使用单独的精确字符串允许列表。此处不包括仅用于图像生成的计划 模型,因为它们使用不同的 API。
| 模型引用 | 输入 | 上下文 |
|---|---|---|
qwen-token-plan/qwen3.7-max |
文本 | 1,000,000 |
qwen-token-plan/qwen3.7-plus |
文本、图像 | 1,000,000 |
qwen-token-plan/qwen3.6-plus |
文本、图像 | 1,000,000 |
qwen-token-plan/qwen3.6-flash |
文本、图像 | 1,000,000 |
qwen-token-plan/deepseek-v4-pro |
文本 | 1,000,000 |
qwen-token-plan/deepseek-v4-flash |
文本 | 1,000,000 |
qwen-token-plan/deepseek-v3.2 |
文本 | 131,072 |
qwen-token-plan/kimi-k2.7-code |
文本、图像 | 262,144 |
qwen-token-plan/kimi-k2.6 |
文本、图像 | 262,144 |
qwen-token-plan/kimi-k2.5 |
文本、图像 | 262,144 |
qwen-token-plan/glm-5.2 |
文本 | 1,000,000 |
qwen-token-plan/glm-5.1 |
文本 | 202,752 |
qwen-token-plan/glm-5 |
文本 | 202,752 |
qwen-token-plan/MiniMax-M2.5 |
文本 | 196,608 |
思考控制
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(按量付费) 端点。
要将 Qwen 设为默认视频提供商:
{ agents: { defaults: { videoGenerationModel: { primary: "qwen/wan2.6-t2v" }, }, },}视频生成限制:每个请求生成 1 个视频,最多可输入 1 张图片
(图生视频),最多可输入 4 个视频(视频生视频),最长时长为 10 秒。
支持 size、aspectRatio、resolution、audio 和
watermark。参考图片/视频输入必须使用远程 http(s) URL;本地
文件路径会被预先拒绝,因为 DashScope 视频端点不接受为这些参考项
上传的本地缓冲区。
高级配置
Qwen 3.6 和 3.7 可用性
qwen3.7-plus 和 qwen3.6-plus 可用于 Coding Plan 和 Standard 端点。qwen3.7-max 和 qwen3.6-flash 仅限 Standard。Standard(按量付费)端点为:
- 中国:
dashscope.aliyuncs.com/compatible-mode/v1 - 全球:
dashscope-intl.aliyuncs.com/compatible-mode/v1
OpenClaw 会从 Coding Plan 目录中省略 qwen3.7-max 和 qwen3.6-flash。
如果 Coding Plan 端点针对其中任一模型返回“unsupported model”错误,
请切换到匹配的 Standard 端点和密钥。
视频生成区域路由
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 的自定义提供商 ID
会继承相同行为,无需专门使用内置的 qwen 提供商 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)。