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:
openclaw plugins install @openclaw/qwen-provideropenclaw gateway restartPrimeiros 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:
openclaw onboard --auth-choice qwen-api-keyPara o endpoint China:
openclaw onboard --auth-choice qwen-api-key-cnDefina um modelo padrão
{ agents: { defaults: { model: { primary: "qwen/qwen3.5-plus" }, }, },}Verifique se o modelo está disponível
openclaw models list --provider qwenStandard (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:
openclaw onboard --auth-choice qwen-standard-api-keyPara o endpoint China:
openclaw onboard --auth-choice qwen-standard-api-key-cnDefina um modelo padrão
{ agents: { defaults: { model: { primary: "qwen/qwen3.5-plus" }, }, },}Verifique se o modelo está disponível
openclaw models list --provider qwenQwen 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
openclaw onboard --auth-choice qwen-oauthDefina um modelo padrão
{ agents: { defaults: { model: { primary: "qwen-oauth/qwen3.5-plus" }, }, },}Verifique se o modelo está disponível
openclaw models list --provider qwen-oauthTipos 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:
{ 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,audioewatermark - 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/v1https://coding-intl.dashscope.aliyuncs.com/v1https://dashscope.aliyuncs.com/compatible-mode/v1https://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
Escolha de provedores, referências de modelo e comportamento de failover.
Parâmetros compartilhados da ferramenta de vídeo e seleção de provedor.
Provedor ModelStudio legado e notas de migração.
Solução de problemas geral e perguntas frequentes.