Qwen - OpenClaw

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

Se você quiser qwen3.6-plus, prefira o endpoint Standard (pague conforme o uso). O suporte ao Coding Plan pode ficar atrás do catálogo público.

Instalar plugin

Instale o plugin oficial 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 (pague conforme o uso)
Qwen OAuth / Portal

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-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 de auth-choice modelstudio-* e as refs de modelo modelstudio/... ainda funcionam como aliases de compatibilidade, mas novos fluxos de configuração devem preferir os ids de auth-choice canônicos qwen-* e as refs de modelo qwen/.... Se você definir uma entrada models.providers.modelstudio personalizada exata com outro valor de api, esse provedor personalizado passa a controlar as refs modelstudio/... em vez do alias de compatibilidade do Qwen.

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

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

qwen-oauth usa o mesmo nome de variável de ambiente QWEN_API_KEY que o provedor DashScope, mas armazena a autenticação sob o id de provedor qwen-oauth quando configurado pelo onboarding do OpenClaw.

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.

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

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

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

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" },
    },
  },
}

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

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

Seleção de modelo

Escolha de provedores, referências 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 ModelStudio legado e notas de migração.

Solução de problemas

Solução de problemas geral e perguntas frequentes.

​Instalar plugin

​Primeiros passos

​Tipos de plano e endpoints

​Catálogo integrado

​Controles de raciocínio

​Complementos multimodais

​Configuração avançada

​Relacionado

Seleção de modelo

Geração de vídeo

Alibaba (ModelStudio)

Solução de problemas

Instalar plugin

Primeiros passos

Tipos de plano e endpoints

Catálogo integrado

Controles de raciocínio

Complementos multimodais

Configuração avançada

Relacionado