Alibaba Model Studio

内置 alibaba 插件为 Alibaba Model Studio（DashScope 的国际名称）上的 Wan 模型注册了一个视频生成提供商。它默认启用；只需要一个 API 密钥。

快速入门¶

1. 设置 API 密钥

通过引导流程将密钥存储到 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: {
      mediaModels: {
        video: {
          primary: "alibaba/wan2.6-t2v",
        },
      },
    },
  },
}

3. 验证提供商已配置

openclaw models list --provider alibaba

列表包含全部五个内置 Wan 模型。如果无法解析 MODELSTUDIO_API_KEY，openclaw models status --json 会在 auth.unusableProfiles 下报告缺失的凭据。

内置 Wan 模型¶

功能与限制¶

当恰好有一个参考图像且没有视频时，wan2.6-t2v 会自动 使用 wan2.6-i2v；结果会报告解析后的模型。此路由仅适用于 已知模型目录中存在同代图像生成视频同级模型的情况。其他请求使用 所选模型的模式。几何参数遵循 该模型系列的供应商协议。

Wan 2.6 文本/参考模型会将 resolution 和 aspectRatio 转换为 文档中规定的精确 size。Wan 2.6 图像生成视频会发送 resolution 级别，并 使用输入图像的宽高比。Wan 2.7 参考生成视频会发送较新的 media、resolution 和 ratio 字段，并始终生成音频。

如果请求省略 durationSeconds，则使用 DashScope 接受的默认值 5 秒。

图像生成视频和 Wan 2.7 参考图像接受本地文件或远程 http(s) URL。OpenClaw 将本地图像作为 base64 data URI 发送，编码前每个 图像最大为 20 MB。请参阅 Model Studio 参考文档中的 图像生成视频 和 Wan 2.7 参考生成视频。 参考视频和 Wan 2.6 参考生成视频图像仍要求使用远程 http(s) URL。

高级配置¶

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

相关¶

视频生成

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

Qwen

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

配置参考

代理默认设置和模型配置。

模型常见问题

身份验证配置文件、切换模型以及解决 "no profile" 错误。