接入通义千问 Qwen：DashScope 三种套餐

OpenClaw 接入 Qwen（通义千问）是国产模型专页的第二站。上一课 DeepSeek 一个环境变量就通了；Qwen 多了一道选择题——阿里 DashScope 有 Coding Plan、Standard、Token Plan 三种套餐，每种还分国内 / 国际两套端点。选错套餐，模型列表会缺货、多模态会失灵；Token Plan 拿去跑无人值守任务，可能被暂停订阅甚至吊销 Key。全程约 8 分钟（Qwen Cloud / 阿里云注册另计）。

先给你一张速览表，本课所有配置都从它出发：

属性	值
Provider id	`qwen`（Token Plan 用独立 id：`qwen-token-plan`）
认证环境变量	`QWEN_API_KEY`（Token Plan：`QWEN_TOKEN_PLAN_API_KEY`）
兼容环境变量	`MODELSTUDIO_API_KEY`、`DASHSCOPE_API_KEY`
API 形态	OpenAI 兼容
官方插件	`@openclaw/qwen-provider`（外部插件，需安装）
默认模型	`qwen/qwen3.5-plus`（文本 + 图像，1M 上下文）
只设 Key、不配端点时	默认走国际站 Coding Plan：`https://coding-intl.dashscope.aliyuncs.com/v1`

一件必须先知道的事：环境变量的名字既不决定套餐、也不决定区域（官方原话："The environment variable name does not select a plan or region"）。决定端点的是 onboarding 的 auth-choice，或配置里显式写的 baseUrl。

三种套餐 × 两套区域，全课就靠这张表（auth-choice 与端点为官方文档原样摘录）：

套餐	区域	auth-choice	端点
Coding Plan（订阅）	国内	`qwen-api-key-cn`	`coding.dashscope.aliyuncs.com/v1`
Coding Plan（订阅）	国际	`qwen-api-key`	`coding-intl.dashscope.aliyuncs.com/v1`
Standard（按量付费）	国内	`qwen-standard-api-key-cn`	`dashscope.aliyuncs.com/compatible-mode/v1`
Standard（按量付费）	国际	`qwen-standard-api-key`	`dashscope-intl.aliyuncs.com/compatible-mode/v1`
Token Plan（Team Edition）	国内	`qwen-token-plan-cn`	`token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1`
Token Plan（Team Edition）	国际	`qwen-token-plan`	`token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`

怎么选，三句话（依据官方对三种套餐的定位）：

你的情况	选它	依据
想订阅包月用 Qwen	Coding Plan	官方定位：subscription 订阅制
按量付费；或要用 qwen3.8-max / qwen3.8-flash；或要多模态	Standard	qwen3.8 系列不在 Coding Plan 里；图像 / 视频理解、Wan 视频生成仅 Standard 端点
团队席位制，一个订阅里用 Qwen + 第三方模型	Token Plan（Team Edition）	官方定位：credit-based team subscription；仅限交互式使用

区域跟账号走：Key 是哪个站发的，就配哪个区域的端点——官方要求「套餐与区域 Key 配套」（use the matching plan and regional key）。本教程基于 OpenClaw v2026.10.9。

学完你能做什么

装上 Qwen 官方插件 @openclaw/qwen-provider，把 QWEN_API_KEY 配进 OpenClaw——onboarding 引导、手动配置两条路任选
分清 DashScope 三种套餐与国内 / 国际两套端点，按自己的账号选对 auth-choice
看懂 Qwen 内置模型目录：qwen3.5-plus 默认模型什么时候该换、哪些模型只在 Standard / Token Plan 有
避开 Token Plan 的红线：定时任务、无人值守脚本不能拿它跑
用上 Qwen 专属能力：/think 推理控制、Standard 端点的多模态与 Wan 视频生成、一个 Key 认证 qwen + alibaba 两个插件

🎒 开始前的准备

完成了连接模型总览：provider 体系与模型切换：「装插件 → 配凭据 → 选模型」三步和 provider/model 引用规则心里有数
OpenClaw 已安装、Gateway 在运行：openclaw gateway status 有输出（插件对运行中的 Gateway 自动生效；没在跑则下次启动生效）
想好要哪种套餐（订阅 / 按量 / 团队席位），并确认你的 Key 是国内站还是国际站发的
走服务器 / 守护进程部署的话，知道 ~/.openclaw/.env 在哪——Key 最终要住那里

跟我做

第 1 步：注册 Qwen Cloud 并按套餐创建 API Key

为什么：OpenClaw 只负责调用，Key 得先从 Qwen 侧拿——而且三种套餐拿 Key 的路径不一样。

Coding Plan 与 Standard：

浏览器打开 https://home.qwencloud.com/api-keys，注册 / 登录
创建或复制一把 API Key，粘贴到安全的地方

Token Plan（Team Edition）：

在阿里云 Model Studio（百炼）给成员分配 Token Plan 席位——国际版见 Token Plan overview，国内版见 Token Plan 总览
为该席位创建专用 Key，形如 sk-sp-...

你应该看到：一把可复制的 API Key。注意三种 Key 互不通用——官方原话："Token Plan, Coding Plan, and pay-as-you-go keys are not interchangeable."

💡 先定套餐，再拿 Key

Token Plan 的 Key 以 sk-sp- 开头，好认；拿不准订阅了哪种，先去控制台看清套餐名再回来选 auth-choice。Key 统一在 https://home.qwencloud.com/api-keys 管理，Qwen 官方文档在 https://docs.qwencloud.com。

第 2 步：OpenClaw 接入 Qwen——先装插件，再按套餐配 QWEN_API_KEY

为什么：Qwen 和 DeepSeek 一样是外部官方插件（不随核心内置），比内置插件多一步「安装」；装完后，auth-choice 决定走哪个套餐端点。

先装插件（两条方式共用的第一步）：

bash

openclaw plugins install @openclaw/qwen-provider

你应该看到：安装成功。对运行中的 Gateway 自动生效；Gateway 没在跑则下次启动时生效。

方式 A（推荐）：onboarding 引导

对照上面的套餐表，六个 auth-choice 按需选：

bash

# Coding Plan · 国内站 / 国际站
openclaw onboard --auth-choice qwen-api-key-cn
openclaw onboard --auth-choice qwen-api-key

# Standard · 国内站 / 国际站（要用 qwen3.8 系列或多模态的选这类）
openclaw onboard --auth-choice qwen-standard-api-key-cn
openclaw onboard --auth-choice qwen-standard-api-key

# Token Plan · 国内（北京）/ 国际（新加坡）
openclaw onboard --auth-choice qwen-token-plan-cn
openclaw onboard --auth-choice qwen-token-plan

为什么推荐：provider 会按 auth-choice 自动选端点，不用手写 baseUrl；一条命令走完「配凭据 + 选模型」。

你应该看到：先提示输入 API Key，验证通过后保存凭据；选默认模型时候选已被 auth-choice 预过滤（同插件的 qwen / qwen-token-plan 两个 provider 一起匹配）。

三个定心丸（官方文档明确写了）：

onboarding 保留你已有的模型条目——重跑不会清掉其他 provider 的配置
models.mode: "replace" 模式下会同时写入内置目录（该模式跳过 discovery）
加新 provider 凭据不会改你已有的默认模型——要换默认，用第 3 步的 openclaw models set

方式 B：手动改配置文件

两件事各管各的：Key 放环境变量，模型与端点写配置。

默认模型（官方配置示例，原样）：

json5

{
  agents: {
    defaults: {
      model: { primary: "qwen/qwen3.5-plus" },
    },
  },
}

Key 放哪：交互 shell 里 export QWEN_API_KEY="<你的 API Key>"，或写进 ~/.openclaw/.env（守护进程部署必须走这里，见下方警告）。Token Plan 用 QWEN_TOKEN_PLAN_API_KEY。

Standard / Token Plan 手动配置要多一步——显式覆盖 baseUrl，否则只设 Key 会默认走国际站 Coding Plan 端点（官方对手动配置的原样要求）：

json5

{
  models: {
    providers: {
      qwen: {
        // Standard · 国际站；国内站换成 https://dashscope.aliyuncs.com/compatible-mode/v1
        baseUrl: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
      },
    },
  },
}

其他套餐同理：baseUrl 指向套餐表里对应的端点（Token Plan 的模型引用还要用 qwen-token-plan/ 前缀）。显式端点配置优先级最高，但套餐与区域 Key 必须配套。

⚠️ Gateway 跑成守护进程？Key 别放交互 shell

Gateway 作为 launchd / systemd 服务运行时，看不到你终端里 export 的环境变量。把 QWEN_API_KEY（或 QWEN_TOKEN_PLAN_API_KEY）写进 ~/.openclaw/.env，或经配置里的 env.shellEnv 提供给那个进程。

openclaw models status 的凭据概览里，qwen 一行能看到 QWEN_API_KEY 的来源

第 3 步：选择 Qwen 模型并验证

为什么：默认模型 qwen/qwen3.5-plus 够用就先跑通；但目录里 14 个模型分三六九等——有的仅 Standard 有，有的还能看图。看一眼目录再决定。

先看目录：

bash

openclaw models list --provider qwen        # 列出 qwen 的已发布模型目录
openclaw models list --all --provider qwen  # --all：完整已发布目录；配 --provider 时可省

你应该看到：类似下面这张内置目录。Gateway 在运行时，实际列表从你配置端点的 /models API 动态发现，并按套餐过滤——Coding Plan 配置会略去该套餐没有的模型；Gateway 没在跑则显示本地缓存目录，加 --refresh 才触发重新发现：

模型引用	输入	上下文	备注
`qwen/qwen3.5-plus`	文本、图像	1,000,000	默认模型
`qwen/qwen3.6-flash`	文本、图像	1,000,000	仅 Standard 端点
`qwen/qwen3.6-plus`	文本、图像	1,000,000	Coding Plan + Standard
`qwen/qwen3.7-max`	文本	1,000,000	仅 Standard 端点
`qwen/qwen3.7-plus`	文本、图像	1,000,000	Coding Plan + Standard
`qwen/qwen3.8-max`	文本、图像	1,000,000	仅 Standard 端点
`qwen/qwen3.8-flash`	文本、图像	1,000,000	仅 Standard 端点
`qwen/qwen3-max-2026-01-23`	文本	262,144	Qwen Max 系列
`qwen/qwen3-coder-next`	文本	262,144	Coding
`qwen/qwen3-coder-plus`	文本	1,000,000	Coding
`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 via Alibaba

两个官方提醒：种子目录里有 ≠ 你的端点真有（可用性随端点与计费套餐变化）；在 Standard 里列得出某模型，也不代表你有 Token Plan / Coding Plan 权限。

怎么选，三句话：

你的需求	选它	依据
不知道选啥	`qwen/qwen3.5-plus`	官方默认模型，1M 上下文
要最新的 qwen3.8 系列	`qwen/qwen3.8-max` / `qwen/qwen3.8-flash`	仅 Standard / Token Plan，Coding Plan 没有
主要写代码	`qwen/qwen3-coder-plus`（1M）/ `qwen/qwen3-coder-next`（262,144）	目录里的 Coding 专线

换默认模型：

bash

openclaw models set qwen/qwen3.5-plus

聊天里临时切也行：/model qwen/qwen3.7-plus 只影响当前会话，命令族详见聊天命令速成。

最后验证——发一句测试消息：

bash

openclaw agent --agent main --model qwen/qwen3.5-plus --message "用一句话介绍你自己"

（openclaw agent 要求至少给一个会话选择器，--agent main 指向默认 agent——完成过 onboarding 的安装里默认就有 main；或者 openclaw dashboard 打开 Control UI，在聊天框直接发。）

你应该看到：模型正常回复，没有凭据缺失或模型不存在的报错。到这里，OpenClaw 接入 Qwen 就通了。

Token Plan 用户：模型引用换成 qwen-token-plan/ 前缀，目录单独看：

bash

openclaw models list --provider qwen-token-plan
openclaw agent --agent main --model qwen-token-plan/qwen3.7-plus --message "Reply with: token plan ready"

（第二条改编自官方验证示例——原文没带会话选择器，openclaw agent 要求至少一个，这里补上 --agent main。）

Token Plan 内置目录（官方当前推荐的套餐模型；其余白名单 ID 可作自定义模型引用使用）：

模型引用	输入	上下文
`qwen-token-plan/qwen3.7-plus`	文本、图像	1,000,000
`qwen-token-plan/qwen3.8-max`	文本、图像	1,000,000
`qwen-token-plan/qwen3.8-flash`	文本、图像	1,000,000
`qwen-token-plan/qwen3.6-plus`	文本、图像	1,000,000
`qwen-token-plan/kimi-k2.5`	文本、图像	262,144
`qwen-token-plan/glm-5`	文本	202,752
`qwen-token-plan/MiniMax-M2.5`	文本	196,608

价格一句话：OpenClaw 的 Qwen 文档只给上下文规格、不给价格（明确指向厂商页面），三种套餐计费形态也不同（订阅 / 按量 / 团队积分）——计费一律以 Qwen Cloud 与阿里云官方页面为准。

测试消息收到了来自 Qwen 的回复

检查点 ✅

openclaw plugins install @openclaw/qwen-provider 已执行，插件在列
auth-choice 与你的套餐、区域配套（官方要求 matching plan and regional key）
openclaw models status 的凭据概览里能看到 qwen 的 QWEN_API_KEY（Token Plan 是 QWEN_TOKEN_PLAN_API_KEY）
openclaw models list --provider qwen 列出 qwen 系模型，没有 unsupported model 报错
测试消息发出后收到了 Qwen 的回复
没有把 Token Plan 配到定时任务 / 无人值守脚本上

踩坑提醒

❌ 只设了 QWEN_API_KEY，以为「变量名决定套餐和区域」

原因：官方明说——环境变量名既不选套餐、也不选区域。只给 QWEN_API_KEY、不配 baseUrl 时，OpenClaw 默认走国际站 Coding Plan 端点 https://coding-intl.dashscope.aliyuncs.com/v1。

正确做法：跑 onboarding 时选对 auth-choice，让 provider 自动选端点；手动配置就显式写 models.providers.qwen.baseUrl。显式端点配置优先级最高，但套餐与区域 Key 必须配套。

❌ Coding Plan 上找不到 qwen3.8-max / qwen3.8-flash

原因：qwen3.8-max、qwen3.8-flash、qwen3.7-max、qwen3.6-flash 仅 Standard 或 Token Plan 提供；OpenClaw 会把它们从 Coding Plan 目录里略去。在 Coding Plan 端点上用到它们会报 "unsupported model"——官方排障指引就是换端点。

text

# ❌ Coding Plan 端点上不可用
qwen/qwen3.8-max

# ✅ 换 Standard（或 Token Plan）端点 + 配套 Key
openclaw onboard --auth-choice qwen-standard-api-key-cn   # 国内站
openclaw onboard --auth-choice qwen-standard-api-key      # 国际站

❌ 拿 Token Plan 跑定时任务 / 无人值守脚本

原因：阿里官方声明 Token Plan 仅限交互式使用——cron 作业、无人值守脚本、应用后端这类非交互用法可能导致订阅被暂停或 API Key 被吊销。OpenClaw 的 Automations 定时任务、webhook、常驻服务全是无人值守用法：像每日晨报这种定时场景，千万别配 Token Plan。

正确做法：要跑 Automations、webhook、常驻服务，用 Standard（按量）或 Coding Plan 的 Key。

❌ 三种 Key 混着用，或还在用旧 Portal 凭据

原因：Token Plan、Coding Plan、按量付费的 Key 互不通用；旧 qwen-oauth Portal 认证已整体移除，Portal token 不与 Qwen Cloud / DashScope API Key 互通，存量凭据不会自动转换。

正确做法：一种套餐一套 Key + 一套端点；还在用 Portal 凭据的，按第 1、2 步重新做 API Key 认证。

❌ Gateway 装成守护进程后，export 的 Key「不生效」

原因：launchd / systemd 服务看不到交互 shell 的环境变量——Qwen 文档专门强调了这一点。

正确做法：QWEN_API_KEY / QWEN_TOKEN_PLAN_API_KEY 写进 ~/.openclaw/.env，或经配置里的 env.shellEnv 提供；换 Key 后重启 Gateway 服务。

❌ 想在 Coding Plan 上让模型看图 / 生成视频

原因：多模态能力（图像 / 视频理解、Wan 视频生成）只在 Standard 端点开放，Coding Plan 端点没有——哪怕目录里标着「文本、图像」。

正确做法：需要多模态就配 Standard 端点；媒体理解自动复用你配置的 Qwen 凭据，无需额外配置。

🔧 Qwen 专属能力（可选）

插件装好之后，四件 Qwen 专属的能力跟着来。

thinking 控制

qwen3.8-max / qwen3.8-flash 支持四档思考：off / low / medium / xhigh，默认 xhigh，最大输出 131,072 token。聊天里直接用：

text

/think xhigh   # 默认档
/think off     # 关闭思考

档位映射：minimal → low，high / max → xhigh（Standard 与 Token Plan 都适用）。工具调用期间，OpenClaw 把返回的推理放进单独的 reasoning_content 回放字段，不会混进正文。

qwen3.7-max / qwen3.7-plus / qwen3.6-flash / qwen3.6-plus 走另一套：OpenClaw 把思考档位映射到 DashScope 顶层的 enable_thinking 布尔——关闭发 enable_thinking: false，其余任何档位发 true。

⚠️ thinking_budget 与 reasoning_effort 不能同发

请求参数里显式写了 thinking_budget 时它优先；Qwen 会拒绝同时包含 thinking_budget 和映射后 reasoning_effort 的请求。

Token Plan 的模型同样支持思考；其中 kimi-k2.7-code 和 MiniMax-M2.5 是 thinking-only 模型——就算会话里 /think off，OpenClaw 也保持思考开启。

多模态与 Wan 视频生成（仅 Standard 端点）

Standard 端点上，同一个插件还开放两块多模态能力：

图像 / 视频理解：qwen3.6-plus
Wan 视频生成：wan2.6-t2v（默认）、wan2.6-i2v、wan2.6-r2v、wan2.6-r2v-flash、wan2.7-r2v

把 Qwen 设为默认视频 provider（官方配置示例，原样）：

json5

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

三个实用细节：

只给一张参考图、不给视频时，wan2.6-t2v 自动改走 wan2.6-i2v，结果里会报告实际解析到的模型
时长上限：文生视频 / 图生视频 15 秒；参考生视频（r2v 系列）10 秒，最多 5 个素材、其中视频最多 3 个
视频生成用 Standard 端点的 QWEN_API_KEY；媒体理解自动复用配置好的 Qwen 凭据

想系统玩配图、语音、视频，见图片与语音：给内容配图、把文章转语音。

一个 Key 认证两个插件：qwen 与 alibaba

OpenClaw 还有第二个连 DashScope 的插件 alibaba（内置、默认启用，不用装）：alibaba/* 专管 Wan 视频生成，qwen/* 管聊天与媒体理解，职责不重叠。

alibaba 的认证顺序：MODELSTUDIO_API_KEY → DASHSCOPE_API_KEY → QWEN_API_KEY（先到先得）。设一次 MODELSTUDIO_API_KEY，可以同时认证 alibaba 与 qwen 两个插件——两个插件的环境变量列表有意重叠。

alibaba 默认模型 alibaba/wan2.6-t2v，默认 baseUrl https://dashscope-intl.aliyuncs.com（中国区可覆盖为 https://dashscope.aliyuncs.com）。

DashScope 托管的第三方模型

Qwen 目录里不只有 Qwen：qwen/glm-5、qwen/glm-4.7（智谱 GLM）、qwen/kimi-k2.5（Moonshot AI）、qwen/MiniMax-M2.5 都托管在 DashScope 上——一把 DashScope Key 用四家模型。Token Plan 的官方定位就包含「Qwen 与受支持的第三方模型」。

旧写法兼容：modelstudio 与 bailian-token-plan

旧教程的 modelstudio-* auth-choice 与 modelstudio/... 模型引用仍可用（兼容别名），新配置一律用 qwen-* 与 qwen/...
阿里自己的 OpenClaw 指南用 bailian-token-plan 做手动自定义 provider——插件已注册该 id 为兼容 owner，新配置用 qwen-token-plan
显式定义 models.providers.modelstudio 或 models.providers.bailian-token-plan 条目时，对应前缀的引用归那个自定义 provider 接管

下一步

OpenClaw 通义千问配置到此通关。国产模型专页继续走：

下一课接入智谱 GLM：Z.AI 双端点与 Coding Plan：智谱双端点怎么选、ZAI_API_KEY 怎么配
其他模型专页（Kimi、MiniMax、豆包、混元 / 千帆、中转与本地模型）从连接模型总览的课程表进
模型配好了？日常使用从日常使用：和你的 Claw 高效相处开始——Control UI、聊天命令、记忆系统都在那一章

接入通义千问 Qwen：DashScope 三种套餐 ​

学完你能做什么 ​

🎒 开始前的准备 ​

跟我做 ​

第 1 步：注册 Qwen Cloud 并按套餐创建 API Key ​

第 2 步：OpenClaw 接入 Qwen——先装插件，再按套餐配 QWEN_API_KEY ​

方式 A（推荐）：onboarding 引导 ​

方式 B：手动改配置文件 ​

第 3 步：选择 Qwen 模型并验证 ​

检查点 ✅ ​

踩坑提醒 ​

❌ 只设了 QWEN_API_KEY，以为「变量名决定套餐和区域」 ​

❌ Coding Plan 上找不到 qwen3.8-max / qwen3.8-flash ​

❌ 拿 Token Plan 跑定时任务 / 无人值守脚本 ​

❌ 三种 Key 混着用，或还在用旧 Portal 凭据 ​

❌ Gateway 装成守护进程后，export 的 Key「不生效」 ​

❌ 想在 Coding Plan 上让模型看图 / 生成视频 ​

🔧 Qwen 专属能力（可选） ​

thinking 控制 ​

多模态与 Wan 视频生成（仅 Standard 端点） ​

一个 Key 认证两个插件：qwen 与 alibaba ​

DashScope 托管的第三方模型 ​

下一步 ​

相关教程 ​

接入通义千问 Qwen：DashScope 三种套餐

学完你能做什么

🎒 开始前的准备

跟我做

第 1 步：注册 Qwen Cloud 并按套餐创建 API Key

第 2 步：OpenClaw 接入 Qwen——先装插件，再按套餐配 QWEN_API_KEY

方式 A（推荐）：onboarding 引导

方式 B：手动改配置文件

第 3 步：选择 Qwen 模型并验证

检查点 ✅

踩坑提醒

❌ 只设了 QWEN_API_KEY，以为「变量名决定套餐和区域」

❌ Coding Plan 上找不到 qwen3.8-max / qwen3.8-flash

❌ 拿 Token Plan 跑定时任务 / 无人值守脚本

❌ 三种 Key 混着用，或还在用旧 Portal 凭据

❌ Gateway 装成守护进程后，export 的 Key「不生效」

❌ 想在 Coding Plan 上让模型看图 / 生成视频

🔧 Qwen 专属能力（可选）

thinking 控制

多模态与 Wan 视频生成（仅 Standard 端点）

一个 Key 认证两个插件：qwen 与 alibaba

DashScope 托管的第三方模型

下一步

相关教程