mirror of
https://github.com/openclaw/openclaw.git
synced 2026-07-10 19:26:12 +00:00
f7d7148cf0
Source-grounded rewrite of 529 published docs pages with per-unit information-loss verification: 1,713 factual corrections cited to src/**, generated surfaces regenerated, frontmatter titles preserved for i18n, release notes pages untouched. All docs gates green. Closes #100141
6.6 KiB
6.6 KiB
summary, title, read_when
| summary | title | read_when | ||
|---|---|---|---|---|
| Alibaba Model Studio Wan video generation in OpenClaw | Alibaba Model Studio |
|
The bundled alibaba plugin registers a video-generation provider for Wan models on Alibaba Model Studio (the international name for DashScope). It is enabled by default; only an API key is needed.
| Property | Value |
|---|---|
| Provider id | alibaba |
| Plugin | bundled, enabledByDefault: true |
| Auth env vars | MODELSTUDIO_API_KEY → DASHSCOPE_API_KEY → QWEN_API_KEY (first match wins) |
| Onboarding flag | --auth-choice alibaba-model-studio-api-key |
| Direct CLI flag | --alibaba-model-studio-api-key <key> |
| Default model | alibaba/wan2.6-t2v |
| Default base URL | https://dashscope-intl.aliyuncs.com |
Getting started
Store the key against the `alibaba` provider through onboarding:```bash
openclaw onboard --auth-choice alibaba-model-studio-api-key
```
Or pass the key directly:
```bash
openclaw onboard --alibaba-model-studio-api-key <your-key>
```
Or export one of the accepted env vars before starting the Gateway:
```bash
export MODELSTUDIO_API_KEY=sk-...
# or DASHSCOPE_API_KEY=...
# or QWEN_API_KEY=...
```
The list includes all five bundled Wan models. If `MODELSTUDIO_API_KEY` cannot be resolved, `openclaw models status --json` reports the missing credential under `auth.unusableProfiles`.
Built-in Wan models
| Model ref | Mode |
|---|---|
alibaba/wan2.6-t2v |
Text-to-video (default) |
alibaba/wan2.6-i2v |
Image-to-video |
alibaba/wan2.6-r2v |
Reference-to-video |
alibaba/wan2.6-r2v-flash |
Reference-to-video (fast) |
alibaba/wan2.7-r2v |
Reference-to-video |
Capabilities and limits
All three modes share the same per-request video count and duration cap; only the input shape differs.
| Mode | Max output videos | Max input images | Max input videos | Max duration | Supported controls |
|---|---|---|---|---|---|
| Text-to-video | 1 | n/a | n/a | 10 s | size, aspectRatio, resolution, audio, watermark |
| Image-to-video | 1 | 1 | n/a | 10 s | size, aspectRatio, resolution, audio, watermark |
| Reference-to-video | 1 | n/a | 4 | 10 s | size, aspectRatio, resolution, audio, watermark |
A request that omits durationSeconds gets DashScope's accepted default of 5 seconds. Set durationSeconds explicitly on the video generation tool to extend up to 10 s.
Advanced configuration
The provider defaults to the international DashScope endpoint. To target the China-region endpoint:```json5
{
models: {
providers: {
alibaba: {
baseUrl: "https://dashscope.aliyuncs.com",
},
},
},
}
```
The provider strips trailing slashes before constructing AIGC task URLs.
1. `MODELSTUDIO_API_KEY`
2. `DASHSCOPE_API_KEY`
3. `QWEN_API_KEY`
Configured `auth.profiles` entries (set via `openclaw models auth login`) override env-var resolution. See [Auth profiles in the models FAQ](/help/faq-models#auth-profiles-what-they-are-and-how-to-manage-them) for profile rotation, cooldown, and override mechanics.
- `alibaba/wan*.*` ids for the dedicated Wan video provider documented on this page.
- `qwen/*` ids for Qwen chat, embedding, and media understanding (see [Qwen](/providers/qwen)).
Setting `MODELSTUDIO_API_KEY` once authenticates both plugins, since the auth env var list intentionally overlaps; onboarding each plugin separately is not required.