mirror of
https://github.com/openclaw/openclaw.git
synced 2026-07-15 07:36:10 +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
159 lines
6.6 KiB
Markdown
159 lines
6.6 KiB
Markdown
---
|
|
summary: "Alibaba Model Studio Wan video generation in OpenClaw"
|
|
title: "Alibaba Model Studio"
|
|
read_when:
|
|
- You want to use Alibaba Wan video generation in OpenClaw
|
|
- You need Model Studio or DashScope API key setup for video generation
|
|
---
|
|
|
|
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
|
|
|
|
<Steps>
|
|
<Step title="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=...
|
|
```
|
|
|
|
</Step>
|
|
<Step title="Set a default video model">
|
|
```json5
|
|
{
|
|
agents: {
|
|
defaults: {
|
|
videoGenerationModel: {
|
|
primary: "alibaba/wan2.6-t2v",
|
|
},
|
|
},
|
|
},
|
|
}
|
|
```
|
|
</Step>
|
|
<Step title="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`.
|
|
|
|
</Step>
|
|
</Steps>
|
|
|
|
<Note>
|
|
The Alibaba plugin and the [Qwen plugin](/providers/qwen) 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.
|
|
</Note>
|
|
|
|
## 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](/tools/video-generation) to extend up to 10 s.
|
|
|
|
<Warning>
|
|
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](/tools/media-overview) flow that already produces a public URL.
|
|
</Warning>
|
|
|
|
## Advanced configuration
|
|
|
|
<AccordionGroup>
|
|
<Accordion title="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.
|
|
|
|
</Accordion>
|
|
|
|
<Accordion title="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](/help/faq-models#auth-profiles-what-they-are-and-how-to-manage-them) for profile rotation, cooldown, and override mechanics.
|
|
|
|
</Accordion>
|
|
|
|
<Accordion title="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](/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.
|
|
|
|
</Accordion>
|
|
</AccordionGroup>
|
|
|
|
## Related
|
|
|
|
<CardGroup cols={2}>
|
|
<Card title="Video generation" href="/tools/video-generation" icon="video">
|
|
Shared video tool parameters and provider selection.
|
|
</Card>
|
|
<Card title="Qwen" href="/providers/qwen" icon="microchip">
|
|
Qwen chat, embedding, and media-understanding setup on the same DashScope auth.
|
|
</Card>
|
|
<Card title="Configuration reference" href="/gateway/config-agents#agent-defaults" icon="gear">
|
|
Agent defaults and model configuration.
|
|
</Card>
|
|
<Card title="Models FAQ" href="/help/faq-models" icon="circle-question">
|
|
Auth profiles, switching models, and resolving "no profile" errors.
|
|
</Card>
|
|
</CardGroup>
|