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

O plugin alibaba incluído registra um provedor de geração de vídeo para modelos Wan no Alibaba Model Studio (o nome internacional do DashScope). Ele é habilitado por padrão; somente uma chave de API é necessária.

Propriedade Valor
ID do provedor alibaba
Plugin incluído, enabledByDefault: true
Variáveis de ambiente de autenticação MODELSTUDIO_API_KEY → DASHSCOPE_API_KEY → QWEN_API_KEY (a primeira correspondência prevalece)
Flag de integração inicial --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

  • Set an API key

    Armazene a chave para o provedor alibaba por meio da integração inicial:

    bash
    openclaw onboard --auth-choice alibaba-model-studio-api-key

    Ou forneça a chave diretamente:

    bash
    openclaw onboard --alibaba-model-studio-api-key <your-key>

    Ou exporte uma das variáveis de ambiente aceitas antes de iniciar o 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

    A lista inclui todos os cinco modelos Wan incluídos. Se não for possível resolver MODELSTUDIO_API_KEY, openclaw models status --json relata a credencial ausente em auth.unusableProfiles.

    • Modelos Wan integrados

    Referência 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

    Recursos e limites

    Todos os três modos compartilham o mesmo limite de quantidade e duração de vídeos por solicitação; somente o formato da entrada é diferente.

    Modo Máx. de vídeos de saída Máx. de imagens de entrada Máx. de vídeos de entrada Duração máxima Controles compatíveis
    Texto para vídeo 1 não aplicável não aplicável 10 s size, aspectRatio, resolution, audio, watermark
    Imagem para vídeo 1 1 não aplicável 10 s size, aspectRatio, resolution, audio, watermark
    Referência para vídeo 1 não aplicável 4 10 s size, aspectRatio, resolution, audio, watermark

    Uma solicitação que omite durationSeconds recebe o padrão aceito pelo DashScope de 5 segundos. Defina durationSeconds explicitamente na ferramenta de geração de vídeo para estender a duração até 10 s.

    Configuração avançada

    Override the DashScope base URL

    O provedor usa por padrão o endpoint internacional do DashScope. Para usar o endpoint da região da China:

    json5
    {  models: {    providers: {      alibaba: {        baseUrl: "https://dashscope.aliyuncs.com",      },    },  },}

    O provedor remove as barras finais antes de construir as URLs de tarefas AIGC.

    Auth env priority

    O OpenClaw resolve a chave de API do Alibaba a partir das 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

    As entradas configuradas em auth.profiles (definidas por meio de openclaw models auth login) têm precedência sobre a resolução por variáveis de ambiente. Consulte Perfis de autenticação nas perguntas frequentes sobre modelos para saber mais sobre rotação de perfis, período de espera e mecanismos de substituição.

    Relationship to the Qwen plugin

    Ambos os plugins incluídos se comunicam com o DashScope e aceitam chaves de API sobrepostas. Use:

    • IDs alibaba/wan*.* para o provedor dedicado de vídeo Wan documentado nesta página.
    • IDs qwen/* para chat, embeddings e compreensão de mídia do Qwen (consulte Qwen).

    Definir MODELSTUDIO_API_KEY uma vez autentica ambos os plugins, pois a lista de variáveis de ambiente de autenticação se sobrepõe intencionalmente; não é necessário realizar a integração inicial de cada plugin separadamente.

    Relacionados

    Video generation

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

    Configuração de chat, embeddings e compreensão de mídia do Qwen com a mesma autenticação do DashScope.
    Configuration reference

    Padrões dos agentes e configuração de modelos.
    Models FAQ

    Perfis de autenticação, troca de modelos e resolução de erros de "nenhum perfil".
    Was this useful?
    On this page

    On this page