Providers
Alibaba Model Studio
OpenClaw inclui um plugin alibaba integrado que registra um provedor de geração de vídeo para modelos Wan no Alibaba Model Studio (o nome internacional do DashScope). O plugin é habilitado por padrão; você só precisa definir uma chave de API.
| Propriedade | Valor |
|---|---|
| ID do provedor | alibaba |
| Plugin | integrado, enabledByDefault: true |
| Vars env de auth | MODELSTUDIO_API_KEY → DASHSCOPE_API_KEY → QWEN_API_KEY (a primeira correspondência vence) |
| Flag de onboarding | --auth-choice alibaba-model-studio-api-key |
| Flag direta da CLI | --alibaba-model-studio-api-key <key> |
| Modelo padrão | alibaba/wan2.6-t2v |
| URL base padrão | https://dashscope-intl.aliyuncs.com |
Primeiros passos
Defina uma chave de API
Use o onboarding para armazenar a chave no provedor alibaba:
openclaw onboard --auth-choice alibaba-model-studio-api-key
Ou passe a chave diretamente durante a instalação/onboarding:
openclaw onboard --alibaba-model-studio-api-key <your-key>
Ou exporte qualquer uma das vars env aceitas antes de iniciar o Gateway:
export MODELSTUDIO_API_KEY=sk-...
# or DASHSCOPE_API_KEY=...
# or QWEN_API_KEY=...
Defina um modelo de vídeo padrão
{
agents: {
defaults: {
videoGenerationModel: {
primary: "alibaba/wan2.6-t2v",
},
},
},
}
Verifique se o provedor está configurado
openclaw models list --provider alibaba
A lista deve incluir todos os cinco modelos Wan integrados. Se MODELSTUDIO_API_KEY não for resolvida, openclaw models status --json relata a credencial ausente em auth.unusableProfiles.
Modelos Wan integrados
| Ref. do modelo | Modo |
|---|---|
alibaba/wan2.6-t2v |
Texto para vídeo (padrão) |
alibaba/wan2.6-i2v |
Imagem para vídeo |
alibaba/wan2.6-r2v |
Referência para vídeo |
alibaba/wan2.6-r2v-flash |
Referência para vídeo (rápido) |
alibaba/wan2.7-r2v |
Referência para vídeo |
Capacidades e limites
O provedor integrado espelha os limites da API de vídeo Wan do DashScope. Todos os três modos compartilham a mesma contagem de vídeos por solicitação e o mesmo limite de duração; apenas o formato da entrada difere.
| Modo | Máx. vídeos de saída | Máx. imagens de entrada | Máx. vídeos de entrada | Duração máx. | Controles compatíveis |
|---|---|---|---|---|---|
| Texto para vídeo | 1 | n/a | n/a | 10 s | size, aspectRatio, resolution, audio, watermark |
| Imagem para vídeo | 1 | 1 | n/a | 10 s | size, aspectRatio, resolution, audio, watermark |
| Referência para vídeo | 1 | n/a | 4 | 10 s | size, aspectRatio, resolution, audio, watermark |
Quando uma solicitação omite durationSeconds, o provedor envia o padrão aceito pelo DashScope de 5 segundos. Defina durationSeconds explicitamente na ferramenta de geração de vídeo para estender até 10 s.
Configuração avançada
Substituir a URL base do DashScope
O provedor usa por padrão o endpoint internacional do DashScope. Para apontar para o endpoint da região da China, defina:
{
models: {
providers: {
alibaba: {
baseUrl: "https://dashscope.aliyuncs.com",
},
},
},
}
O provedor remove barras finais antes de construir URLs de tarefa AIGC.
Prioridade das vars env de auth
O OpenClaw resolve a chave de API da Alibaba a partir de variáveis de ambiente nesta ordem, usando o primeiro valor não vazio:
MODELSTUDIO_API_KEYDASHSCOPE_API_KEYQWEN_API_KEY
Entradas configuradas em auth.profiles (definidas via openclaw models auth login) substituem a resolução por vars env. Consulte Perfis de auth no FAQ de modelos para rotação de perfis, cooldown e mecânica de substituição.
Relação com o plugin Qwen
Ambos os plugins integrados se comunicam com o DashScope e aceitam chaves de API sobrepostas. Use:
- IDs
alibaba/wan*.*para acionar o provedor dedicado de vídeo Wan documentado nesta página. - IDs
qwen/*para chat, embedding e entendimento de mídia do Qwen (consulte Qwen).
Definir MODELSTUDIO_API_KEY uma vez autentica ambos os plugins porque a lista de vars env de auth se sobrepõe intencionalmente; você não precisa fazer onboarding de cada plugin separadamente.
Relacionados
Parâmetros compartilhados da ferramenta de vídeo e seleção de provedor.
Configuração de chat, embedding e entendimento de mídia do Qwen na mesma auth do DashScope.
Padrões do agente e configuração de modelos.
Perfis de auth, troca de modelos e resolução de erros "no profile".