Skip to main content
OpenClaw 自带一个捆绑的 alibaba 插件，用于注册 Alibaba Model Studio 上 Wan 模型的视频生成提供方（DashScope 的国际名称）。该插件默认启用；你只需要设置一个 API 密钥。
PropertyValue
Provider idalibaba
Pluginbundled, enabledByDefault: true
Auth env varsMODELSTUDIO_API_KEY → DASHSCOPE_API_KEY → QWEN_API_KEY (first match wins)
Onboarding flag--auth-choice alibaba-model-studio-api-key
Direct CLI flag--alibaba-model-studio-api-key <key>
Default modelalibaba/wan2.6-t2v
Default base URLhttps://dashscope-intl.aliyuncs.com

​
入门

1

Set an API key

使用 onboarding 将密钥存储到 alibaba 提供方：
openclaw onboard --auth-choice alibaba-model-studio-api-key
或在安装/onboarding 期间直接传入密钥：
openclaw onboard --alibaba-model-studio-api-key <your-key>
或在启动 Gateway 之前导出任一可接受的环境变量：
export MODELSTUDIO_API_KEY=sk-...
# 或 DASHSCOPE_API_KEY=...
# 或 QWEN_API_KEY=...
2

设置默认视频模型

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

Verify the provider is configured

openclaw models list --provider alibaba
列表中应包含全部五个内置 Wan 模型。如果 MODELSTUDIO_API_KEY 未解析，openclaw models status --json 会在 auth.unusableProfiles 下报告缺失的凭据。
Alibaba 插件和 Qwen 插件 都通过 DashScope 进行身份验证，并接受重叠的环境变量。使用 alibaba/... 模型 id 来驱动专用的 Wan 视频界面；当你想使用 Qwen 的聊天、嵌入或媒体理解界面时，则使用 qwen/... id。

​
内置 Wan 模型

Model refMode
alibaba/wan2.6-t2v文本生成视频（默认）
alibaba/wan2.6-i2v图片生成视频
alibaba/wan2.6-r2v参考图生成视频
alibaba/wan2.6-r2v-flash参考图生成视频（快速）
alibaba/wan2.7-r2v参考图生成视频

​
功能与限制

该捆绑提供方与 DashScope 的 Wan 视频 API 限额保持一致。三种模式共享相同的每次请求视频数量和时长限制；区别仅在于输入形式。
ModeMax output videosMax input imagesMax input videosMax durationSupported controls
文本生成视频1不适用不适用10 ssize, aspectRatio, resolution, audio, watermark
图片生成视频11不适用10 ssize, aspectRatio, resolution, audio, watermark
参考图生成视频1不适用410 ssize, aspectRatio, resolution, audio, watermark
当请求未指定 durationSeconds 时，该提供方会发送 DashScope 接受的默认值 5 秒。请在 video generation tool 上显式设置 durationSeconds，以将时长延长至最多 10 秒。
参考图片和视频输入必须是远程 http(s) URL。DashScope 的参考模式不接受本地文件路径；请先上传到对象存储，或使用已可生成公共 URL 的 media tool 流程。

​
高级配置

该提供方默认使用国际版 DashScope 端点。若要目标指向中国区端点，请设置：
{
  models: {
    providers: {
      alibaba: {
        baseUrl: "https://dashscope.aliyuncs.com",
      },
    },
  },
}
该提供方在构建 AIGC 任务 URL 之前会去除尾部斜杠。
OpenClaw 按以下顺序从环境变量中解析 Alibaba API 密钥，采用第一个非空值：
  1. MODELSTUDIO_API_KEY
  2. DASHSCOPE_API_KEY
  3. QWEN_API_KEY
通过 openclaw models auth login 设置的 auth.profiles 条目会覆盖环境变量解析。有关配置文件轮换、冷却时间和覆盖机制，请参见 模型 FAQ 中的 Auth profiles。
这两个捆绑插件都与 DashScope 通信，并接受重叠的 API 密钥。请使用：
  • alibaba/wan*.* id 来驱动本页所述的专用 Wan 视频提供方。
  • qwen/* id 用于 Qwen 聊天、嵌入和媒体理解（参见 Qwen）。
只需设置一次 MODELSTUDIO_API_KEY 即可同时对两个插件完成身份验证，因为身份验证环境变量列表有意重叠；你不需要分别为每个插件进行 onboarding。

​
相关

视频生成

共享的视频工具参数和提供方选择。

Qwen

在同一 DashScope 身份验证下进行 Qwen 聊天、嵌入和媒体理解的设置。

配置参考

Agent 默认值和模型配置。

Models FAQ

Auth profiles、切换模型，以及解决“no profile”错误。