Skip to main content

Documentation Index

Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
快速开始

选择你的计划类型并按照设置步骤进行。
最适合： 通过 Qwen Coding Plan 进行基于订阅的访问。
1

获取你的 API key

从 home.qwencloud.com/api-keys 创建或复制一个 API key。
2

运行引导配置

对于 Global 端点：
openclaw onboard --auth-choice qwen-api-key
对于 China 端点：
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/... model 引用仍然 可以作为兼容别名使用，但新的设置流程应优先使用规范的 qwen-* auth-choice id 和 qwen/... model 引用。如果你定义了一个精确的 自定义 models.providers.modelstudio 条目并使用了不同的 api 值，那么该 自定义提供方会拥有 modelstudio/... 引用，而不是 Qwen 兼容 别名。

​
计划类型和端点

计划区域认证选项端点
Standard（按量付费）Chinaqwen-standard-api-key-cndashscope.aliyuncs.com/compatible-mode/v1
Standard（按量付费）Globalqwen-standard-api-keydashscope-intl.aliyuncs.com/compatible-mode/v1
Coding Plan（订阅制）Chinaqwen-api-key-cncoding.dashscope.aliyuncs.com/v1
Coding Plan（订阅制）Globalqwen-api-keycoding-intl.dashscope.aliyuncs.com/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-plus文本, 图片1,000,000需要此模型时优先使用 Standard 端点
qwen/qwen3-max-2026-01-23文本262,144Qwen 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,752GLM
qwen/glm-4.7文本202,752GLM
qwen/kimi-k2.5文本, 图片262,144通过 Alibaba 提供的 Moonshot AI
即使模型出现在内置目录中，实际可用性仍可能因端点和计费计划而异。

​
思考控制

对于支持推理的 Qwen Cloud 模型，内置提供方会将 OpenClaw 的 思考级别映射到 DashScope 顶层的 enable_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 端点）。
属性值
Modelqwen-vl-max-latest
支持的输入图像, 视频
媒体理解会根据已配置的 Qwen 认证自动解析——无需额外配置。 请确保你使用的是 Standard（按量付费）端点以支持媒体理解。
qwen3.6-plus 可在 Standard（按量付费）Model Studio 端点上使用：
  • China: dashscope.aliyuncs.com/compatible-mode/v1
  • Global: dashscope-intl.aliyuncs.com/compatible-mode/v1
如果 Coding Plan 端点对 qwen3.6-plus 返回 “unsupported model” 错误， 请切换到 Standard（按量付费）而不是 Coding Plan 端点/密钥对。OpenClaw 的内置 Qwen 目录不会在 Coding Plan 端点上宣传 qwen3.6-plus，但如果你在 models.providers.qwen.models 下显式配置了 qwen/qwen3.6-plus 条目， 并且使用 Coding Plan baseUrl，那么该配置会被接受，这样如果阿里云在你的订阅中启用该模型，你就可以选择使用它。是否成功调用仍然由上游 API 决定。
qwen 插件正被定位为完整 Qwen Cloud 入口的厂商主页，而不只是编程/文本模型。
  • 文本/聊天模型： 目前已内置
  • 工具调用、结构化输出、思考： 继承自兼容 OpenAI 的传输层
  • 图像生成： 计划在提供方插件层实现
  • 图像/视频理解： 目前已在 Standard 端点内置
  • 语音/音频： 计划在提供方插件层实现
  • 记忆嵌入/重排序： 计划通过嵌入适配器层提供
  • 视频生成： 目前已通过共享的视频生成能力内置
对于视频生成，OpenClaw 会在提交任务前将已配置的 Qwen 区域映射到 对应的 DashScope AIGC 主机：
  • Global/Intl: https://dashscope-intl.aliyuncs.com
  • China: https://dashscope.aliyuncs.com
这意味着，指向任一 Coding Plan 或 Standard Qwen 主机的正常 models.providers.qwen.baseUrl 仍会让视频生成使用正确的 区域 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 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 视频生成）使用 Standard DashScope 端点，而不是 Coding Plan 端点：
  • Global/Intl Standard base URL: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
  • China Standard base URL: https://dashscope.aliyuncs.com/compatible-mode/v1
如果 Gateway 作为守护进程运行（launchd/systemd），请确保 QWEN_API_KEY 可供该进程使用（例如放在 ~/.openclaw/.env 中，或通过 env.shellEnv 提供）。

​
相关

模型选择

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

视频生成

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

阿里巴巴（ModelStudio）

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

故障排查

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