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 以官方外部插件形式提供，未随核心捆绑。安装方式如下：

openclaw plugins install @openclaw/qwen-provider

安装会自动应用于正在运行的 Gateway；否则将在下次启动时生效。参见 应用更改并检查。

快速开始¶

选择您的套餐类型，并按照设置步骤操作。

**最佳适用：** 通过 Qwen Coding Plan 进行基于订阅的访问。

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

**最佳适用：** 通过 Standard Model Studio 端点进行按量付费访问，包括 `qwen3.8-max` 和 `qwen3.8-flash`，这些模型在旧版 Coding Plan 中不可用。

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 及受支持的第三方模型。

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"

已弃用的 Qwen Portal 身份验证¶

qwen-oauth Portal 提供商及其旧版 OAuth 流程已被移除。 Portal 令牌不能与 Qwen Cloud 或 DashScope API 密钥互换使用。 使用当前 Qwen 插件需要为所选端点重新进行 API 密钥身份验证，并更新模型配置。请遵循 安装插件 和 快速开始；现有 Portal 凭据不会自动转换。

计划类型与端点¶

提供商会根据您的认证选择自动选择端点。规范选项使用 qwen-* 系列；modelstudio-* 仅用于兼容性。可在配置中通过自定义 baseUrl 进行覆盖。

内置目录¶

设置会保留连接设置和模型别名（包括 modelstudio 别名），而不会将生成的目录行复制到您的配置中。显式设置 models.mode: "replace" 会保持目录种子启用；自定义模型行保持完整。

OpenClaw 从已配置端点的经过身份验证的 /models API 发现模型。插件会保留以下种子元数据，用于离线发现以及仅返回模型 ID 的端点。Coding Plan 配置会省略未包含在该计划中的模型；Standard 模型列表不会建立 Token Plan 或 Coding Plan 访问权限。

Token Plan 目录¶

Token Plan 使用单独的精确字符串允许列表。内置目录显示阿里巴巴当前推荐的计划模型，并保留较新的 Qwen3-Coder 兼容层级可选择但隐藏。其他允许列表中的模型 ID 仍可作为自定义模型引用使用。仅图像生成的计划模型未包含在此处，因为它们使用不同的 API。

思考控制¶

Agent 运行和独立补全使用相同的模型特定思考控制，包括 Token Plan 工具选择和推理重放要求。

qwen3.8-max 和 qwen3.8-flash 支持 off、low、medium 和 xhigh 思考，默认值为 xhigh。minimal 映射到 low；high 和 max 映射到 xhigh。这适用于 Standard 和 Token Plan。这两个模型均支持 131,072 个输出 token。OpenClaw 在工具使用期间将返回的推理保留在其独立的 reasoning_content 重放字段中，而不是将其放在可见答案文本中。

请求参数中显式的 thinking_budget 优先于映射的 reasoning_effort：Qwen 会拒绝同时包含两者的请求。请参阅 Qwen 思考参考。

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（按量付费）端点，媒体理解才能正常工作。

视频生成¶

请使用来自 Standard 端点的 QWEN_API_KEY。要将 Qwen 设为默认视频 提供商：

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

当恰好有一个参考图像且没有视频时，wan2.6-t2v 会自动 使用 wan2.6-i2v；结果会报告解析后的模型。此路由仅在已知模型目录中存在同代图像到视频兄弟模型时适用。其他请求使用所选模型的模式：

Wan 2.6 文本/参考模型会将 resolution 和 aspectRatio 转换为文档中规定的精确 size。Wan 2.6 图像到视频会发送 resolution 级别，并使用输入图像的宽高比。Wan 2.7 参考到视频会发送 media、resolution 和 ratio，并始终生成音频。

图像到视频和 Wan 2.7 参考图像接受本地文件或远程 http(s) URL。本地图像以 base64 data URI 发送，编码前每张图像最大 20 MB，符合 Wan 图像输入限制。 参考视频和 Wan 2.6 参考到视频图像仍要求使用远程 http(s) URL。

高级配置¶

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

相关¶

模型选择

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

视频生成

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

Alibaba Model Studio

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

故障排查

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