Qwen

O OAuth do Qwen foi removido. A integração OAuth do nível gratuito (qwen-portal) que usava endpoints portal.qwen.ai não está mais disponível. Veja a Issue #49557 para contexto.

O OpenClaw agora trata o Qwen como um provedor empacotado de primeira classe com id canônico qwen. O provedor empacotado tem como alvo os endpoints Qwen Cloud / Alibaba DashScope e Coding Plan e mantém os ids legados modelstudio funcionando como um alias de compatibilidade.

Provedor: qwen
Variável de env preferida: QWEN_API_KEY
Também aceitas por compatibilidade: MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
Estilo de API: compatível com OpenAI

Se você quiser qwen3.6-plus, prefira o endpoint Standard (pay-as-you-go). O suporte do Coding Plan pode demorar a acompanhar o catálogo público.

Introdução

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

Coding Plan (assinatura)
Standard (pay-as-you-go)

Ideal para: acesso baseado em assinatura por meio do 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:

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

Para o endpoint China:

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

Defina um modelo padrão

{
  agents: {
    defaults: {
      model: { primary: "qwen/qwen3.5-plus" },
    },
  },
}

Verifique se o modelo está disponível

openclaw models list --provider qwen

Os ids legados modelstudio-* de auth-choice e refs de modelo modelstudio/... ainda funcionam como aliases de compatibilidade, mas novos fluxos de configuração devem preferir os ids canônicos qwen-* de auth-choice e refs de modelo qwen/....

Ideal para: acesso pay-as-you-go 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:

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

Para o endpoint China:

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

Defina um modelo padrão

{
  agents: {
    defaults: {
      model: { primary: "qwen/qwen3.5-plus" },
    },
  },
}

Verifique se o modelo está disponível

openclaw models list --provider qwen

Tipos de plano e endpoints

Plan	Region	Auth choice	Endpoint
Standard (pay-as-you-go)	China	`qwen-standard-api-key-cn`	`dashscope.aliyuncs.com/compatible-mode/v1`
Standard (pay-as-you-go)	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`

O provedor seleciona automaticamente o endpoint com base no seu auth choice. As opções canônicas usam a família qwen-*; modelstudio-* permanece apenas para compatibilidade. Você pode substituir com um baseUrl personalizado na config.

Gerenciar chaves: home.qwencloud.com/api-keys | Docs: docs.qwencloud.com

Catálogo integrado

Atualmente, o OpenClaw inclui este catálogo Qwen empacotado. O catálogo configurado é sensível ao endpoint: configs de Coding Plan omitem modelos que só se sabe funcionarem no endpoint Standard.

Model ref	Input	Context	Notes
`qwen/qwen3.5-plus`	text, image	1,000,000	Modelo padrão
`qwen/qwen3.6-plus`	text, image	1,000,000	Prefira endpoints Standard quando precisar deste modelo
`qwen/qwen3-max-2026-01-23`	text	262,144	Linha Qwen Max
`qwen/qwen3-coder-next`	text	262,144	Coding
`qwen/qwen3-coder-plus`	text	1,000,000	Coding
`qwen/MiniMax-M2.5`	text	1,000,000	reasoning habilitado
`qwen/glm-5`	text	202,752	GLM
`qwen/glm-4.7`	text	202,752	GLM
`qwen/kimi-k2.5`	text, image	262,144	Moonshot AI via Alibaba

A disponibilidade ainda pode variar por endpoint e plano de cobrança, mesmo quando um modelo está presente no catálogo empacotado.

Complementos multimodais

A extensão qwen também expõe capacidades multimodais nos endpoints DashScope Standard (não nos endpoints Coding Plan):

Entendimento 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:

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

Veja Video Generation para parâmetros compartilhados da ferramenta, seleção de provedor e comportamento de failover.

Avançado

Entendimento de imagem e vídeo

O plugin Qwen empacotado registra media understanding para imagens e vídeo nos endpoints DashScope Standard (não nos endpoints Coding Plan).

Property	Value
Modelo	`qwen-vl-max-latest`
Entrada compatível	Imagens, vídeo

O media understanding é resolvido automaticamente a partir da auth Qwen configurada — nenhuma config adicional é necessária. Certifique-se de estar usando um endpoint Standard (pay-as-you-go) para suporte a media understanding.

Disponibilidade do Qwen 3.6 Plus

qwen3.6-plus está disponível nos endpoints Standard (pay-as-you-go) do Model Studio:

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 “unsupported model” para qwen3.6-plus, mude para Standard (pay-as-you-go) em vez do par endpoint/chave do Coding Plan.

Plano de capacidades

A extensão qwen está sendo posicionada como a casa do fornecedor para toda a superfície do Qwen Cloud, não apenas modelos de coding/texto.

Modelos de texto/chat: empacotados agora
Chamada de ferramentas, saída estruturada, thinking: herdados do transporte compatível com OpenAI
Geração de imagem: planejada na camada de plugin de provedor
Entendimento de imagem/vídeo: empacotado agora no endpoint Standard
Fala/áudio: planejados na camada de plugin de provedor
Embeddings/reranking de memória: planejados por meio da superfície do adaptador de embeddings
Geração de vídeo: empacotada agora por meio da capacidade compartilhada 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 job:

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

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

Até 1 vídeo de saída por requisição
Até 1 imagem de entrada
Até 4 vídeos de entrada
Até 10 segundos de duração
Oferece suporte a size, aspectRatio, resolution, audio e watermark
O modo de imagem/vídeo de referência atualmente exige URLs remotas http(s). Caminhos de arquivo locais são rejeitados antecipadamente porque o endpoint de vídeo do DashScope não aceita buffers locais enviados para essas referências.

Compatibilidade de uso em streaming

Os endpoints nativos do Model Studio anunciam compatibilidade de uso em streaming no transporte compartilhado openai-completions. O OpenClaw agora baseia isso nas capacidades do endpoint, então ids personalizados de provedores compatíveis com DashScope que apontam para os mesmos hosts nativos herdam o mesmo comportamento de uso em streaming em vez de exigirem especificamente o id integrado de provedor qwen.A compatibilidade de uso em streaming nativo se aplica tanto aos hosts do Coding Plan quanto aos hosts compatíveis com DashScope Standard:

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 endpoint multimodal

As superfícies multimodais (entendimento de vídeo e geração de vídeo Wan) usam os endpoints DashScope Standard, não os endpoints Coding Plan:

URL base Standard Global/Intl: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
URL base Standard China: https://dashscope.aliyuncs.com/compatible-mode/v1

Configuração de ambiente e daemon

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

Relacionado

Seleção de modelo

Escolhendo provedores, refs de modelo e comportamento de failover.

Geração de vídeo

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

Alibaba (ModelStudio)

Provedor legado ModelStudio e observações de migração.

Solução de problemas

Solução de problemas geral e FAQ.

Overview

Concepts and configuration

Providers

Qwen

Qwen

Introdução

Tipos de plano e endpoints

Catálogo integrado

Complementos multimodais

Avançado

Relacionado

Seleção de modelo

Geração de vídeo

Alibaba (ModelStudio)

Solução de problemas

Overview

Concepts and configuration

Providers

​Qwen

​Introdução

​Tipos de plano e endpoints

​Catálogo integrado

​Complementos multimodais

​Avançado

​Relacionado

Seleção de modelo

Geração de vídeo

Alibaba (ModelStudio)

Solução de problemas

Qwen

Introdução

Tipos de plano e endpoints

Catálogo integrado

Complementos multimodais

Avançado

Relacionado