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:

bash
openclaw plugins install @openclaw/qwen-provideropenclaw gateway restart

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

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

    Para o endpoint da China:

    bash
    openclaw onboard --auth-choice qwen-api-key-cn
  • Defina um modelo padrão

    json5
    {  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}
  • Verifique se o modelo está disponível

    bash
    openclaw models list --provider qwen
  • Standard (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:

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

    Para o endpoint da China:

    bash
    openclaw onboard --auth-choice qwen-standard-api-key-cn
  • Defina um modelo padrão

    json5
    {  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}
  • Verifique se o modelo está disponível

    bash
    openclaw models list --provider qwen
  • Token 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:

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

    Para o endpoint da China em Pequim:

    bash
    openclaw onboard --auth-choice qwen-token-plan-cn
  • Verifique o provedor

    bash
    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

    bash
    openclaw onboard --auth-choice qwen-oauth
  • Defina um modelo padrão

    json5
    {  agents: {    defaults: {      model: { primary: "qwen-oauth/qwen3.5-plus" },    },  },}
  • Verifique se o modelo está disponível

    bash
    openclaw models list --provider qwen-oauth
  • 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.

    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:

    json5
    {  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/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

    Was this useful?
    On this page

    On this page