提供商
阿里云百炼大模型服务平台
内置的 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 下报告缺失的凭据。
内置 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。
高级配置
覆盖 DashScope 基础 URL
提供商默认使用 DashScope 国际端点。要改用中国区域端点:
{ models: { providers: { alibaba: { baseUrl: "https://dashscope.aliyuncs.com", }, }, },}提供商会先移除末尾斜杠,再构造 AIGC 任务 URL。
身份验证环境变量优先级
OpenClaw 按以下顺序从环境变量解析 Alibaba API 密钥,并采用首个非空值:
MODELSTUDIO_API_KEYDASHSCOPE_API_KEYQWEN_API_KEY
已配置的 auth.profiles 条目(通过 openclaw models auth login 设置)会覆盖环境变量解析。有关配置文件轮换、冷却和覆盖机制,请参阅模型常见问题中的身份验证配置文件。
与 Qwen 插件的关系
两个内置插件都与 DashScope 通信,并接受部分相同的 API 密钥。请使用:
alibaba/wan*.*ID,用于本页所述的专用 Wan 视频提供商。qwen/*ID,用于 Qwen 聊天、嵌入和媒体理解(参阅 Qwen)。
由于身份验证环境变量列表有意重叠,只需设置一次 MODELSTUDIO_API_KEY 即可对两个插件进行身份验证;无需分别对每个插件执行新手引导。
相关内容
Was this useful?