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 即可使用。

快速开始 #

设置 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 模型列表 #

功能与限制 #

该内置 provider 直接映射 DashScope Wan 视频 API 的限制。三种模式共享相同的每请求视频数量和时长上限，仅输入格式不同。

当请求中省略 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）。