Providers

Qwen

O OpenClaw agora trata o Qwen como um plugin de provedor de primeira classe com o id canônico qwen. O plugin de provedor tem como alvo os endpoints Qwen Cloud / Alibaba DashScope e Coding Plan, mantém ids legados modelstudio funcionando como um alias de compatibilidade e também expõe o fluxo de token do Qwen Portal como provedor qwen-oauth.

  • Provedor: qwen
  • Provedor do Portal: qwen-oauth
  • Variável de ambiente preferida: QWEN_API_KEY
  • Também aceitas para compatibilidade: MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
  • Estilo da API: compatível com OpenAI

Instalar plugin

Instale o plugin oficial e reinicie o Gateway:

bash
openclaw plugins install @openclaw/qwen-provideropenclaw gateway restart

Primeiros passos

Escolha o tipo de plano e siga as etapas de configuração.

Coding Plan (assinatura)

Melhor para: acesso baseado em assinatura pelo Qwen Coding Plan.

  • Obtenha sua chave de API

    Crie ou copie uma chave de API em home.qwencloud.com/api-keys.

  • Execute o onboarding

    Para o endpoint Global:

    bash
    openclaw onboard --auth-choice qwen-api-key

    Para o endpoint China:

    bash
    openclaw onboard --auth-choice qwen-api-key-cn
  • Defina um modelo padrão

    json5
    {  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}
  • Verifique se o modelo está disponível

    bash
    openclaw models list --provider qwen
  • Standard (pague conforme o uso)

    Melhor para: acesso pago conforme o uso pelo endpoint Standard Model Studio, incluindo modelos como qwen3.6-plus que podem não estar disponíveis no Coding Plan.

  • Obtenha sua chave de API

    Crie ou copie uma chave de API em home.qwencloud.com/api-keys.

  • Execute o onboarding

    Para o endpoint Global:

    bash
    openclaw onboard --auth-choice qwen-standard-api-key

    Para o endpoint China:

    bash
    openclaw onboard --auth-choice qwen-standard-api-key-cn
  • Defina um modelo padrão

    json5
    {  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}
  • Verifique se o modelo está disponível

    bash
    openclaw models list --provider qwen
  • Qwen OAuth / Portal

    Melhor para: um token do Qwen Portal contra https://portal.qwen.ai/v1.

    Consulte Qwen OAuth / Portal para a página dedicada do provedor e notas de migração.

  • Forneça seu token do portal

    bash
    openclaw onboard --auth-choice qwen-oauth
  • Defina um modelo padrão

    json5
    {  agents: {    defaults: {      model: { primary: "qwen-oauth/qwen3.5-plus" },    },  },}
  • Verifique se o modelo está disponível

    bash
    openclaw models list --provider qwen-oauth
  • Tipos de plano e endpoints

    Plano Região Escolha de autenticação Endpoint
    Standard (pague conforme o uso) China qwen-standard-api-key-cn dashscope.aliyuncs.com/compatible-mode/v1
    Standard (pague conforme o uso) Global qwen-standard-api-key dashscope-intl.aliyuncs.com/compatible-mode/v1
    Coding Plan (assinatura) China qwen-api-key-cn coding.dashscope.aliyuncs.com/v1
    Coding Plan (assinatura) Global qwen-api-key coding-intl.dashscope.aliyuncs.com/v1
    Qwen Portal Global qwen-oauth portal.qwen.ai/v1

    O provedor seleciona automaticamente o endpoint com base na sua escolha de autenticação. As escolhas canônicas usam a família qwen-*; modelstudio-* permanece apenas para compatibilidade. Você pode substituir isso com um baseUrl personalizado na configuração.

    Catálogo integrado

    Atualmente, o OpenClaw distribui este catálogo estático da Qwen. O catálogo configurado é ciente do endpoint: configurações do Coding Plan omitem modelos que só são conhecidos por funcionar no endpoint Standard.

    Ref. do modelo Entrada Contexto Observações
    qwen/qwen3.5-plus texto, imagem 1,000,000 Modelo padrão
    qwen/qwen3.6-plus texto, imagem 1,000,000 Prefira endpoints Standard quando precisar deste modelo
    qwen/qwen3-max-2026-01-23 texto 262,144 Linha Qwen Max
    qwen/qwen3-coder-next texto 262,144 Codificação
    qwen/qwen3-coder-plus texto 1,000,000 Codificação
    qwen/MiniMax-M2.5 texto 1,000,000 Raciocínio habilitado
    qwen/glm-5 texto 202,752 GLM
    qwen/glm-4.7 texto 202,752 GLM
    qwen/kimi-k2.5 texto, imagem 262,144 Moonshot AI via Alibaba
    qwen-oauth/qwen3.5-plus texto, imagem 1,000,000 Padrão do Qwen Portal

    Controles de raciocínio

    Para modelos Qwen Cloud com raciocínio habilitado, o provedor mapeia os níveis de raciocínio do OpenClaw para a flag de solicitação de nível superior enable_thinking do DashScope. O raciocínio desabilitado envia enable_thinking: false; outros níveis de raciocínio enviam enable_thinking: true.

    Complementos multimodais

    O Plugin qwen também expõe recursos multimodais nos endpoints DashScope Standard (não nos endpoints do Coding Plan):

    • Compreensão de vídeo via qwen-vl-max-latest
    • Geração de vídeo Wan via wan2.6-t2v (padrão), wan2.6-i2v, wan2.6-r2v, wan2.6-r2v-flash, wan2.7-r2v

    Para usar Qwen como provedor de vídeo padrão:

    json5
    {  agents: {    defaults: {      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },    },  },}

    Configuração avançada

    Compreensão de imagem e vídeo

    O Plugin Qwen registra compreensão de mídia para imagens e vídeo nos endpoints DashScope Standard (não nos endpoints do Coding Plan).

    Propriedade Valor
    Modelo qwen-vl-max-latest
    Entrada compatível Imagens, vídeo

    A compreensão de mídia é resolvida automaticamente a partir da autenticação Qwen configurada — nenhuma configuração adicional é necessária. Certifique-se de estar usando um endpoint Standard (pré-pago) para suporte à compreensão de mídia.

    Disponibilidade do Qwen 3.6 Plus

    qwen3.6-plus está disponível nos endpoints Model Studio Standard (pré-pagos):

    • China: dashscope.aliyuncs.com/compatible-mode/v1
    • Global: dashscope-intl.aliyuncs.com/compatible-mode/v1

    Se os endpoints do Coding Plan retornarem um erro de "modelo incompatível" para qwen3.6-plus, mude para Standard (pré-pago) em vez do par de endpoint/chave do Coding Plan.

    O catálogo estático Qwen do OpenClaw não anuncia qwen3.6-plus em endpoints do Coding Plan, mas entradas qwen/qwen3.6-plus configuradas explicitamente em models.providers.qwen.models são respeitadas em baseUrls do Coding Plan, para que você possa optar por esse modelo se a Aliyun o habilitar na sua assinatura. A API upstream ainda decide se a chamada terá sucesso.

    Plano de recursos

    O Plugin qwen está sendo posicionado como o lar do fornecedor para toda a superfície do Qwen Cloud, não apenas modelos de codificação/texto.

    • Modelos de texto/chat: disponíveis por meio do Plugin
    • Chamadas de ferramenta, saída estruturada, raciocínio: herdados do transporte compatível com OpenAI
    • Geração de imagem: planejada na camada de Plugin de provedor
    • Compreensão de imagem/vídeo: disponível por meio do Plugin no endpoint Standard
    • Fala/áudio: planejado na camada de Plugin de provedor
    • Embeddings/reclassificação de memória: planejados por meio da superfície do adaptador de embeddings
    • Geração de vídeo: disponível por meio do Plugin através do recurso compartilhado de geração de vídeo
    Detalhes da geração de vídeo

    Para geração de vídeo, o OpenClaw mapeia a região Qwen configurada para o host DashScope AIGC correspondente antes de enviar o trabalho:

    • Global/Intl: https://dashscope-intl.aliyuncs.com
    • China: https://dashscope.aliyuncs.com

    Isso significa que um models.providers.qwen.baseUrl normal apontando para os hosts Qwen do Coding Plan ou Standard ainda mantém a geração de vídeo no endpoint regional de vídeo DashScope correto.

    Limites atuais de geração de vídeo da Qwen:

    • Até 1 vídeo de saída por solicitação
    • Até 1 imagem de entrada
    • Até 4 vídeos de entrada
    • Até 10 segundos de duração
    • Compatível com size, aspectRatio, resolution, audio e watermark
    • O modo de imagem/vídeo de referência atualmente exige URLs http(s) remotas. Caminhos de arquivos locais são rejeitados antecipadamente porque o endpoint de vídeo DashScope não aceita buffers locais enviados para essas referências.
    Compatibilidade de uso em streaming

    Endpoints nativos do Model Studio anunciam compatibilidade de uso em streaming no transporte openai-completions compartilhado. Agora o OpenClaw determina isso com base nas capacidades do endpoint, portanto IDs de provedores personalizados compatíveis com DashScope que apontam para os mesmos hosts nativos herdam o mesmo comportamento de uso em streaming em vez de exigir especificamente o ID de provedor qwen integrado.

    A compatibilidade de uso com streaming nativo se aplica tanto aos hosts do Coding Plan quanto aos hosts Padrão compatíveis com DashScope:

    • https://coding.dashscope.aliyuncs.com/v1
    • https://coding-intl.dashscope.aliyuncs.com/v1
    • https://dashscope.aliyuncs.com/compatible-mode/v1
    • https://dashscope-intl.aliyuncs.com/compatible-mode/v1
    Regiões de endpoints multimodais

    Superfícies multimodais (compreensão de vídeo e geração de vídeo Wan) usam os endpoints DashScope Padrão, não os endpoints do Coding Plan:

    • URL base Padrão Global/Intl: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
    • URL base Padrão da China: https://dashscope.aliyuncs.com/compatible-mode/v1
    Configuração de ambiente e daemon

    Se o Gateway for executado como um daemon (launchd/systemd), garanta que QWEN_API_KEY esteja disponível para esse processo (por exemplo, em ~/.openclaw/.env ou via env.shellEnv).

    Relacionado

    Was this useful?
    On this page

    On this page