# Qwen

> 通过 OpenClaw 插件使用 Qwen Cloud

- 网址：https://funcoding.ai/agents/openclaw/providers/qwen/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/providers/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`                         |
| Token Plan 提供商      | `qwen-token-plan`                         |
| 首选环境变量           | `QWEN_API_KEY`                         |
| Token Plan 环境变量    | `QWEN_TOKEN_PLAN_API_KEY`                         |
| 也接受（兼容）         | `MODELSTUDIO_API_KEY`, `DASHSCOPE_API_KEY`     |
| API 风格               | OpenAI 兼容                                |

<div class="callout callout-tip">

`qwen3.7-plus` 和 `qwen3.6-plus` 可用于 Coding Plan 和 Standard 端点。
对于 `qwen3.7-max` 或 `qwen3.6-flash`，请使用 **Standard（按量付费）**端点。

</div>

## 安装插件

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

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

## 入门指南

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

**Coding Plan（订阅）**

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

**获取 API 密钥**

在 [home.qwencloud.com/api-keys](https://home.qwencloud.com/api-keys) 创建或复制 API 密钥。

**运行新手引导**

对于**全球**端点：

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

对于**中国**端点：

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

**设置默认模型**

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

**验证模型是否可用**

```bash
openclaw models list --provider qwen
```

<div class="callout callout-note">

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

</div>

**Standard（按量付费）**

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

**获取 API 密钥**

在 [home.qwencloud.com/api-keys](https://home.qwencloud.com/api-keys) 创建或复制 API 密钥。

**运行新手引导**

对于**全球**端点：

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

对于**中国**端点：

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

**设置默认模型**

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

**验证模型是否可用**

```bash
openclaw models list --provider qwen
```

<div class="callout callout-note">

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

</div>

**Token Plan（团队版）**

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

**获取专用密钥**

分配一个 Token Plan 席位，并创建其专用的 `sk-sp-...` 密钥。Token Plan、Coding Plan 和按量付费密钥不可互换。请参阅[全球 Token Plan 概览](https://www.alibabacloud.com/help/en/model-studio/token-plan-overview)或[中国 Token Plan 概览](https://help.aliyun.com/zh/model-studio/token-plan-overview)。

**运行新手引导**

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

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

对于位于北京的**中国**端点：

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

**验证提供商**

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

<div class="callout callout-note">

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

</div>

<div class="callout callout-warning">

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

</div>

## 计划类型和端点

| 计划                       | 区域 | 身份验证选择               | 端点                                                             |
| -------------------------- | ---- | -------------------------- | ---------------------------------------------------------------- |
| 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（团队版）       | 中国 | `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` 覆盖。

<div class="callout callout-tip">

**管理密钥：**[home.qwencloud.com/api-keys](https://home.qwencloud.com/api-keys) |
**文档：**[docs.qwencloud.com](https://docs.qwencloud.com/developer-guides/getting-started/introduction)

</div>

## 内置目录

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,000 | Coding Plan + Standard  |
| `qwen/qwen3.7-max`          | 文本         | 1,000,000 | 仅限 Standard 端点      |
| `qwen/qwen3.7-plus`          | 文本、图像   | 1,000,000 | Coding Plan + Standard  |
| `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   | 通过 Alibaba 使用 Moonshot AI |

<div class="callout callout-note">

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

</div>

### 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 设为默认视频提供商：

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

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

<div class="callout callout-note">

有关共享工具参数、提供商选择和故障转移行为，请参阅[视频生成](https://funcoding.ai/agents/openclaw/tools/video-generation/)。

</div>

## 高级配置

<details>
<summary>Qwen 3.6 和 3.7 可用性</summary>

`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 端点和密钥。

</details>

<details>
<summary>视频生成区域路由</summary>

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

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

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

</details>

<details>
<summary>流式用量兼容性</summary>

原生 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`

</details>

<details>
<summary>能力规划</summary>

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

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

</details>

<details>
<summary>环境和守护进程设置</summary>

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

</details>

## 相关内容

- [模型选择](https://funcoding.ai/agents/openclaw/concepts/model-providers/)：选择提供商、模型引用和故障转移行为。
- [视频生成](https://funcoding.ai/agents/openclaw/tools/video-generation/)：共享视频工具参数和提供商选择。
- [Alibaba Model Studio](https://funcoding.ai/agents/openclaw/providers/alibaba/)：同一 DashScope 平台上的内置 Wan 视频生成提供商。
- [故障排查](https://funcoding.ai/agents/openclaw/help/troubleshooting/)：常规故障排查和常见问题。