跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/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 作为兼容别名继续可用。
  • 提供商：qwen
  • 首选环境变量：QWEN_API_KEY
  • 兼容性也接受：MODELSTUDIO_API_KEY、DASHSCOPE_API_KEY
  • API 风格：OpenAI 兼容
如果你想使用 qwen3.6-plus，优先选择**标准（按量付费）**端点。 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/... 模型引用仍可作为兼容别名使用， 但新的设置流程应优先使用规范的 qwen-* auth-choice ID 和 qwen/... 模型引用。 如果你定义了一个精确的自定义 models.providers.modelstudio 条目，并带有另一个 api 值，则该自定义提供商会拥有 modelstudio/... 引用，而不是 Qwen 兼容别名。

​
计划类型和端点

计划区域Auth choice端点
标准（按量付费）Chinaqwen-standard-api-key-cndashscope.aliyuncs.com/compatible-mode/v1
标准（按量付费）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
该提供商会根据你的 auth choice 自动选择端点。规范选择使用 qwen-* 系列；modelstudio-* 仅保留用于兼容。 你可以在配置中使用自定义 baseUrl 覆盖。
管理 key： home.qwencloud.com/api-keys | 文档： docs.qwencloud.com

​
内置目录

OpenClaw 目前随附此内置 Qwen 目录。配置的目录会感知端点：Coding Plan 配置会省略仅已知可在标准端点上工作的模型。
模型引用输入上下文备注
qwen/qwen3.5-plus文本，图像1,000,000默认模型
qwen/qwen3.6-plus文本，图像1,000,000需要此模型时优先使用标准端点
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 插件还会在标准 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" },
    },
  },
}
有关共享工具参数、提供商选择和故障转移行为，请参见 视频生成。

​
高级配置

内置 Qwen 插件会在标准 DashScope 端点（而不是 Coding Plan 端点）上为图像和视频注册媒体理解。
属性值
模型qwen-vl-max-latest
支持的输入图像，视频
媒体理解会根据配置的 Qwen 凭证自动解析，不需要额外配置。 请确保你使用的是标准（按量付费）端点，以获得媒体理解支持。
qwen3.6-plus 可在标准（按量付费）Model Studio 端点上使用：
  • China：dashscope.aliyuncs.com/compatible-mode/v1
  • Global：dashscope-intl.aliyuncs.com/compatible-mode/v1
如果 Coding Plan 端点对 qwen3.6-plus 返回 “unsupported model” 错误， 请改用标准（按量付费）端点/key 对，而不是 Coding Plan 端点/key 对。OpenClaw 的内置 Qwen 目录不会在 Coding Plan 端点上公布 qwen3.6-plus，但会尊重 models.providers.qwen.models 下显式配置的 qwen/qwen3.6-plus 条目，并在 Coding Plan baseUrl 上使用；因此，如果 Aliyun 在你的订阅中启用了该模型，你可以选择加入。 上游 API 仍会决定调用是否成功。
qwen 插件正被定位为完整 Qwen Cloud 能力面的厂商归属，而不只是编码/文本模型。
  • 文本/聊天模型： 现已内置
  • 工具调用、结构化输出、思考： 继承自 OpenAI 兼容传输
  • 图像生成： 计划在提供商插件层实现
  • 图像/视频理解： 现已在标准端点上内置
  • 语音/音频： 计划在提供商插件层实现
  • Memory 嵌入/重排序： 计划通过嵌入适配器能力面实现
  • 视频生成： 现已通过共享视频生成能力内置
对于视频生成，OpenClaw 会先将配置的 Qwen 区域映射到匹配的 DashScope AIGC 主机，然后再提交任务：
  • Global/Intl：https://dashscope-intl.aliyuncs.com
  • China：https://dashscope.aliyuncs.com
这意味着，指向 Coding Plan 或标准 Qwen 主机的普通 models.providers.qwen.baseUrl 仍会让视频生成使用正确的区域 DashScope 视频端点。当前内置 Qwen 视频生成限制：
  • 每个请求最多 1 个输出视频
  • 最多 1 张输入图像
  • 最多 4 个输入视频
  • 最长 10 秒 时长
  • 支持 size、aspectRatio、resolution、audio 和 watermark
  • 参考图像/视频模式目前要求使用远程 http(s) URL。本地文件路径会被预先拒绝， 因为 DashScope 视频端点不接受为这些引用上传本地 buffer。
原生 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 端点：
  • Global/Intl 标准 base URL：https://dashscope-intl.aliyuncs.com/compatible-mode/v1
  • China 标准 base URL：https://dashscope.aliyuncs.com/compatible-mode/v1
如果 Gateway 网关作为守护进程（launchd/systemd）运行，请确保 QWEN_API_KEY 可供该进程使用（例如，在 ~/.openclaw/.env 中，或通过 env.shellEnv）。

​
相关

模型选择

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

视频生成

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

Alibaba (ModelStudio)

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

故障排除

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