跳到正文
FunCoding

搜索

搜索文档、文章、Skill 和 MCP

Qwen

通过 OpenClaw 插件使用 Qwen Cloud

Qwen Cloud 是官方外部 OpenClaw 提供商插件,规范 id 为 qwen。它面向 Qwen Cloud / Alibaba DashScope Standard 和 Coding Plan 端点,将 Token Plan 公开为 qwen-token-plan,保留 modelstudio 作为兼容性别名,并独立拥有 Alibaba 文档中所述的 bailian-token-plan 自定义提供商 id。

属性值
提供商qwen
Token Plan 提供商qwen-token-plan
首选环境变量QWEN_API_KEY
Token Plan 环境变量QWEN_TOKEN_PLAN_API_KEY
也接受(兼容)MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
API 风格OpenAI 兼容

qwen3.7-plus 和 qwen3.6-plus 可用于 Coding Plan 和 Standard 端点。 对于 qwen3.7-max 或 qwen3.6-flash,请使用 **Standard(按量付费)**端点。

安装插件

qwen 作为官方外部插件发布,不与核心捆绑。安装它并重启 Gateway 网关:

openclaw plugins install @openclaw/qwen-provider
openclaw gateway restart

入门指南

选择你的计划类型,然后按照设置步骤操作。

Coding Plan(订阅)

**最适合:**通过 Qwen Coding Plan 获得基于订阅的访问权限。

获取 API 密钥

在 home.qwencloud.com/api-keys 创建或复制 API 密钥。

运行新手引导

对于全球端点:

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

旧版 modelstudio-* 身份验证选择 id 和 modelstudio/... 模型引用仍可 作为兼容性别名使用,但新的设置流程应优先使用规范的 qwen-* 身份验证选择 id 和 qwen/... 模型引用。如果你定义了一个完全匹配的 自定义 models.providers.modelstudio 条目并为其设置另一个 api 值,则该 自定义提供商将拥有 modelstudio/... 引用,而不是 Qwen 兼容性 别名。

Standard(按量付费)

**最适合:**通过 Standard Model Studio 端点进行按量付费访问,包括 Coding Plan 不提供的 qwen3.7-max 和 qwen3.6-flash。

获取 API 密钥

在 home.qwencloud.com/api-keys 创建或复制 API 密钥。

运行新手引导

对于全球端点:

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

旧版 modelstudio-* 身份验证选择 id 和 modelstudio/... 模型引用仍可 作为兼容性别名使用,但新的设置流程应优先使用规范的 qwen-* 身份验证选择 id 和 qwen/... 模型引用。如果你定义了一个完全匹配的 自定义 models.providers.modelstudio 条目并为其设置另一个 api 值,则该 自定义提供商将拥有 modelstudio/... 引用,而不是 Qwen 兼容性 别名。

Token Plan(团队版)

**最适合:**通过 Alibaba Cloud Model Studio,以基于额度的团队订阅方式访问 Qwen 和支持的第三方模型。

获取专用密钥

分配一个 Token Plan 席位,并创建其专用的 sk-sp-... 密钥。Token Plan、Coding Plan 和按量付费密钥不可互换。请参阅全球 Token Plan 概览或中国 Token Plan 概览。

运行新手引导

对于位于新加坡的全球 / 国际端点:

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"

Alibaba 的 OpenClaw 指南使用 bailian-token-plan 作为手动自定义 提供商。该插件将此 id 注册为兼容性所有者,但新 配置应使用 qwen-token-plan。完全匹配的自定义 models.providers.bailian-token-plan 条目继续拥有其配置的 传输协议和目录;它绝不会被合并到规范的 OpenAI 目录中。

Token Plan 仅用于交互式 OpenClaw 会话。不要将其用于 定时任务、无人值守脚本或应用程序后端。Alibaba 表示, 非交互式使用可能导致订阅被暂停或其 API 密钥被撤销。

计划类型和端点

计划区域身份验证选择端点
Coding Plan(订阅)中国qwen-api-key-cncoding.dashscope.aliyuncs.com/v1
Coding Plan(订阅)全球qwen-api-keycoding-intl.dashscope.aliyuncs.com/v1
Standard(按量付费)中国qwen-standard-api-key-cndashscope.aliyuncs.com/compatible-mode/v1
Standard(按量付费)全球qwen-standard-api-keydashscope-intl.aliyuncs.com/compatible-mode/v1
Token Plan(团队版)中国qwen-token-plan-cntoken-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
Token Plan(团队版)全球qwen-token-plantoken-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

提供商会根据你的身份验证选择自动选择端点。规范 选择使用 qwen-* 系列;modelstudio-* 仅保留用于兼容。 可在配置中使用自定义 baseUrl 覆盖。

内置目录

OpenClaw 随附此 Qwen 静态目录。该目录能够感知端点:Coding Plan 配置会省略仅适用于 Standard 端点的模型。

模型引用输入上下文说明
qwen/qwen3.5-plus文本、图像1,000,000默认模型
qwen/qwen3.6-flash文本、图像1,000,000仅限 Standard 端点
qwen/qwen3.6-plus文本、图像1,000,000Coding Plan + Standard
qwen/qwen3.7-max文本1,000,000仅限 Standard 端点
qwen/qwen3.7-plus文本、图像1,000,000Coding Plan + 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

即使模型存在于静态目录中,其可用性仍可能因端点和计费计划而异。

Token Plan 目录

Token Plan 使用单独的精确字符串允许列表。此处不包括仅用于图像生成的计划 模型,因为它们使用不同的 API。

模型引用输入上下文
qwen-token-plan/qwen3.7-max文本1,000,000
qwen-token-plan/qwen3.7-plus文本、图像1,000,000
qwen-token-plan/qwen3.6-plus文本、图像1,000,000
qwen-token-plan/qwen3.6-flash文本、图像1,000,000
qwen-token-plan/deepseek-v4-pro文本1,000,000
qwen-token-plan/deepseek-v4-flash文本1,000,000
qwen-token-plan/deepseek-v3.2文本131,072
qwen-token-plan/kimi-k2.7-code文本、图像262,144
qwen-token-plan/kimi-k2.6文本、图像262,144
qwen-token-plan/kimi-k2.5文本、图像262,144
qwen-token-plan/glm-5.2文本1,000,000
qwen-token-plan/glm-5.1文本202,752
qwen-token-plan/glm-5文本202,752
qwen-token-plan/MiniMax-M2.5文本196,608

思考控制

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(按量付费) 端点。

要将 Qwen 设为默认视频提供商:

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

视频生成限制:每个请求生成 1 个视频,最多可输入 1 张图片 (图生视频),最多可输入 4 个视频(视频生视频),最长时长为 10 秒。 支持 size、aspectRatio、resolution、audio 和 watermark。参考图片/视频输入必须使用远程 http(s) URL;本地 文件路径会被预先拒绝,因为 DashScope 视频端点不接受为这些参考项 上传的本地缓冲区。

有关共享工具参数、提供商选择和故障转移行为,请参阅视频生成。

高级配置

Qwen 3.6 和 3.7 可用性

qwen3.7-plus 和 qwen3.6-plus 可用于 Coding Plan 和 Standard 端点。qwen3.7-max 和 qwen3.6-flash 仅限 Standard。Standard(按量付费)端点为:

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

OpenClaw 会从 Coding Plan 目录中省略 qwen3.7-max 和 qwen3.6-flash。 如果 Coding Plan 端点针对其中任一模型返回“unsupported model”错误, 请切换到匹配的 Standard 端点和密钥。

视频生成区域路由

OpenClaw 会先将配置的 Qwen 区域映射到匹配的 DashScope AIGC 主机, 然后再提交视频任务:

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

即使普通的 models.providers.qwen.baseUrl 指向 Coding Plan 或 Standard Qwen 主机,视频生成仍会路由到匹配的 区域 DashScope 视频端点。

流式用量兼容性

原生 Qwen 端点会在共享的 openai-completions 传输上声明流式用量兼容性, 因此,面向相同原生主机且兼容 DashScope 的自定义提供商 ID 会继承相同行为,无需专门使用内置的 qwen 提供商 ID。 这适用于 Coding Plan、Standard 和 Token Plan 端点:

  • 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
  • https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
  • https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
能力规划

qwen 插件正被定位为完整 Qwen Cloud 功能面的提供商归属,而不仅限于编码/文本模型。

  • **文本/聊天模型:**可通过插件使用
  • **工具调用、结构化输出、思考:**继承自兼容 OpenAI 的传输
  • **图片生成:**计划在提供商插件层实现
  • **图片/视频理解:**可通过 Standard 端点上的插件使用
  • **语音/音频:**计划在提供商插件层实现
  • **记忆嵌入/重排序:**计划通过嵌入适配器功能面实现
  • **视频生成:**可通过插件使用共享的视频生成能力
环境和守护进程设置

如果 Gateway 网关作为守护进程(launchd/systemd)运行,请确保该进程可以使用 QWEN_API_KEY 或 QWEN_TOKEN_PLAN_API_KEY(例如,在 ~/.openclaw/.env 中或通过 env.shellEnv)。

相关内容