On this page
On this page
Providers
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
Set an API key
Store the key against the alibaba provider through onboarding:
Or pass the key directly:
Or export one of the accepted env vars before starting the Gateway:
Set a default video model
Verify the provider is configured
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
With exactly one reference image and no video, wan2.6-t2v automatically
uses wan2.6-i2v; the result reports the resolved model. This routing applies
only when a same-generation image-to-video sibling exists in the known model
catalog. Other requests use the selected model's mode. Geometry follows the
vendor protocol for that model family.
| Mode | Max output videos | Reference limits | Max duration | Supported controls |
|---|---|---|---|---|
| Text-to-video | 1 | n/a | 15 s | size, aspectRatio, resolution, audio, watermark |
| Image-to-video | 1 | 1 image | 15 s | resolution, audio, watermark |
| Reference-to-video (Wan 2.6) | 1 | 5 total images/videos; up to 3 videos | 10 s | size, aspectRatio, resolution, audio, watermark |
| Reference-to-video (Wan 2.7) | 1 | 5 total images/videos; up to 3 videos | 10 s | size, aspectRatio, resolution, watermark; audio is always on |
Wan 2.6 text/reference models translate resolution plus aspectRatio to the
documented exact size. Wan 2.6 image-to-video sends the resolution tier and
uses the input image's aspect ratio. Wan 2.7 reference-to-video sends the newer
media, resolution, and ratio fields and always generates audio.
A request that omits durationSeconds gets DashScope's accepted default of 5 seconds.
Image-to-video and Wan 2.7 reference images accept local files or remote
http(s) URLs. OpenClaw sends local images as base64 data URIs, with a maximum
of 20 MB per image before encoding. See the Model Studio references for
image-to-video
and Wan 2.7 reference-to-video.
Reference videos and Wan 2.6 reference-to-video images still require remote
http(s) URLs.
Advanced configuration
Override the DashScope base URL
The provider defaults to the international DashScope endpoint. To target the China-region endpoint:
The provider strips trailing slashes before constructing AIGC task URLs.
Auth env priority
OpenClaw resolves the Alibaba API key from environment variables in this order, taking the first non-empty value:
MODELSTUDIO_API_KEYDASHSCOPE_API_KEYQWEN_API_KEY
Configured auth.profiles entries (set via openclaw models auth login) override env-var resolution. See Auth profiles in the models FAQ for profile rotation, cooldown, and override mechanics.
Relationship to the Qwen plugin
Both bundled plugins talk to DashScope and accept overlapping API keys. Use:
alibaba/wan*.*ids for the dedicated Wan video provider documented on this page.qwen/*ids for Qwen chat, embedding, and media understanding (see Qwen).
Setting MODELSTUDIO_API_KEY once authenticates both plugins, since the auth env var list intentionally overlaps; onboarding each plugin separately is not required.
