跳转到主要内容

​
Qwen

Qwen OAuth 已被移除。 之前使用 portal.qwen.ai 端点的免费层 OAuth 集成 （qwen-portal）现已不可用。 背景信息请参见 Issue #49557。
OpenClaw 现在将 Qwen 视为一等内置提供商，其规范 id 为 qwen。该内置提供商面向 Qwen Cloud / Alibaba DashScope 和 Coding Plan 端点，并保留旧版 modelstudio id 作为兼容性别名。
  • 提供商：qwen
  • 首选环境变量：QWEN_API_KEY
  • 出于兼容性也接受：MODELSTUDIO_API_KEY、DASHSCOPE_API_KEY
  • API 风格：与 OpenAI 兼容
如果你想使用 qwen3.6-plus，建议优先选择**标准版（按量计费）**端点。 Coding Plan 支持可能会落后于公开目录。

​
入门指南

选择你的套餐类型并按照设置步骤操作。
最适合： 通过 Qwen Coding Plan 获得基于订阅的访问。
1

获取你的 API 密钥

在 home.qwencloud.com/api-keys 创建或复制一个 API 密钥。
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/... 模型引用。

​
套餐类型和端点

套餐区域Auth choice端点
标准版（按量计费）中国qwen-standard-api-key-cndashscope.aliyuncs.com/compatible-mode/v1
标准版（按量计费）全球qwen-standard-api-keydashscope-intl.aliyuncs.com/compatible-mode/v1
Coding Plan（订阅制）中国qwen-api-key-cncoding.dashscope.aliyuncs.com/v1
Coding Plan（订阅制）全球qwen-api-keycoding-intl.dashscope.aliyuncs.com/v1
该提供商会根据你的 auth choice 自动选择端点。规范选择使用 qwen-* 系列；modelstudio-* 仅保留用于兼容性。 你也可以在配置中通过自定义 baseUrl 进行覆盖。
管理密钥： home.qwencloud.com/api-keys | 文档： docs.qwencloud.com

​
内置目录

OpenClaw 当前内置了以下 Qwen 目录。已配置的目录会感知端点： Coding Plan 配置会省略那些目前仅确认可在 标准版端点上运行的模型。
模型引用输入上下文说明
qwen/qwen3.5-plustext, image1,000,000默认模型
qwen/qwen3.6-plustext, image1,000,000当你需要此模型时，建议优先使用标准版端点
qwen/qwen3-max-2026-01-23text262,144Qwen Max 系列
qwen/qwen3-coder-nexttext262,144编码
qwen/qwen3-coder-plustext1,000,000编码
qwen/MiniMax-M2.5text1,000,000已启用推理
qwen/glm-5text202,752GLM
qwen/glm-4.7text202,752GLM
qwen/kimi-k2.5text, image262,144通过 Alibaba 提供的 Moonshot AI
即使某个模型出现在内置目录中，其可用性仍可能因端点和计费套餐而异。

​
多模态附加能力

qwen 扩展还会在标准版 DashScope 端点（而非 Coding Plan 端点）上提供多模态能力：
  • 通过 qwen-vl-max-latest 提供视频理解
  • 通过 wan2.6-t2v（默认）、wan2.6-i2v、wan2.6-r2v、wan2.6-r2v-flash、wan2.7-r2v 提供 Wan 视频生成
要将 Qwen 用作默认视频提供商： 
{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },
    },
  },
}
有关共享工具参数、提供商选择和故障切换行为，请参见 Video Generation。

​
高级

内置的 Qwen 插件会在标准版 DashScope 端点（而非 Coding Plan 端点）上为图像和视频注册媒体理解能力。
属性值
模型qwen-vl-max-latest
支持的输入图像、视频
媒体理解会根据已配置的 Qwen 凭证自动解析—— 无需额外配置。请确保你使用的是支持媒体理解的标准版（按量计费） 端点。
qwen3.6-plus 可在标准版（按量计费）Model Studio 端点上使用：
  • 中国：dashscope.aliyuncs.com/compatible-mode/v1
  • 全球：dashscope-intl.aliyuncs.com/compatible-mode/v1
如果 Coding Plan 端点对 qwen3.6-plus 返回“unsupported model”错误， 请切换到标准版（按量计费），而不是继续使用 Coding Plan 端点 / 密钥组合。
qwen 扩展正在被定位为完整 Qwen Cloud 能力面的厂商归属入口，而不仅仅是编码 / 文本模型。
  • 文本 / 聊天模型： 现已内置
  • 工具调用、结构化输出、思维链： 继承自与 OpenAI 兼容的传输层
  • 图像生成： 计划在提供商插件层支持
  • 图像 / 视频理解： 现已在标准版端点内置
  • 语音 / 音频： 计划在提供商插件层支持
  • Memory 嵌入 / 重排序： 计划通过嵌入适配器能力面支持
  • 视频生成： 现已通过共享视频生成能力内置
对于视频生成，OpenClaw 会先将已配置的 Qwen 区域映射到匹配的 DashScope AIGC 主机，然后再提交任务：
  • 全球 / 国际版：https://dashscope-intl.aliyuncs.com
  • 中国：https://dashscope.aliyuncs.com
这意味着，普通的 models.providers.qwen.baseUrl 即使指向 Coding Plan 或标准版 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 主机和 标准版 DashScope 兼容主机：
  • 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 视频生成）使用的是 标准版 DashScope 端点，而不是 Coding Plan 端点：
  • 全球 / 国际版标准 base URL：https://dashscope-intl.aliyuncs.com/compatible-mode/v1
  • 中国标准 base URL：https://dashscope.aliyuncs.com/compatible-mode/v1
如果 Gateway 网关以守护进程（launchd/systemd）方式运行，请确保 QWEN_API_KEY 对该进程可用（例如放在 ~/.openclaw/.env 中，或通过 env.shellEnv 提供）。

​
相关内容

模型选择

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

视频生成

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

Alibaba（ModelStudio）

旧版 ModelStudio 提供商和迁移说明。

故障排除

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