OpenClaw 接入通义千问 Qwen 的推荐方式是使用正式 API Key，通过内置 qwen 提供商配置 Coding Plan（订阅）或 Standard（按量付费）双端点。旧版 Qwen OAuth 已下线，需运行 openclaw onboard --auth-choice qwen-api-key 或对应 cn/standard 选项完成配置；内置模型含 qwen3.5-plus、qwen3.6-plus 等，视频生成需 Standard 端点且引用 URL 必须为 https 远程地址。

OpenClaw 通义千问 Qwen API Key 配置与端点指南

警告：Qwen OAuth 已下线。 原来通过 portal.qwen.ai 端点的免费 OAuth 接入（qwen-portal）已不可用。背景见 Issue #49557。

OpenClaw 将 Qwen 作为一级内置提供商，规范 ID 为 qwen，目标阿里云 DashScope 和 Coding Plan 端点，并保留旧版 modelstudio ID 作为兼容别名。

• Provider：qwen
• 优先环境变量：QWEN_API_KEY
• 兼容别名：MODELSTUDIO_API_KEY、DASHSCOPE_API_KEY
• API 风格：OpenAI 兼容

提示： 若使用 qwen3.6-plus，优先选择 Standard 按量付费端点——Coding Plan 端点可能滞后于公开目录。

配置步骤

Coding Plan（订阅套餐）

适合基于订阅的 Qwen Coding Plan 用户。

1. 获取 API Key
   在 home.qwencloud.com/api-keys 创建或复制 API Key。

2. 运行引导

   • 全球端点：

     openclaw onboard --auth-choice qwen-api-key

   • 中国区端点：

     openclaw onboard --auth-choice qwen-api-key-cn

3. 设置默认模型

   {
     agents: {
       defaults: {
         model: { primary: "qwen/qwen3.5-plus" },
       },
     },
   }

4. 验证模型可用

   openclaw models list --provider qwen

注意： 旧版 modelstudio-* auth-choice ID 和 modelstudio/... 模型引用仍可作为兼容别名使用，但新配置推荐使用规范的 qwen-* auth-choice ID 和 qwen/... 模型引用。如果自定义配置了 models.providers.modelstudio 条目且设置了其他 api 值，则此自定义提供商将接管 modelstudio/... 引用，不再走 Qwen 兼容别名。

Standard（按量付费套餐）

适合按量付费的 Standard Model Studio 端点用户，包含 qwen3.6-plus 等 Coding Plan 不支持的模型。

1. 获取 API Key
   在 home.qwencloud.com/api-keys 创建或复制 API Key。

2. 运行引导

   • 全球端点：

     openclaw onboard --auth-choice qwen-standard-api-key

   • 中国区端点：

     openclaw onboard --auth-choice qwen-standard-api-key-cn

3. 设置默认模型

   {
     agents: {
       defaults: {
         model: { primary: "qwen/qwen3.5-plus" },
       },
     },
   }

4. 验证模型可用

   openclaw models list --provider qwen

注意： 与 Coding Plan 相同，旧版别名依然可用，但新配置应优先使用规范 ID。

套餐与端点对应表

套餐	区域	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

提供商根据 auth 选项自动选择端点。规范选项使用 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-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

注意： 即使模型在内置目录中，实际可用性仍取决于你的端点和计费套餐。

推理控制（Thinking）

对于支持推理的 Qwen Cloud 模型，内置提供商将 OpenClaw 的 thinking 等级映射到 DashScope 的顶层 enable_thinking 请求标志。禁用 thinking 时发送 enable_thinking: false；其他等级均发送 enable_thinking: true。

多模态扩展

qwen 插件在 Standard DashScope 端点（非 Coding Plan 端点）上提供多模态能力：

• 视频理解：通过 qwen-vl-max-latest
• 视频生成（Wan 系列）：wan2.6-t2v（默认）、wan2.6-i2v、wan2.6-r2v、wan2.6-r2v-flash、wan2.7-r2v

将 Qwen 设为默认视频提供商：

{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },
    },
  },
}

参见： 视频生成 了解共享工具参数、提供商选择和故障转移行为。

高级配置

图像与视频理解

内置 Qwen 插件在 Standard DashScope 端点（非 Coding Plan 端点）上注册图像和视频的媒体理解。

属性	值
模型	qwen-vl-max-latest
支持输入	图像、视频

媒体理解会自动从配置的 Qwen auth 解析，无需额外配置。请确保使用 Standard（按量付费）端点以获得媒体理解支持。

Qwen 3.6 Plus 可用性

qwen3.6-plus 在 Standard（按量付费）Model Studio 端点上可用：

• 中国区：dashscope.aliyuncs.com/compatible-mode/v1
• 全球：dashscope-intl.aliyuncs.com/compatible-mode/v1

如果 Coding Plan 端点对 qwen3.6-plus 返回“不支持的模型”错误，请切换到 Standard 端点及对应的密钥对。

OpenClaw 内置 Qwen 目录不会在 Coding Plan 端点上展示 qwen3.6-plus，但如果你在 models.providers.qwen.models 下显式配置了 qwen/qwen3.6-plus，且 Coding Plan 端点的 baseUrl 也已设定，OpenClaw 会尊重该条目（是否调用成功仍由上游 API 决定）。

能力规划

qwen 插件正被定位为 Qwen Cloud 全功能提供商的载体：

• 文本/对话模型： 已内置
• 工具调用、结构化输出、推理： 继承自 OpenAI 兼容传输层
• 图像生成： 计划在提供商插件层实现
• 图像/视频理解： 已在 Standard 端点上内置
• 语音/音频： 计划在提供商插件层实现
• 记忆嵌入/重排： 计划通过嵌入适配器表面实现
• 视频生成： 已通过共享视频生成能力内置

视频生成详情

对于视频生成，OpenClaw 在提交任务前将配置的 Qwen 区域映射到对应 DashScope AIGC 主机：

• 全球：https://dashscope-intl.aliyuncs.com
• 中国区：https://dashscope.aliyuncs.com

这意味着即便 models.providers.qwen.baseUrl 指向 Coding Plan 或 Standard 的 Qwen 主机，视频生成仍然使用正确的区域 DashScope 视频端点。

当前内置 Qwen 视频生成限制：

• 每次最多 1 个输出视频
• 每次最多 1 个参考图像
• 每次最多 4 个参考视频
• 最长时长 10 秒
• 支持 size、aspectRatio、resolution、audio、watermark
• 参考图像/视频模式目前要求 远程 http(s) URL。本地文件路径会被直接拒绝，因为 DashScope 视频端点不接受上传的本地缓冲区作为参考。

流式用量兼容性

原生 Model Studio 端点在共享的 openai-completions 传输层上标记了流式用量兼容性。OpenClaw 根据端点能力来匹配该特性，因此目标为相同原生主机的 DashScope 兼容自定义提供商 ID 会自动继承相同的流式用量行为，不需要强制使用内置 qwen 提供商 ID。

原生流式用量兼容性适用于以下主机（包括 Coding Plan 和 Standard）：

• 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

多模态端点区域

多模态能力（视频理解、Wan 视频生成）使用 Standard DashScope 端点，而非 Coding Plan 端点：

• 全球/国际 Standard 基础 URL：https://dashscope-intl.aliyuncs.com/compatible-mode/v1
• 中国区 Standard 基础 URL：https://dashscope.aliyuncs.com/compatible-mode/v1

环境与守护进程配置

如果 Gateway 作为守护进程（launchd/systemd）运行，请确保 QWEN_API_KEY 对该进程可用（例如放入 ~/.openclaw/.env 或通过 env.shellEnv）。

相关资源

• 模型选择：提供商、模型引用和故障转移行为。
• 视频生成：共享视频工具参数和提供商选择。
• Alibaba (ModelStudio)：旧版 ModelStudio 提供商及迁移说明。
• 故障排除：通用故障排除和 FAQ。

常见问题

Qwen OAuth 已下线，现有配置如何迁移？

运行 openclaw onboard --auth-choice qwen-api-key（或 cn 版本）重新完成引导，用正式 API Key 替换旧 OAuth 配置。模型 ID 从 qwen-portal/... 改为 qwen/...，其余配置结构不变。

qwen3.6-plus 总是提示“不支持此模型”，怎么解决？

qwen3.6-plus 仅在 Standard（按量付费）DashScope 端点上可用。请切换到 qwen-standard-api-key 或 qwen-standard-api-key-cn 对应的 auth 选项，然后重新运行引导并验证模型列表。

Wan 视频生成提示本地文件路径不被支持，怎么办？

DashScope 视频端点只接受远程 https:// URL 作为参考图像或视频输入。请先将本地文件上传到 OSS 或其他可访问的存储，然后将 URL 传入参数。