OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about 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:

    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=...

  • Set a default video model

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

  • Verify the provider is configured

    bash
    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.

    • 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

    Override the DashScope base URL

    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.

    Auth env priority

    OpenClaw resolves the Alibaba API key from environment variables in this order, taking the first non-empty value:

    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 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.
    Was this useful?
    On this page

    On this page