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

内置的 alibaba 插件为 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 密钥

通过新手引导将密钥存储到 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 s	`size`、`aspectRatio`、`resolution`、`audio`、`watermark`
图像生成视频	1	1	不适用	10 s	`size`、`aspectRatio`、`resolution`、`audio`、`watermark`
参考内容生成视频	1	不适用	4	10 s	`size`、`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 密钥，并采用首个非空值：

MODELSTUDIO_API_KEY
DASHSCOPE_API_KEY
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 默认设置和模型配置。

模型常见问题

身份验证配置文件、切换模型以及解决“无配置文件”错误。

概览

模型概念

提供商

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

入门指南

内置 Wan 模型

能力和限制

高级配置

相关内容

视频生成

Qwen

配置参考

模型常见问题

​入门指南

​内置 Wan 模型

​能力和限制

​高级配置

​相关内容

视频生成

Qwen

配置参考

模型常见问题

入门指南

内置 Wan 模型

能力和限制

高级配置

相关内容