Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.
PropriedadeValor
ID do provedoralibaba
Pluginintegrado, enabledByDefault: true
Vars env de authMODELSTUDIO_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ãoalibaba/wan2.6-t2v
URL base padrãohttps://dashscope-intl.aliyuncs.com

​
Primeiros passos

1

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

Defina um modelo de vídeo padrão

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

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.
O plugin Alibaba e o plugin Qwen autenticam ambos no DashScope e aceitam vars env sobrepostas. Use IDs de modelo alibaba/... para acionar a superfície dedicada de vídeo Wan; use IDs qwen/... quando quiser a superfície de chat, embedding ou entendimento de mídia do Qwen.

​
Modelos Wan integrados

Ref. do modeloModo
alibaba/wan2.6-t2vTexto para vídeo (padrão)
alibaba/wan2.6-i2vImagem para vídeo
alibaba/wan2.6-r2vReferência para vídeo
alibaba/wan2.6-r2v-flashReferência para vídeo (rápido)
alibaba/wan2.7-r2vReferê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.
ModoMáx. vídeos de saídaMáx. imagens de entradaMáx. vídeos de entradaDuração máx.Controles compatíveis
Texto para vídeo1n/an/a10 ssize, aspectRatio, resolution, audio, watermark
Imagem para vídeo11n/a10 ssize, aspectRatio, resolution, audio, watermark
Referência para vídeo1n/a410 ssize, 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.
Entradas de imagem e vídeo de referência devem ser URLs http(s) remotas. Caminhos de arquivos locais não são aceitos pelos modos de referência do DashScope; faça upload para um armazenamento de objetos primeiro ou use o fluxo da ferramenta de mídia, que já produz uma URL pública.

​
Configuração avançada

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.
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:
  1. MODELSTUDIO_API_KEY
  2. DASHSCOPE_API_KEY
  3. QWEN_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.
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

Geração de vídeo

Parâmetros compartilhados da ferramenta de vídeo e seleção de provedor.

Qwen

Configuração de chat, embedding e entendimento de mídia do Qwen na mesma auth do DashScope.

Referência de configuração

Padrões do agente e configuração de modelos.

FAQ de modelos

Perfis de auth, troca de modelos e resolução de erros “no profile”.