Alibaba Model Studio

OpenClaw 随附了一个捆绑的 OpenClawalibabaAPI 插件，该插件在 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设置 API 密钥

使用新手引导将密钥存储到 alibaba 提供商下：

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

或者在安装/新手引导期间直接传递密钥：

openclaw onboard --alibaba-model-studio-api-key

或者在启动 Gateway 之前导出任何接受的环境变量：

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

设置默认视频模型

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

验证提供商是否已配置
Terminal window
```
openclaw models list --provider alibaba
```
该列表应包含所有五个捆绑的 Wan 模型。如果 MODELSTUDIO_API_KEY 未解析，openclaw models status --json 将在 auth.unusableProfiles 下报告缺少凭据。

内置 Wan 模型

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

功能和限制

内置提供商反映了 DashScope 的 Wan 视频 API 限制。所有三种模式共享相同的单次请求视频数量和时长限制；仅输入形状不同。

模式	最大输出视频数	最大输入图像数	最大输入视频数	最大时长	支持的控件
文本生成视频	1	n/a	n/a	10 秒	`size`, `aspectRatio`, `resolution`, `audio`, `watermark`
图像生成视频	1	1	n/a	10 秒	`size`, `aspectRatio`, `resolution`, `audio`, `watermark`
参考生成视频	1	n/a	4	10 秒	`size`, `aspectRatio`, `resolution`, `audio`, `watermark`

当请求省略 durationSeconds 时，提供商发送 DashScope 接受的默认值 5 秒。请在视频生成工具上显式设置 durationSeconds 以延长至 10 秒。

高级配置

覆盖 DashScope 基础 URL

提供商默认使用国际版 DashScope 端点。若要针对中国区域端点，请设置：

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

提供商在构建 AIGC 任务 URL 之前会移除末尾的斜杠。

身份验证环境变量优先级

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

MODELSTUDIO_API_KEY
DASHSCOPE_API_KEY
QWEN_API_KEY

配置的 auth.profiles 条目（通过 openclaw models auth login 设置）会覆盖环境变量解析。有关配置文件的轮换、冷却和覆盖机制，请参阅模型常见问题中的身份验证配置文件。

<Accordion title=“Qwen与 Qwen 插件的关系”API> 这两个内置插件都与 DashScope 通信，并且接受可通用的 API 密钥。请使用：

- `alibaba/wan*.*` id 来驱动本页面记录的专用 Wan 视频提供商。
- `qwen/*`QwenQwen id 进行 Qwen 聊天、嵌入和媒体理解（请参阅 [Qwen](/zh/providers/qwen)）。

由于身份验证环境变量列表有意重叠，因此只需设置一次 `MODELSTUDIO_API_KEY` 即可完成两个插件的身份验证；您无需分别为每个插件进行接入。