Providers
Qwen
Qwen Cloud é um plugin oficial externo de provedor do OpenClaw com o id canônico qwen. Ele é destinado aos endpoints Standard e Coding Plan do Qwen Cloud / Alibaba DashScope, expõe o Token Plan como qwen-token-plan, mantém modelstudio como um alias de compatibilidade, gerencia de forma independente o id de provedor personalizado bailian-token-plan documentado pela Alibaba e expõe o fluxo de token do Qwen Portal como qwen-oauth.
| Propriedade | Valor |
|---|---|
| Provedor | qwen |
| Provedor do Token Plan | qwen-token-plan |
| Provedor do Portal | qwen-oauth |
| Variável de ambiente preferencial | QWEN_API_KEY |
| Variável de ambiente do Token Plan | QWEN_TOKEN_PLAN_API_KEY |
| Também aceitas (compatibilidade) | MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY |
| Estilo da API | Compatível com OpenAI |
Instalar o plugin
O qwen é distribuído como um plugin oficial externo, não incluído no núcleo. Instale-o 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)
Mais indicado para: acesso por 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 a integração inicial
Para o endpoint Global:
openclaw onboard --auth-choice qwen-api-keyPara o endpoint da 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 (pagamento conforme o uso)
Mais indicado para: acesso com pagamento conforme o uso por meio do endpoint Standard do Model Studio, incluindo qwen3.7-max e qwen3.6-flash, que não estão disponíveis no Coding Plan.
Obtenha sua chave de API
Crie ou copie uma chave de API em home.qwencloud.com/api-keys.
Execute a integração inicial
Para o endpoint Global:
openclaw onboard --auth-choice qwen-standard-api-keyPara o endpoint da 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 qwenToken Plan (Edição para equipes)
Mais indicado para: acesso por assinatura de equipe baseado em créditos ao Qwen e a modelos de terceiros compatíveis por meio do Alibaba Cloud Model Studio.
Obtenha sua chave exclusiva
Atribua uma licença do Token Plan e crie a chave exclusiva sk-sp-... correspondente. As chaves do Token Plan, do Coding Plan e de pagamento conforme o uso não são intercambiáveis. Consulte a visão geral global do Token Plan ou a visão geral do Token Plan na China.
Execute a integração inicial
Para o endpoint Global / Internacional em Singapura:
openclaw onboard --auth-choice qwen-token-planPara o endpoint da China em Pequim:
openclaw onboard --auth-choice qwen-token-plan-cnVerifique o provedor
openclaw models list --provider qwen-token-planopenclaw agent --model qwen-token-plan/qwen3.7-plus --message "Reply with: token plan ready"Qwen OAuth / Portal
Mais indicado para: um token do Qwen Portal para https://portal.qwen.ai/v1.
Consulte Qwen OAuth / Portal para acessar a página dedicada do provedor e as observações sobre 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 | Opção de autenticação | Endpoint |
|---|---|---|---|
| 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 |
| Standard (pagamento conforme o uso) | China | qwen-standard-api-key-cn |
dashscope.aliyuncs.com/compatible-mode/v1 |
| Standard (pagamento conforme o uso) | Global | qwen-standard-api-key |
dashscope-intl.aliyuncs.com/compatible-mode/v1 |
| Token Plan (Edição para equipes) | China | qwen-token-plan-cn |
token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 |
| Token Plan (Edição para equipes) | Global | qwen-token-plan |
token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 |
O provedor seleciona automaticamente o endpoint com base na opção de autenticação. As opções
canônicas usam a família qwen-*; modelstudio-* permanece apenas para compatibilidade.
Substitua essa seleção com um baseUrl personalizado na configuração.
Catálogo integrado
O OpenClaw distribui este catálogo estático do Qwen. O catálogo considera o endpoint: as configurações do Coding Plan omitem modelos que funcionam somente no endpoint Standard.
| Referência do modelo | Entrada | Contexto | Observações |
|---|---|---|---|
qwen/qwen3.5-plus |
texto, imagem | 1,000,000 | Modelo padrão |
qwen/qwen3.6-flash |
texto, imagem | 1,000,000 | Somente endpoints Standard |
qwen/qwen3.6-plus |
texto, imagem | 1,000,000 | Coding Plan + Standard |
qwen/qwen3.7-max |
texto | 1,000,000 | Somente endpoints Standard |
qwen/qwen3.7-plus |
texto, imagem | 1,000,000 | Coding Plan + Standard |
qwen/qwen3-max-2026-01-23 |
texto | 262,144 | Linha Qwen Max |
qwen/qwen3-coder-next |
texto | 262,144 | Programação |
qwen/qwen3-coder-plus |
texto | 1,000,000 | Programaçã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 por meio da Alibaba |
qwen-oauth/qwen3.5-plus |
texto, imagem | 1,000,000 | Padrão do Qwen Portal |
Catálogo do Token Plan
O Token Plan usa uma lista de permissões separada com correspondência exata de strings. Os modelos do plano exclusivos para geração de imagens não estão incluídos aqui porque usam APIs diferentes.
| Referência do modelo | Entrada | Contexto |
|---|---|---|
qwen-token-plan/qwen3.7-max |
texto | 1,000,000 |
qwen-token-plan/qwen3.7-plus |
texto, imagem | 1,000,000 |
qwen-token-plan/qwen3.6-plus |
texto, imagem | 1,000,000 |
qwen-token-plan/qwen3.6-flash |
texto, imagem | 1,000,000 |
qwen-token-plan/deepseek-v4-pro |
texto | 1,000,000 |
qwen-token-plan/deepseek-v4-flash |
texto | 1,000,000 |
qwen-token-plan/deepseek-v3.2 |
texto | 131,072 |
qwen-token-plan/kimi-k2.7-code |
texto, imagem | 262,144 |
qwen-token-plan/kimi-k2.6 |
texto, imagem | 262,144 |
qwen-token-plan/kimi-k2.5 |
texto, imagem | 262,144 |
qwen-token-plan/glm-5.2 |
texto | 1,000,000 |
qwen-token-plan/glm-5.1 |
texto | 202,752 |
qwen-token-plan/glm-5 |
texto | 202,752 |
qwen-token-plan/MiniMax-M2.5 |
texto | 196,608 |
Controles de raciocínio
qwen3.7-max, qwen3.7-plus, qwen3.6-flash e qwen3.6-plus têm
raciocínio habilitado no catálogo integrado. Para modelos de raciocínio da família
qwen, o provedor mapeia os níveis de pensamento do OpenClaw para o sinalizador
de solicitação de nível superior enable_thinking do DashScope: o pensamento
desabilitado envia enable_thinking: false; qualquer outro nível envia
enable_thinking: true. Modelos personalizados podem optar por uma carga de
pensamento alternativa no modelo de chat definindo
compat.thinkingFormat: "qwen-chat-template" na entrada do modelo.
Os modelos do Token Plan também são marcados como compatíveis com raciocínio.
kimi-k2.7-code e MiniMax-M2.5 funcionam somente com pensamento, portanto o
OpenClaw mantém o pensamento habilitado mesmo quando a sessão solicita
/think off. O DeepSeek V4 mapeia de minimal a high para o esforço high
do serviço e mapeia xhigh ou max para max. O GLM 5.2 aceita todo o
intervalo de minimal a max; o GLM 5.1 e o GLM 5 aceitam até xhigh, e os
três usam high como padrão. Outros modelos híbridos seguem o estado
ligado/desligado solicitado.
Complementos multimodais
O Plugin qwen disponibiliza recursos multimodais somente nos endpoints
Standard do DashScope, não nos endpoints do Coding Plan:
- Compreensão de imagens e vídeos por meio do
qwen-vl-max-latest - Geração de vídeos Wan por meio do
wan2.6-t2v(padrão),wan2.6-i2v,wan2.6-r2v,wan2.6-r2v-flash,wan2.7-r2v
A compreensão de mídia é resolvida automaticamente com base na autenticação Qwen configurada; nenhuma configuração adicional é necessária. Certifique-se de usar um endpoint Standard (pagamento conforme o uso) para que a compreensão de mídia funcione.
Para tornar o Qwen o provedor de vídeo padrão:
{ agents: { defaults: { videoGenerationModel: { primary: "qwen/wan2.6-t2v" }, }, },}Limites de geração de vídeo: 1 vídeo de saída por solicitação, até 1 imagem de
entrada (imagem para vídeo), até 4 vídeos de entrada (vídeo para vídeo) e
duração máxima de 10 segundos. Compatível com size, aspectRatio,
resolution, audio e watermark. Entradas de imagem/vídeo de referência
exigem URLs http(s) remotas; caminhos de arquivos locais são rejeitados
antecipadamente porque o endpoint de vídeo do DashScope não aceita buffers
locais enviados para essas referências.
Configuração avançada
Disponibilidade do Qwen 3.6 e 3.7
qwen3.7-plus e qwen3.6-plus estão disponíveis nos endpoints Coding Plan e Standard. qwen3.7-max e qwen3.6-flash estão disponíveis somente no Standard. Os endpoints Standard (pagamento conforme o uso) são:
- China:
dashscope.aliyuncs.com/compatible-mode/v1 - Global:
dashscope-intl.aliyuncs.com/compatible-mode/v1
O OpenClaw omite qwen3.7-max e qwen3.6-flash dos catálogos do Coding Plan.
Se um endpoint do Coding Plan retornar um erro de "modelo não compatível" para qualquer um deles,
mude para o endpoint Standard correspondente e sua respectiva chave.
Roteamento regional da geração de vídeo
O OpenClaw mapeia a região Qwen configurada para o host AIGC correspondente do DashScope antes de enviar uma tarefa de vídeo:
- Global/Internacional:
https://dashscope-intl.aliyuncs.com - China:
https://dashscope.aliyuncs.com
Um models.providers.qwen.baseUrl normal que aponte para hosts Qwen do
Coding Plan ou Standard ainda encaminha a geração de vídeo para o endpoint
de vídeo regional correspondente do DashScope.
Compatibilidade do uso com streaming
Os endpoints nativos do Qwen anunciam compatibilidade do uso com streaming
no transporte compartilhado openai-completions. Assim, IDs de provedores
personalizados compatíveis com o DashScope que apontem para os mesmos hosts
nativos herdam o mesmo comportamento sem exigir especificamente o ID de
provedor integrado qwen. Isso se aplica aos endpoints Coding Plan,
Standard e Token Plan:
https://coding.dashscope.aliyuncs.com/v1https://coding-intl.dashscope.aliyuncs.com/v1https://dashscope.aliyuncs.com/compatible-mode/v1https://dashscope-intl.aliyuncs.com/compatible-mode/v1https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
Plano de recursos
O Plugin qwen está sendo posicionado como a solução do fornecedor para
toda a plataforma Qwen Cloud, não apenas para modelos de programação/texto.
- Modelos de texto/chat: disponíveis por meio do Plugin
- Chamadas de ferramentas, saída estruturada e pensamento: herdados do transporte compatível com OpenAI
- Geração de imagens: planejada na camada de Plugin do provedor
- Compreensão de imagens/vídeos: disponível por meio do Plugin no endpoint Standard
- Fala/áudio: planejados na camada de Plugin do provedor
- Embeddings/reordenação de memória: planejados por meio da interface do adaptador de embeddings
- Geração de vídeos: disponível por meio do Plugin usando o recurso compartilhado de geração de vídeos
Configuração do ambiente e do daemon
Se o Gateway for executado como um daemon (launchd/systemd), certifique-se
de que QWEN_API_KEY ou QWEN_TOKEN_PLAN_API_KEY esteja disponível para
esse processo (por exemplo, em ~/.openclaw/.env ou por meio de
env.shellEnv).
Relacionados
Escolha de provedores, referências de modelos e comportamento de failover.
Parâmetros compartilhados da ferramenta de vídeo e seleção de provedor.
Provedor integrado de geração de vídeos Wan na mesma plataforma DashScope.
Solução geral de problemas e perguntas frequentes.