跳到正文
FunCoding

搜索

搜索文档、Skill 和 MCP

阿里云百炼大模型服务平台

OpenClaw 中的阿里云百炼 Wan 视频生成

内置的 alibaba 插件为 Alibaba Model Studio(DashScope 的国际名称)上的 Wan 模型注册了视频生成提供商。该插件默认启用,只需 API 密钥即可使用。

属性值
提供商 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

入门指南

设置 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-...
# 或 DASHSCOPE_API_KEY=...
# 或 QWEN_API_KEY=...

设置默认视频模型

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

验证提供商已配置

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参考内容生成视频

能力和限制

三种模式的每次请求视频数量和时长上限相同,只有输入形式不同。

模式最大输出视频数最大输入图像数最大输入视频数最大时长支持的控制项
文本生成视频1不适用不适用10 ssize、aspectRatio、resolution、audio、watermark
图像生成视频11不适用10 ssize、aspectRatio、resolution、audio、watermark
参考内容生成视频1不适用410 ssize、aspectRatio、resolution、audio、watermark

省略 durationSeconds 的请求将使用 DashScope 接受的默认值 5 秒。在视频生成工具上显式设置 durationSeconds,可将时长延长至 10 s。

参考图像和视频输入必须是远程 http(s) URL;DashScope 的参考模式会拒绝本地文件路径。请先上传到对象存储,或使用已经能够生成公开 URL 的媒体工具流程。

高级配置

覆盖 DashScope 基础 URL

提供商默认使用 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

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

与 Qwen 插件的关系

两个内置插件都与 DashScope 通信,并接受部分相同的 API 密钥。请使用:

  • alibaba/wan*.* ID,用于本页所述的专用 Wan 视频提供商。
  • qwen/* ID,用于 Qwen 聊天、嵌入和媒体理解(参阅 Qwen)。

由于身份验证环境变量列表有意重叠,只需设置一次 MODELSTUDIO_API_KEY 即可对两个插件进行身份验证;无需分别对每个插件执行新手引导。

相关内容

  • 视频生成:共享的视频工具参数和提供商选择。
  • Qwen:使用同一 DashScope 身份验证配置 Qwen 聊天、嵌入和媒体理解。
  • 配置参考:Agent 默认设置和模型配置。
  • 模型常见问题:身份验证配置文件、切换模型以及解决“无配置文件”错误。