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:

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

Or pass the key directly:

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

Or export one of the accepted env vars before starting the Gateway:

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

Set a default video model

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

Verify the provider is configured

openclaw models list --provider alibaba

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.

The Alibaba plugin and the Qwen plugin both authenticate against DashScope and accept overlapping env vars. Use alibaba/... model ids for the dedicated Wan video surface; use qwen/... ids for Qwen chat, embedding, or media-understanding.

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.

Reference image and video inputs must be remote http(s) URLs; DashScope’s reference modes reject local file paths. Upload to object storage first, or use the media tool flow that already produces a public URL.

Advanced configuration

Override the DashScope base URL

The provider defaults to the international DashScope endpoint. To target the China-region endpoint:

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

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_KEY
DASHSCOPE_API_KEY
QWEN_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.

Video generation

Shared video tool parameters and provider selection.

Qwen

Qwen chat, embedding, and media-understanding setup on the same DashScope auth.

Configuration reference

Agent defaults and model configuration.

Models FAQ

Auth profiles, switching models, and resolving “no profile” errors.

Overview

Concepts and configuration

Providers

Alibaba Model Studio

Getting started

Built-in Wan models

Capabilities and limits

Advanced configuration

Video generation

Qwen

Configuration reference

Models FAQ

​Getting started

​Built-in Wan models

​Capabilities and limits

​Advanced configuration

​Related

Video generation

Qwen

Configuration reference

Models FAQ

Getting started

Built-in Wan models

Capabilities and limits

Advanced configuration

Related