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 兼容

qwen3.7-plus 和 qwen3.6-plus 可用于 Coding Plan 和 Standard 端点。对于 qwen3.7-max 或 qwen3.6-flash，请使用 **Standard（按量付费）**端点。

安装插件

qwen 作为官方外部插件发布，不与核心捆绑。安装它并重启 Gateway 网关：

openclaw plugins install @openclaw/qwen-provider
openclaw gateway restart

入门指南

选择你的计划类型，然后按照设置步骤操作。

Coding Plan（订阅）
Standard（按量付费）
Token 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 qwen

旧版 modelstudio-* 身份验证选择 id 和 modelstudio/... 模型引用仍可作为兼容性别名使用，但新的设置流程应优先使用规范的 qwen-* 身份验证选择 id 和 qwen/... 模型引用。如果你定义了一个完全匹配的自定义 models.providers.modelstudio 条目并为其设置另一个 api 值，则该自定义提供商将拥有 modelstudio/... 引用，而不是 Qwen 兼容性别名。

**最适合：**通过 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 qwen

**最适合：**通过 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-plan
openclaw agent --model qwen-token-plan/qwen3.7-plus --message "Reply with: token plan ready"

Alibaba 的 OpenClaw 指南使用 bailian-token-plan 作为手动自定义提供商。该插件将此 id 注册为兼容性所有者，但新配置应使用 qwen-token-plan。完全匹配的自定义 models.providers.bailian-token-plan 条目继续拥有其配置的传输协议和目录；它绝不会被合并到规范的 OpenAI 目录中。

Token Plan 仅用于交互式 OpenClaw 会话。不要将其用于定时任务、无人值守脚本或应用程序后端。Alibaba 表示，非交互式使用可能导致订阅被暂停或其 API 密钥被撤销。

计划类型和端点

计划	区域	身份验证选择	端点
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 覆盖。

管理密钥：home.qwencloud.com/api-keys | 文档：docs.qwencloud.com

内置目录

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/v1
https://coding-intl.dashscope.aliyuncs.com/v1
https://dashscope.aliyuncs.com/compatible-mode/v1
https://dashscope-intl.aliyuncs.com/compatible-mode/v1
https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
https://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）。

模型选择

选择提供商、模型引用和故障转移行为。

视频生成

共享视频工具参数和提供商选择。

Alibaba Model Studio

同一 DashScope 平台上的内置 Wan 视频生成提供商。

故障排查

常规故障排查和常见问题。

概览

模型概念

提供商

安装插件

入门指南

计划类型和端点

内置目录

Token Plan 目录

思考控制

多模态附加功能

高级配置

相关内容

模型选择

视频生成

Alibaba Model Studio

故障排查

​安装插件

​入门指南

​计划类型和端点

​内置目录

​Token Plan 目录

​思考控制

​多模态附加功能

​高级配置

​相关内容

模型选择

视频生成

Alibaba Model Studio

故障排查

安装插件

入门指南

计划类型和端点

内置目录

Token Plan 目录

思考控制

多模态附加功能

高级配置

相关内容