# 阿里云百炼大模型服务平台

> OpenClaw 中的阿里云百炼 Wan 视频生成

- 网址：https://funcoding.ai/agents/openclaw/providers/alibaba/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/providers/alibaba

---
内置的 `alibaba` 插件为 Alibaba Model Studio（DashScope 的国际名称）上的 Wan 模型注册了视频生成提供商。该插件默认启用，只需 API 密钥即可使用。

| 属性             | 值                                                                              |
| ---------------- | ------------------------------------------------------------------------------- |
| 提供商 ID        | `alibaba`                                                              |
| 插件             | 内置，`enabledByDefault: true`                                                        |
| 身份验证环境变量 | `MODELSTUDIO_API_KEY` → `DASHSCOPE_API_KEY` → `QWEN_API_KEY`（首个匹配项生效） |
| 新手引导标志     | `--auth-choice alibaba-model-studio-api-key`                                                              |
| 直接 CLI 标志    | `--alibaba-model-studio-api-key <key>`                                                              |
| 默认模型         | `alibaba/wan2.6-t2v`                                                              |
| 默认基础 URL     | `https://dashscope-intl.aliyuncs.com`                                                              |

## 入门指南

**设置 API 密钥**

通过新手引导将密钥存储到 `alibaba` 提供商：

```bash
openclaw onboard --auth-choice alibaba-model-studio-api-key
```

或直接传入密钥：

```bash
openclaw onboard --alibaba-model-studio-api-key <your-key>
```

或在启动 Gateway 网关前导出任一受支持的环境变量：

```bash
export MODELSTUDIO_API_KEY=sk-...
# 或 DASHSCOPE_API_KEY=...
# 或 QWEN_API_KEY=...
```

**设置默认视频模型**

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

**验证提供商已配置**

```bash
openclaw models list --provider alibaba
```

列表中包含全部五个内置 Wan 模型。如果无法解析 `MODELSTUDIO_API_KEY`，`openclaw models status --json` 会在 `auth.unusableProfiles` 下报告缺失的凭据。

<div class="callout callout-note">

Alibaba 插件和 [Qwen 插件](https://funcoding.ai/agents/openclaw/providers/qwen/)都通过 DashScope 进行身份验证，并接受部分相同的环境变量。专用 Wan 视频功能使用 `alibaba/...` 模型 ID；Qwen 聊天、嵌入或媒体理解使用 `qwen/...` ID。

</div>

## 内置 Wan 模型

| 模型引用                   | 模式                      |
| -------------------------- | ------------------------- |
| `alibaba/wan2.6-t2v`         | 文本生成视频（默认）      |
| `alibaba/wan2.6-i2v`         | 图像生成视频              |
| `alibaba/wan2.6-r2v`         | 参考内容生成视频          |
| `alibaba/wan2.6-r2v-flash`         | 参考内容生成视频（快速）  |
| `alibaba/wan2.7-r2v`         | 参考内容生成视频          |

## 能力和限制

三种模式的每次请求视频数量和时长上限相同，只有输入形式不同。

| 模式               | 最大输出视频数 | 最大输入图像数 | 最大输入视频数 | 最大时长 | 支持的控制项                                              |
| ------------------ | -------------- | -------------- | -------------- | -------- | --------------------------------------------------------- |
| 文本生成视频       | 1              | 不适用         | 不适用         | 10 s     | `size`、`aspectRatio`、`resolution`、`audio`、`watermark` |
| 图像生成视频       | 1              | 1              | 不适用         | 10 s     | `size`、`aspectRatio`、`resolution`、`audio`、`watermark` |
| 参考内容生成视频   | 1              | 不适用         | 4              | 10 s     | `size`、`aspectRatio`、`resolution`、`audio`、`watermark` |

省略 `durationSeconds` 的请求将使用 DashScope 接受的默认值 **5 秒**。在[视频生成工具](https://funcoding.ai/agents/openclaw/tools/video-generation/)上显式设置 `durationSeconds`，可将时长延长至 10 s。

<div class="callout callout-warning">

参考图像和视频输入必须是远程 `http(s)` URL；DashScope 的参考模式会拒绝本地文件路径。请先上传到对象存储，或使用已经能够生成公开 URL 的[媒体工具](https://funcoding.ai/agents/openclaw/tools/media-overview/)流程。

</div>

## 高级配置

<details>
<summary>覆盖 DashScope 基础 URL</summary>

提供商默认使用 DashScope 国际端点。要改用中国区域端点：

```json5
{
  models: {
    providers: {
      alibaba: {
        baseUrl: "https://dashscope.aliyuncs.com",
      },
    },
  },
}
```

提供商会先移除末尾斜杠，再构造 AIGC 任务 URL。

</details>

<details>
<summary>身份验证环境变量优先级</summary>

OpenClaw 按以下顺序从环境变量解析 Alibaba API 密钥，并采用首个非空值：

1. `MODELSTUDIO_API_KEY`
2. `DASHSCOPE_API_KEY`
3. `QWEN_API_KEY`

已配置的 `auth.profiles` 条目（通过 `openclaw models auth login` 设置）会覆盖环境变量解析。有关配置文件轮换、冷却和覆盖机制，请参阅[模型常见问题中的身份验证配置文件](https://funcoding.ai/agents/openclaw/help/faq-models/#auth-profiles-what-they-are-and-how-to-manage-them)。

</details>

<details>
<summary>与 Qwen 插件的关系</summary>

两个内置插件都与 DashScope 通信，并接受部分相同的 API 密钥。请使用：

- `alibaba/wan*.*` ID，用于本页所述的专用 Wan 视频提供商。
- `qwen/*` ID，用于 Qwen 聊天、嵌入和媒体理解（参阅 [Qwen](https://funcoding.ai/agents/openclaw/providers/qwen/)）。

由于身份验证环境变量列表有意重叠，只需设置一次 `MODELSTUDIO_API_KEY` 即可对两个插件进行身份验证；无需分别对每个插件执行新手引导。

</details>

## 相关内容

- [视频生成](https://funcoding.ai/agents/openclaw/tools/video-generation/)：共享的视频工具参数和提供商选择。
- [Qwen](https://funcoding.ai/agents/openclaw/providers/qwen/)：使用同一 DashScope 身份验证配置 Qwen 聊天、嵌入和媒体理解。
- [配置参考](https://funcoding.ai/agents/openclaw/gateway/config-agents/#agent-defaults)：Agent 默认设置和模型配置。
- [模型常见问题](https://funcoding.ai/agents/openclaw/help/faq-models/)：身份验证配置文件、切换模型以及解决“无配置文件”错误。