Appearance
OpenClaw 内置 alibaba provider 直接对接阿里云 Model Studio（DashScope）的 Wan 视频生成，无需额外安装插件。只需设置 MODELSTUDIO_API_KEY 或通过 onboarding 引导即可使用。默认模型是 alibaba/wan2.6-t2v，视频最长 10 秒，每次请求只输出 1 个视频。参考图/视频必须使用远程 http(s) URL。通过 openclaw models list --provider alibaba 验证模型列表。如果认证缺失，openclaw models status --json 会报告 auth.unusableProfiles。
OpenClaw 阿里云 Model Studio 视频生成配置指南
OpenClaw 内置了 alibaba 插件，该插件注册了一个视频生成 provider，对接阿里云 Model Studio（DashScope 国际版）上的 Wan 系列模型。插件默认启用，你只需设置 API Key 即可使用。
| 属性 | 值 |
|---|---|
| Provider ID | alibaba |
| 插件类型 | 内置，enabledByDefault: true |
| 认证环境变量 | MODELSTUDIO_API_KEY → DASHSCOPE_API_KEY → QWEN_API_KEY（按顺序匹配第一个非空值） |
| Onboarding 标志 | --auth-choice alibaba-model-studio-api-key |
| 直接 CLI 标志 | --alibaba-model-studio-api-key <key> |
| 默认模型 | alibaba/wan2.6-t2v |
| 默认 Base URL | https://dashscope-intl.aliyuncs.com |
快速开始
设置 API Key
使用 onboarding 将 Key 存入 `alibaba` provider：
```bash
openclaw onboard --auth-choice alibaba-model-studio-api-key
```
也可以直接在安装/onboarding 时传入 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",
},
},
},
}
```
验证 provider 配置
```bash
openclaw models list --provider alibaba
```
输出应包含全部五个内置 Wan 模型。如果 `MODELSTUDIO_API_KEY` 未解析，`openclaw models status --json` 会在 `auth.unusableProfiles` 中报告缺失的凭据。
INFO
alibaba 插件和 Qwen 插件 都使用 DashScope 认证，且接受重叠的环境变量。使用 alibaba/... 模型 ID 走专用的 Wan 视频生成接口；使用 qwen/... 用于 Qwen 的对话、嵌入和媒体理解接口。
内置 Wan 模型列表
| 模型引用 | 模式 |
|---|---|
alibaba/wan2.6-t2v | 文生视频（默认） |
alibaba/wan2.6-i2v | 图生视频 |
alibaba/wan2.6-r2v | 参考视频生成 |
alibaba/wan2.6-r2v-flash | 参考视频生成（快速版） |
alibaba/wan2.7-r2v | 参考视频生成 |
功能与限制
该内置 provider 直接映射 DashScope Wan 视频 API 的限制。三种模式共享相同的每请求视频数量和时长上限，仅输入格式不同。
| 模式 | 最大输出视频数 | 最大输入图片数 | 最大输入视频数 | 最大时长 | 支持的控制参数 |
|---|---|---|---|---|---|
| 文生视频 | 1 | 无 | 无 | 10 秒 | size, aspectRatio, resolution, audio, watermark |
| 图生视频 | 1 | 1 | 无 | 10 秒 | size, aspectRatio, resolution, audio, watermark |
| 参考视频生成 | 1 | 无 | 4 | 10 秒 | size, aspectRatio, resolution, audio, watermark |
当请求中省略 durationSeconds 时，provider 会发送 DashScope 接受的默认值 5 秒。如需延长到 10 秒，在视频生成工具中显式设置 durationSeconds。
WARNING
参考图片和视频输入必须是远程 http(s) URL。DashScope 的参考模式不接受本地文件路径。请先上传到对象存储，或使用媒体工具流程（该流程已生成公开 URL）。
高级配置
覆盖 DashScope Base URL
provider 默认使用国际版 DashScope 端点。要指向中国区端点，设置：
```json5
{
models: {
providers: {
alibaba: {
baseUrl: "https://dashscope.aliyuncs.com",
},
},
},
}
```
provider 在构建 AIGC 任务 URL 前会去掉尾部斜杠。
认证环境变量优先级
OpenClaw 按以下顺序从环境变量中解析 alibaba API Key，取第一个非空值：
1. `MODELSTUDIO_API_KEY`
2. `DASHSCOPE_API_KEY`
3. `QWEN_API_KEY`
通过 `openclaw models auth login` 配置的 `auth.profiles` 条目会覆盖环境变量解析。详见[模型 FAQ 中的认证 profile](/ai/ai-tools/openclaw/help/faq-models#认证-profile-是什么) 了解 profile 轮转、冷却和覆盖机制。
与 Qwen 插件的关系
两个内置插件都对接 DashScope 且接受重叠的 API Key。使用：
- `alibaba/wan*.*` 模型 ID 走本页所述的专用 Wan 视频 provider。
- `qwen/*` 模型 ID 用于 Qwen 对话、嵌入和媒体理解（参见 [Qwen](/ai/ai-tools/openclaw/providers/qwen)）。
只需设置一次 `MODELSTUDIO_API_KEY` 即可认证两个插件（因为环境变量列表有意重叠），不需要分别 onboard 每个插件。
相关文档
- 视频生成工具 — 共享的视频工具参数和 provider 选择。
- Qwen — 基于同一 DashScope 认证的 Qwen 对话、嵌入和媒体理解配置。
- 配置参考 — 智能体默认值和模型配置。
- 模型 FAQ — 认证 profile、切换模型和解决“无 profile”错误。
常见问题
API Key 设置后不生效怎么办？
检查环境变量是否在 Gateway 启动前导出。使用 openclaw models list --provider alibaba 查看模型列表：如果列表为空，说明认证未解析。可以运行 openclaw models status --json 查看 auth.unusableProfiles 中缺失的凭据。确认变量名正确（按优先级：MODELSTUDIO_API_KEY、DASHSCOPE_API_KEY、QWEN_API_KEY）。
视频生成只输出 5 秒，怎么延长到 10 秒？
默认未设置 durationSeconds 时，provider 发送 5 秒。在调用视频生成工具时显式设置 durationSeconds: 10 即可延长到上限 10 秒。注意视频时长上限由 DashScope 控制，不可超过 10 秒。
参考视频素材必须是远程 URL 吗？本地文件怎么处理？
是的，DashScope 的参考模式（r2v 系列）只接受 http(s) URL。本地文件需要先上传到对象存储（如阿里云 OSS、AWS S3）获得公开 URL，或者使用 OpenClaw 的媒体工具流程（它会自动上传并返回可访问的 URL）。