提供商
Qwen
Qwen Cloud 是官方的 OpenClaw 外部提供商插件,规范 id 为 qwen。它面向 Qwen Cloud / Alibaba DashScope 标准版和 Coding Plan 端点,将 Token Plan 公开为 qwen-token-plan,保留 modelstudio 作为兼容别名,独立拥有阿里巴巴文档中定义的 bailian-token-plan 自定义提供商 id,并通过 qwen-oauth 提供 Qwen Portal 令牌流程。
| 属性 | 值 |
|---|---|
| 提供商 | qwen |
| Token Plan 提供商 | qwen-token-plan |
| Portal 提供商 | qwen-oauth |
| 首选环境变量 | 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 (subscription)
**最适合:**通过 Qwen Coding Plan 以订阅方式访问。
Get your API key
从 home.qwencloud.com/api-keys 创建或复制 API key。
Run onboarding
对于全球端点:
openclaw onboard --auth-choice qwen-api-key对于中国端点:
openclaw onboard --auth-choice qwen-api-key-cnSet a default model
{ agents: { defaults: { model: { primary: "qwen/qwen3.5-plus" }, }, },}Verify the model is available
openclaw models list --provider qwenStandard (pay-as-you-go)
**最适合:**通过标准版 Model Studio 端点按量付费访问,包括 Coding Plan 不提供的 qwen3.7-max 和 qwen3.6-flash。
Get your API key
从 home.qwencloud.com/api-keys 创建或复制 API key。
Run onboarding
对于全球端点:
openclaw onboard --auth-choice qwen-standard-api-key对于中国端点:
openclaw onboard --auth-choice qwen-standard-api-key-cnSet a default model
{ agents: { defaults: { model: { primary: "qwen/qwen3.5-plus" }, }, },}Verify the model is available
openclaw models list --provider qwenToken Plan (Team Edition)
**最适合:**通过 Alibaba Cloud Model Studio,以额度制团队订阅方式访问 Qwen 和受支持的第三方模型。
Get your dedicated key
分配一个 Token Plan 席位并创建其专用的 sk-sp-... key。Token Plan、Coding Plan 和按量付费 key 不能互换使用。请参阅全球 Token Plan 概览或中国 Token Plan 概览。
Run onboarding
对于位于新加坡的全球 / 国际端点:
openclaw onboard --auth-choice qwen-token-plan对于位于北京的中国端点:
openclaw onboard --auth-choice qwen-token-plan-cnVerify the provider
openclaw models list --provider qwen-token-planopenclaw agent --model qwen-token-plan/qwen3.7-plus --message "Reply with: token plan ready"Qwen OAuth / Portal
**最适合:**将 Qwen Portal 令牌用于 https://portal.qwen.ai/v1。
有关专用提供商页面和迁移说明,请参阅 Qwen OAuth / Portal。
Provide your portal token
openclaw onboard --auth-choice qwen-oauthSet a default model
{ agents: { defaults: { model: { primary: "qwen-oauth/qwen3.5-plus" }, }, },}Verify the model is available
openclaw models list --provider qwen-oauth计划类型和端点
| 计划 | 区域 | 身份验证选项 | 端点 |
|---|---|---|---|
| Coding Plan(订阅) | 中国 | qwen-api-key-cn |
coding.dashscope.aliyuncs.com/v1 |
| Coding Plan(订阅) | 全球 | qwen-api-key |
coding-intl.dashscope.aliyuncs.com/v1 |
| Qwen Portal | 全球 | qwen-oauth |
portal.qwen.ai/v1 |
| 标准版(按量付费) | 中国 | qwen-standard-api-key-cn |
dashscope.aliyuncs.com/compatible-mode/v1 |
| 标准版(按量付费) | 全球 | 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 配置会省略仅适用于标准版端点的模型。
| 模型引用 | 输入 | 上下文 | 说明 |
|---|---|---|---|
qwen/qwen3.5-plus |
文本、图像 | 1,000,000 | 默认模型 |
qwen/qwen3.6-flash |
文本、图像 | 1,000,000 | 仅限标准版端点 |
qwen/qwen3.6-plus |
文本、图像 | 1,000,000 | Coding Plan + 标准版 |
qwen/qwen3.7-max |
文本 | 1,000,000 | 仅限标准版端点 |
qwen/qwen3.7-plus |
文本、图像 | 1,000,000 | Coding Plan + 标准版 |
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-oauth/qwen3.5-plus |
文本、图像 | 1,000,000 | Qwen Portal 默认模型 |
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 插件仅在 DashScope 的 Standard 端点上提供多模态能力,Coding Plan 端点不支持这些能力:
- 通过
qwen-vl-max-latest实现图像和视频理解 - 通过
wan2.6-t2v(默认)、wan2.6-i2v、wan2.6-r2v、wan2.6-r2v-flash、wan2.7-r2v实现 Wan 视频生成
系统会根据已配置的 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 提供)。