Skip to main content
内置的 alibaba 插件为 Alibaba Model Studio（DashScope 的国际名称）上的 Wan 模型注册视频生成提供商。它默认启用；只需要 API key。
属性值
提供商 idalibaba
插件内置，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
默认基础 URLhttps://dashscope-intl.aliyuncs.com

​
入门指南

1

设置 API key

通过新手引导为 alibaba 提供商存储密钥：
openclaw onboard --auth-choice alibaba-model-studio-api-key
或直接传入密钥：
openclaw onboard --alibaba-model-studio-api-key <your-key>
或在启动 Gateway 网关前导出一个受支持的环境变量：
export MODELSTUDIO_API_KEY=sk-...
# or DASHSCOPE_API_KEY=...
# or QWEN_API_KEY=...
2

设置默认视频模型

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

验证提供商已配置

openclaw models list --provider alibaba
列表包含全部五个内置 Wan 模型。如果无法解析 MODELSTUDIO_API_KEY，openclaw models status --json 会在 auth.unusableProfiles 下报告缺失的凭据。
Alibaba 插件和 Qwen 插件 都面向 DashScope 进行认证，并接受重叠的环境变量。对于专用的 Wan 视频能力面，请使用 alibaba/... 模型 id；对于 Qwen 聊天、嵌入或媒体理解，请使用 qwen/... id。

​
内置 Wan 模型

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

​
能力和限制

三种模式共享相同的每请求视频数量和时长上限；只有输入形态不同。
模式最大输出视频数最大输入图像数最大输入视频数最大时长支持的控制项
文本转视频1n/an/a10 ssize, aspectRatio, resolution, audio, watermark
图像转视频11n/a10 ssize, aspectRatio, resolution, audio, watermark
参考转视频1n/a410 ssize, aspectRatio, resolution, audio, watermark
省略 durationSeconds 的请求会使用 DashScope 接受的默认值：5 秒。在视频生成工具上显式设置 durationSeconds，即可延长至最高 10 s。
参考图像和视频输入必须是远程 http(s) URL；DashScope 的参考模式会拒绝本地文件路径。请先上传到对象存储，或使用已经生成公共 URL 的媒体工具流程。

​
高级配置

提供商默认使用国际 DashScope 端点。若要面向中国区域端点：
{
  models: {
    providers: {
      alibaba: {
        baseUrl: "https://dashscope.aliyuncs.com",
      },
    },
  },
}
提供商会先移除末尾斜杠，然后再构造 AIGC 任务 URL。
OpenClaw 按以下顺序从环境变量解析 Alibaba API key，并采用第一个非空值：
  1. MODELSTUDIO_API_KEY
  2. DASHSCOPE_API_KEY
  3. QWEN_API_KEY
已配置的 auth.profiles 条目（通过 openclaw models auth login 设置）会覆盖环境变量解析。关于配置文件轮换、冷却和覆盖机制，请参阅模型常见问题中的认证配置文件。
两个内置插件都与 DashScope 通信，并接受重叠的 API key。使用：
  • alibaba/wan*.* id 用于本页记录的专用 Wan 视频提供商。
  • qwen/* id 用于 Qwen 聊天、嵌入和媒体理解（参见 Qwen）。
由于认证环境变量列表有意重叠，设置一次 MODELSTUDIO_API_KEY 即可认证两个插件；不需要分别对每个插件执行新手引导。

​
相关

视频生成

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

Qwen

在同一个 DashScope 认证上设置 Qwen 聊天、嵌入和媒体理解。

配置参考

Agent 默认值和模型配置。

模型常见问题

认证配置文件、切换模型以及解决 “no profile” 错误。