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

qwen3.7-plus e qwen3.6-plus funcionam com os endpoints Coding Plan e Standard. Para qwen3.7-max ou qwen3.6-flash, use um endpoint Standard (pagamento conforme o uso).

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-provider
openclaw gateway restart

Primeiros passos

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

Coding Plan (assinatura)
Standard (pagamento conforme o uso)
Token Plan (Edição para equipes)
Qwen OAuth / Portal

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-key

Para o endpoint da 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 de opção de autenticação modelstudio-* e as referências de modelo modelstudio/... ainda funcionam como aliases de compatibilidade, mas os novos fluxos de configuração devem dar preferência aos ids canônicos de opção de autenticação qwen-* e às referências de modelo qwen/.... Se você definir uma entrada personalizada exata models.providers.modelstudio com outro valor de api, esse provedor personalizado gerenciará as referências modelstudio/... em vez do alias de compatibilidade do Qwen.

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-key

Para o endpoint da 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

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-plan

Para o endpoint da China em Pequim:

openclaw onboard --auth-choice qwen-token-plan-cn

Verifique o provedor

openclaw models list --provider qwen-token-plan
openclaw agent --model qwen-token-plan/qwen3.7-plus --message "Reply with: token plan ready"

O guia do OpenClaw da Alibaba usa bailian-token-plan para um provedor personalizado manual. O plugin registra esse id como responsável pela compatibilidade, mas as novas configurações devem usar qwen-token-plan. Uma entrada personalizada exata models.providers.bailian-token-plan mantém o controle sobre o transporte e o catálogo configurados; ela nunca é mesclada ao catálogo canônico da OpenAI.

Use o Token Plan somente em sessões interativas do OpenClaw. Não o selecione para tarefas Cron, scripts autônomos ou backends de aplicações. A Alibaba informa que o uso não interativo pode suspender a assinatura ou revogar sua chave de API.

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-oauth

Defina 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-oauth

O qwen-oauth usa o mesmo nome de variável de ambiente QWEN_API_KEY que o provedor Qwen Cloud, mas armazena a autenticação sob o id de provedor qwen-oauth quando configurado por meio da integração inicial do OpenClaw.

Tipos 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.

Gerenciar chaves: home.qwencloud.com/api-keys | Documentação: docs.qwencloud.com

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

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

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.

Consulte Geração de vídeo para conhecer os parâmetros compartilhados da ferramenta, a seleção de provedor e o comportamento de failover.

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/v1
https://coding-intl.dashscope.aliyuncs.com/v1
https://dashscope.aliyuncs.com/compatible-mode/v1
https://dashscope-intl.aliyuncs.com/compatible-mode/v1
https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
https://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

Seleção de modelos

Escolha de provedores, referências de modelos e comportamento de failover.

Geração de vídeo

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

Alibaba Model Studio

Provedor integrado de geração de vídeos Wan na mesma plataforma DashScope.

Solução de problemas

Solução geral de problemas e perguntas frequentes.

Overview

Concepts and configuration

Providers

Instalar o plugin

Primeiros passos

Tipos de plano e endpoints

Catálogo integrado

Catálogo do Token Plan

Controles de raciocínio

Complementos multimodais

Configuração avançada

Relacionados

Seleção de modelos

Geração de vídeo

Alibaba Model Studio

Solução de problemas

​Instalar o plugin

​Primeiros passos

​Tipos de plano e endpoints

​Catálogo integrado

​Catálogo do Token Plan

​Controles de raciocínio

​Complementos multimodais

​Configuração avançada

​Relacionados

Seleção de modelos

Geração de vídeo

Alibaba Model Studio

Solução de problemas

Instalar o plugin

Primeiros passos

Tipos de plano e endpoints

Catálogo integrado

Catálogo do Token Plan

Controles de raciocínio

Complementos multimodais

Configuração avançada

Relacionados