提供商

Qwen

Qwen Cloud 是官方的 OpenClaw 外部提供商插件,规范 id 为 qwen。它面向 Qwen Cloud / Alibaba DashScope 标准版和 Coding Plan 端点,将 Token Plan 公开为 qwen-token-plan,保留 modelstudio 作为兼容别名,独立拥有阿里巴巴文档中定义的 bailian-token-plan 自定义提供商 id,并通过 qwen-oauth 提供 Qwen Portal 令牌流程。

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

安装插件

qwen 作为官方外部插件发布,不内置于核心中。安装该插件并重启 Gateway 网关:

bash
openclaw plugins install @openclaw/qwen-provideropenclaw gateway restart

入门指南

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

Coding Plan (subscription)

**最适合:**通过 Qwen Coding Plan 以订阅方式访问。

  • Get your API key

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

  • Run onboarding

    对于全球端点:

    bash
    openclaw onboard --auth-choice qwen-api-key

    对于中国端点:

    bash
    openclaw onboard --auth-choice qwen-api-key-cn
  • Set a default model

    json5
    {  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}
  • Verify the model is available

    bash
    openclaw models list --provider qwen
  • Standard (pay-as-you-go)

    **最适合:**通过标准版 Model Studio 端点按量付费访问,包括 Coding Plan 不提供的 qwen3.7-maxqwen3.6-flash

  • Get your API key

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

  • Run onboarding

    对于全球端点:

    bash
    openclaw onboard --auth-choice qwen-standard-api-key

    对于中国端点:

    bash
    openclaw onboard --auth-choice qwen-standard-api-key-cn
  • Set a default model

    json5
    {  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}
  • Verify the model is available

    bash
    openclaw models list --provider qwen
  • Token Plan (Team Edition)

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

  • Get your dedicated key

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

  • Run onboarding

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

    bash
    openclaw onboard --auth-choice qwen-token-plan

    对于位于北京的中国端点:

    bash
    openclaw onboard --auth-choice qwen-token-plan-cn
  • Verify the provider

    bash
    openclaw models list --provider qwen-token-planopenclaw agent --model qwen-token-plan/qwen3.7-plus --message "Reply with: token plan ready"
  • Qwen OAuth / Portal

    **最适合:**将 Qwen Portal 令牌用于 https://portal.qwen.ai/v1

    有关专用提供商页面和迁移说明,请参阅 Qwen OAuth / Portal

  • Provide your portal token

    bash
    openclaw onboard --auth-choice qwen-oauth
  • Set a default model

    json5
    {  agents: {    defaults: {      model: { primary: "qwen-oauth/qwen3.5-plus" },    },  },}
  • Verify the model is available

    bash
    openclaw models list --provider qwen-oauth
  • 计划类型和端点

    计划 区域 身份验证选项 端点
    Coding Plan(订阅) 中国 qwen-api-key-cn coding.dashscope.aliyuncs.com/v1
    Coding Plan(订阅) 全球 qwen-api-key coding-intl.dashscope.aliyuncs.com/v1
    Qwen Portal 全球 qwen-oauth portal.qwen.ai/v1
    标准版(按量付费) 中国 qwen-standard-api-key-cn dashscope.aliyuncs.com/compatible-mode/v1
    标准版(按量付费) 全球 qwen-standard-api-key dashscope-intl.aliyuncs.com/compatible-mode/v1
    Token Plan(团队版) 中国 qwen-token-plan-cn token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
    Token Plan(团队版) 全球 qwen-token-plan token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

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

    内置目录

    OpenClaw 内置了以下 Qwen 静态目录。该目录可感知端点:Coding Plan 配置会省略仅适用于标准版端点的模型。

    模型引用 输入 上下文 说明
    qwen/qwen3.5-plus 文本、图像 1,000,000 默认模型
    qwen/qwen3.6-flash 文本、图像 1,000,000 仅限标准版端点
    qwen/qwen3.6-plus 文本、图像 1,000,000 Coding Plan + 标准版
    qwen/qwen3.7-max 文本 1,000,000 仅限标准版端点
    qwen/qwen3.7-plus 文本、图像 1,000,000 Coding Plan + 标准版
    qwen/qwen3-max-2026-01-23 文本 262,144 Qwen 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,752 GLM
    qwen/glm-4.7 文本 202,752 GLM
    qwen/kimi-k2.5 文本、图像 262,144 通过阿里巴巴使用 Moonshot AI
    qwen-oauth/qwen3.5-plus 文本、图像 1,000,000 Qwen Portal 默认模型

    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-maxqwen3.7-plusqwen3.6-flashqwen3.6-plus 在内置目录中已启用推理。对于 qwen 系列的推理模型,提供商会将 OpenClaw 的思考级别映射到 DashScope 顶层的 enable_thinking 请求标志:禁用思考时发送 enable_thinking: false,其他任何级别均发送 enable_thinking: true。自定义模型可以通过在模型条目上设置 compat.thinkingFormat: "qwen-chat-template",选择使用另一种聊天模板思考负载。

    Token Plan 模型也被标记为具备推理能力。kimi-k2.7-codeMiniMax-M2.5 仅支持思考,因此即使会话请求 /think off,OpenClaw 仍会保持启用思考。DeepSeek V4 会将 minimalhigh 映射为服务的 high 推理强度,并将 xhighmax 映射为 max。GLM 5.2 接受从 minimalmax 的完整范围;GLM 5.1 和 GLM 5 接受最高到 xhigh 的范围,且三者均默认为 high。其他混合模型遵循请求的启用或禁用状态。

    多模态附加功能

    qwen 插件仅在 DashScope 的 Standard 端点上提供多模态能力,Coding Plan 端点不支持这些能力:

    • 通过 qwen-vl-max-latest 实现图像和视频理解
    • 通过 wan2.6-t2v(默认)、wan2.6-i2vwan2.6-r2vwan2.6-r2v-flashwan2.7-r2v 实现 Wan 视频生成

    系统会根据已配置的 Qwen 身份验证信息自动解析媒体理解功能,无需额外配置。请确保使用 Standard(按量付费)端点,媒体理解功能才能正常工作。

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

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

    视频生成限制:每个请求生成 1 个输出视频;最多可提供 1 张输入图像(图生视频)或 4 个输入视频(视频转视频);最长时长为 10 秒。支持 sizeaspectRatioresolutionaudiowatermark。作为参考的图像或视频输入必须使用远程 http(s) URL;本地文件路径会被预先拒绝,因为 DashScope 视频端点不接受为这些参考素材上传的本地缓冲区。

    高级配置

    Qwen 3.6 和 3.7 的可用性

    qwen3.7-plusqwen3.6-plus 可用于 Coding Plan 和 Standard 端点。qwen3.7-maxqwen3.6-flash 仅可用于 Standard 端点。Standard(按量付费)端点如下:

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

    OpenClaw 不会在 Coding Plan 目录中列出 qwen3.7-maxqwen3.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_KEYQWEN_TOKEN_PLAN_API_KEY(例如,将其放在 ~/.openclaw/.env 中,或通过 env.shellEnv 提供)。

    相关内容

    Was this useful?
    On this page

    On this page