快速开始

阿里云百炼

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

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

入门指南

通过新手引导为 alibaba 提供商存储密钥：

bash

openclaw onboard --auth-choice alibaba-model-studio-api-key

或直接传入密钥：

bash

openclaw onboard --alibaba-model-studio-api-key <your-key>

或在启动 Gateway 网关前导出任一受支持的环境变量：

bash

export MODELSTUDIO_API_KEY=sk-...# 或 DASHSCOPE_API_KEY=...# 或 QWEN_API_KEY=...

json5

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

bash

openclaw models list --provider alibaba

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

三种模式具有相同的单次请求视频数量和时长上限，只有输入格式不同。

模式	最大输出视频数	最大输入图像数	最大输入视频数	最大时长	支持的控制项
文本生成视频	1	不适用	不适用	10 秒	`size`、`aspectRatio`、`resolution`、`audio`、`watermark`
图像生成视频	1	1	不适用	10 秒	`size`、`aspectRatio`、`resolution`、`audio`、`watermark`
参考素材生成视频	1	不适用	4	10 秒	`size`、`aspectRatio`、`resolution`、`audio`、`watermark`

未指定 durationSeconds 的请求将使用 DashScope 接受的默认值 5 秒。在视频生成工具中显式设置 durationSeconds，可将时长延长至最多 10 秒。

Override the DashScope base URL

该提供商默认使用 DashScope 国际端点。要改用中国区域端点：

json5

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

提供商会先移除末尾的斜杠，再构建 AIGC 任务 URL。

Auth env priority

OpenClaw 按以下顺序从环境变量中解析 Alibaba API key，并采用首个非空值：

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

Relationship to the Qwen plugin

两个内置插件都与 DashScope 通信，并接受部分重叠的 API key。请使用：

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