Alibaba Model Studio Provider

기준일: 2026-07-26
난이도: 중급
공식 기준: Alibaba Model Studio

개요

이 페이지는 OpenClaw Alibaba Model Studio provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.

공식 요약: Alibaba Model Studio Wan video generation in OpenClaw

model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.

빠른 참조

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

공식 문서 기반 상세

아래는 공식 providers/alibaba 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.

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

시작하기

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

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.

고급 설정

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](https://docs.openclaw.ai/help/faq-models#auth-profiles-what-they-are-and-how-to-manage-them) 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](https://docs.openclaw.ai/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.

관련 문서

Shared video tool parameters and provider selection.


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


Agent defaults and model configuration.


Auth profiles, switching models, and resolving "no profile" errors.

검증 체크리스트

• openclaw models list --provider alibaba 로 모델이 보이는지 확인
• 기본 model alias를 agents.defaults.model.primary에 설정했는지 확인
• API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
• failover 시 데이터가 다른 provider로 이동할 수 있는지 검토

관련

• Provider 목록 인덱스
• 로컬 모델과 Provider
• 공식: Provider directory, Model providers