Qwen

Qwen Cloud è un Plugin provider esterno ufficiale di OpenClaw con ID canonico qwen. È destinato agli endpoint Standard e Coding Plan di Qwen Cloud / Alibaba DashScope, espone Token Plan come qwen-token-plan, mantiene modelstudio come alias di compatibilità, gestisce autonomamente l’ID provider personalizzato bailian-token-plan documentato da Alibaba ed espone il flusso di token di Qwen Portal come qwen-oauth.

Proprietà	Valore
Provider	`qwen`
Provider Token Plan	`qwen-token-plan`
Provider del portale	`qwen-oauth`
Variabile di ambiente preferita	`QWEN_API_KEY`
Variabile di ambiente Token Plan	`QWEN_TOKEN_PLAN_API_KEY`
Accettate anche (compatibilità)	`MODELSTUDIO_API_KEY`, `DASHSCOPE_API_KEY`
Stile API	Compatibile con OpenAI

qwen3.7-plus e qwen3.6-plus funzionano con gli endpoint Coding Plan e Standard. Per qwen3.7-max o qwen3.6-flash, usa un endpoint Standard (pagamento in base al consumo).

Installare il Plugin

qwen viene distribuito come Plugin esterno ufficiale e non è incluso nel core. Installalo e riavvia il Gateway:

openclaw plugins install @openclaw/qwen-provider
openclaw gateway restart

Per iniziare

Scegli il tipo di piano e segui i passaggi di configurazione.

Coding Plan (abbonamento)
Standard (pagamento in base al consumo)
Token Plan (edizione Team)
Qwen OAuth / Portal

Ideale per: accesso in abbonamento tramite Qwen Coding Plan.

Ottieni la chiave API

Crea o copia una chiave API da home.qwencloud.com/api-keys.

Esegui la configurazione iniziale

Per l’endpoint globale:

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

Per l’endpoint cinese:

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

Imposta un modello predefinito

{
  agents: {
    defaults: {
      model: { primary: "qwen/qwen3.5-plus" },
    },
  },
}

Verifica che il modello sia disponibile

openclaw models list --provider qwen

Gli ID legacy modelstudio-* per la scelta dell’autenticazione e i riferimenti ai modelli modelstudio/... continuano a funzionare come alias di compatibilità, ma i nuovi flussi di configurazione dovrebbero preferire gli ID canonici qwen-* per la scelta dell’autenticazione e i riferimenti ai modelli qwen/.... Se definisci una voce personalizzata esatta models.providers.modelstudio con un altro valore api, tale provider personalizzato gestisce i riferimenti modelstudio/... al posto dell’alias di compatibilità Qwen.

Ideale per: accesso con pagamento in base al consumo tramite l’endpoint Standard di Model Studio, inclusi qwen3.7-max e qwen3.6-flash, che non sono disponibili nel Coding Plan.

Ottieni la chiave API

Crea o copia una chiave API da home.qwencloud.com/api-keys.

Esegui la configurazione iniziale

Per l’endpoint globale:

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

Per l’endpoint cinese:

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

Imposta un modello predefinito

{
  agents: {
    defaults: {
      model: { primary: "qwen/qwen3.5-plus" },
    },
  },
}

Verifica che il modello sia disponibile

openclaw models list --provider qwen

Ideale per: accesso in abbonamento per team basato su crediti a Qwen e ai modelli di terze parti supportati tramite Alibaba Cloud Model Studio.

Ottieni la chiave dedicata

Assegna una postazione Token Plan e crea la relativa chiave dedicata sk-sp-.... Le chiavi di Token Plan, Coding Plan e pagamento in base al consumo non sono intercambiabili. Consulta la panoramica globale di Token Plan o la panoramica cinese di Token Plan.

Esegui la configurazione iniziale

Per l’endpoint globale/internazionale a Singapore:

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

Per l’endpoint cinese a Pechino:

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

Verifica il provider

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

La guida OpenClaw di Alibaba usa bailian-token-plan per un provider personalizzato manuale. Il Plugin registra tale ID come gestore di compatibilità, ma le nuove configurazioni dovrebbero usare qwen-token-plan. Una voce personalizzata esatta models.providers.bailian-token-plan mantiene la gestione del trasporto e del catalogo configurati; non viene mai unita al catalogo canonico di OpenAI.

Usa Token Plan solo per sessioni OpenClaw interattive. Non selezionarlo per processi Cron, script non presidiati o backend applicativi. Alibaba dichiara che l’uso non interattivo può comportare la sospensione dell’abbonamento o la revoca della relativa chiave API.

Ideale per: un token di Qwen Portal per https://portal.qwen.ai/v1.Consulta Qwen OAuth / Portal per la pagina dedicata al provider e le note sulla migrazione.

Fornisci il token del portale

openclaw onboard --auth-choice qwen-oauth

Imposta un modello predefinito

{
  agents: {
    defaults: {
      model: { primary: "qwen-oauth/qwen3.5-plus" },
    },
  },
}

Verifica che il modello sia disponibile

openclaw models list --provider qwen-oauth

qwen-oauth usa lo stesso nome di variabile di ambiente QWEN_API_KEY del provider Qwen Cloud, ma memorizza l’autenticazione sotto l’ID provider qwen-oauth quando viene configurato tramite la procedura iniziale di OpenClaw.

Tipi di piano ed endpoint

Piano	Regione	Scelta di autenticazione	Endpoint
Coding Plan (abbonamento)	Cina	`qwen-api-key-cn`	`coding.dashscope.aliyuncs.com/v1`
Coding Plan (abbonamento)	Globale	`qwen-api-key`	`coding-intl.dashscope.aliyuncs.com/v1`
Qwen Portal	Globale	`qwen-oauth`	`portal.qwen.ai/v1`
Standard (pagamento in base al consumo)	Cina	`qwen-standard-api-key-cn`	`dashscope.aliyuncs.com/compatible-mode/v1`
Standard (pagamento in base al consumo)	Globale	`qwen-standard-api-key`	`dashscope-intl.aliyuncs.com/compatible-mode/v1`
Token Plan (edizione Team)	Cina	`qwen-token-plan-cn`	`token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1`
Token Plan (edizione Team)	Globale	`qwen-token-plan`	`token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`

Il provider seleziona automaticamente l’endpoint in base alla scelta di autenticazione. Le scelte canoniche usano la famiglia qwen-*; modelstudio-* rimane disponibile solo per compatibilità. Puoi eseguire l’override con un baseUrl personalizzato nella configurazione.

Gestisci le chiavi: home.qwencloud.com/api-keys | Documentazione: docs.qwencloud.com

Catalogo integrato

OpenClaw include questo catalogo statico Qwen. Il catalogo tiene conto dell’endpoint: le configurazioni Coding Plan omettono i modelli che funzionano solo sull’endpoint Standard.

Riferimento modello	Input	Contesto	Note
`qwen/qwen3.5-plus`	testo, immagine	1,000,000	Modello predefinito
`qwen/qwen3.6-flash`	testo, immagine	1,000,000	Solo endpoint Standard
`qwen/qwen3.6-plus`	testo, immagine	1,000,000	Coding Plan + Standard
`qwen/qwen3.7-max`	testo	1,000,000	Solo endpoint Standard
`qwen/qwen3.7-plus`	testo, immagine	1,000,000	Coding Plan + Standard
`qwen/qwen3-max-2026-01-23`	testo	262,144	Linea Qwen Max
`qwen/qwen3-coder-next`	testo	262,144	Programmazione
`qwen/qwen3-coder-plus`	testo	1,000,000	Programmazione
`qwen/MiniMax-M2.5`	testo	1,000,000	Ragionamento abilitato
`qwen/glm-5`	testo	202,752	GLM
`qwen/glm-4.7`	testo	202,752	GLM
`qwen/kimi-k2.5`	testo, immagine	262,144	Moonshot AI tramite Alibaba
`qwen-oauth/qwen3.5-plus`	testo, immagine	1,000,000	Predefinito di Qwen Portal

La disponibilità può comunque variare in base all’endpoint e al piano di fatturazione, anche quando un modello è presente nel catalogo statico.

Catalogo Token Plan

Token Plan usa un elenco consentito separato basato sulla corrispondenza esatta delle stringhe. I modelli del piano dedicati esclusivamente alla generazione di immagini non sono inclusi perché usano API differenti.

Riferimento modello	Input	Contesto
`qwen-token-plan/qwen3.7-max`	testo	1,000,000
`qwen-token-plan/qwen3.7-plus`	testo, immagine	1,000,000
`qwen-token-plan/qwen3.6-plus`	testo, immagine	1,000,000
`qwen-token-plan/qwen3.6-flash`	testo, immagine	1,000,000
`qwen-token-plan/deepseek-v4-pro`	testo	1,000,000
`qwen-token-plan/deepseek-v4-flash`	testo	1,000,000
`qwen-token-plan/deepseek-v3.2`	testo	131,072
`qwen-token-plan/kimi-k2.7-code`	testo, immagine	262,144
`qwen-token-plan/kimi-k2.6`	testo, immagine	262,144
`qwen-token-plan/kimi-k2.5`	testo, immagine	262,144
`qwen-token-plan/glm-5.2`	testo	1,000,000
`qwen-token-plan/glm-5.1`	testo	202,752
`qwen-token-plan/glm-5`	testo	202,752
`qwen-token-plan/MiniMax-M2.5`	testo	196,608

Controlli del ragionamento

qwen3.7-max, qwen3.7-plus, qwen3.6-flash e qwen3.6-plus hanno il ragionamento abilitato nel catalogo integrato. Per i modelli di ragionamento della famiglia qwen, il provider associa i livelli di ragionamento di OpenClaw al flag di richiesta di primo livello enable_thinking di DashScope: con il ragionamento disabilitato invia enable_thinking: false, mentre con qualsiasi altro livello invia enable_thinking: true. I modelli personalizzati possono adottare un payload di ragionamento alternativo basato sul modello di chat impostando compat.thinkingFormat: "qwen-chat-template" nella voce del modello. Anche i modelli Token Plan sono contrassegnati come in grado di ragionare. kimi-k2.7-code e MiniMax-M2.5 funzionano esclusivamente con il ragionamento, quindi OpenClaw lo mantiene abilitato anche quando la sessione richiede /think off. DeepSeek V4 associa i livelli da minimal a high all’intensità high del servizio e associa xhigh o max a max. GLM 5.2 accetta l’intero intervallo da minimal a max; GLM 5.1 e GLM 5 accettano i livelli fino a xhigh e tutti e tre usano high come valore predefinito. Gli altri modelli ibridi rispettano lo stato di attivazione o disattivazione richiesto.

Funzionalità aggiuntive multimodali

Il plugin qwen offre funzionalità multimodali solo sugli endpoint DashScope Standard, non sugli endpoint Coding Plan:

Comprensione di immagini e video tramite qwen-vl-max-latest
Generazione di video Wan tramite wan2.6-t2v (predefinito), wan2.6-i2v, wan2.6-r2v, wan2.6-r2v-flash, wan2.7-r2v

L’autenticazione per la comprensione dei contenuti multimediali viene determinata automaticamente dalla configurazione Qwen; non è necessaria alcuna configurazione aggiuntiva. Perché la comprensione dei contenuti multimediali funzioni, assicurati di utilizzare un endpoint Standard (con pagamento in base al consumo). Per impostare Qwen come provider video predefinito:

{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },
    },
  },
}

Limiti della generazione video: 1 video di output per richiesta, fino a 1 immagine di input (da immagine a video), fino a 4 video di input (da video a video), durata massima di 10 secondi. Supporta size, aspectRatio, resolution, audio e watermark. Gli input di immagini o video di riferimento richiedono URL http(s) remoti; i percorsi di file locali vengono rifiutati prima dell’invio perché l’endpoint video di DashScope non accetta buffer locali caricati per tali riferimenti.

Consulta Generazione di video per i parametri condivisi dello strumento, la selezione del provider e il comportamento di failover.

Configurazione avanzata

Disponibilità di Qwen 3.6 e 3.7

qwen3.7-plus e qwen3.6-plus sono disponibili sugli endpoint Coding Plan e Standard. qwen3.7-max e qwen3.6-flash sono disponibili solo su Standard. Gli endpoint Standard (con pagamento in base al consumo) sono:

Cina: dashscope.aliyuncs.com/compatible-mode/v1
Globale: dashscope-intl.aliyuncs.com/compatible-mode/v1

OpenClaw omette qwen3.7-max e qwen3.6-flash dai cataloghi Coding Plan. Se un endpoint Coding Plan restituisce un errore “modello non supportato” per uno dei due, passa all’endpoint Standard corrispondente e alla relativa chiave.

Instradamento regionale della generazione video

Prima di inviare un processo di generazione video, OpenClaw associa la regione Qwen configurata all’host DashScope AIGC corrispondente:

Globale/Internazionale: https://dashscope-intl.aliyuncs.com
Cina: https://dashscope.aliyuncs.com

Un normale models.providers.qwen.baseUrl che punta agli host Qwen Coding Plan o Standard instrada comunque la generazione video all’endpoint video DashScope regionale corrispondente.

Compatibilità dell'utilizzo in streaming

Gli endpoint Qwen nativi dichiarano la compatibilità dell’utilizzo in streaming sul trasporto condiviso openai-completions, quindi gli identificativi di provider personalizzati compatibili con DashScope che puntano agli stessi host nativi ereditano lo stesso comportamento senza richiedere specificamente l’identificativo del provider integrato qwen. Ciò si applica agli endpoint 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

Piano delle funzionalità

Il plugin qwen viene posizionato come sede specifica del fornitore per l’intera gamma di Qwen Cloud, non soltanto per i modelli di programmazione e testo.

Modelli di testo/chat: disponibili tramite il plugin
Chiamata di strumenti, output strutturato, ragionamento: ereditati dal trasporto compatibile con OpenAI
Generazione di immagini: pianificata a livello del plugin del provider
Comprensione di immagini/video: disponibile tramite il plugin sull’endpoint Standard
Voce/audio: pianificati a livello del plugin del provider
Embedding e riordinamento della memoria: pianificati tramite l’interfaccia dell’adattatore di embedding
Generazione di video: disponibile tramite il plugin attraverso la funzionalità condivisa di generazione video

Configurazione dell'ambiente e del demone

Se il Gateway viene eseguito come demone (launchd/systemd), assicurati che QWEN_API_KEY o QWEN_TOKEN_PLAN_API_KEY sia disponibile per tale processo (ad esempio in ~/.openclaw/.env o tramite env.shellEnv).

Contenuti correlati

Selezione del modello

Scelta dei provider, dei riferimenti ai modelli e del comportamento di failover.

Generazione di video

Parametri condivisi dello strumento video e selezione del provider.

Alibaba Model Studio

Provider integrato per la generazione di video Wan sulla stessa piattaforma DashScope.

Risoluzione dei problemi

Risoluzione generale dei problemi e domande frequenti.

Overview

Concepts and configuration

Providers

Installare il Plugin

Per iniziare

Tipi di piano ed endpoint

Catalogo integrato

Catalogo Token Plan

Controlli del ragionamento

Funzionalità aggiuntive multimodali

Configurazione avanzata

Contenuti correlati

Selezione del modello

Generazione di video

Alibaba Model Studio

Risoluzione dei problemi

​Installare il Plugin

​Per iniziare

​Tipi di piano ed endpoint

​Catalogo integrato

​Catalogo Token Plan

​Controlli del ragionamento

​Funzionalità aggiuntive multimodali

​Configurazione avanzata

​Contenuti correlati

Selezione del modello

Generazione di video

Alibaba Model Studio

Risoluzione dei problemi

Installare il Plugin

Per iniziare

Tipi di piano ed endpoint

Catalogo integrato

Catalogo Token Plan

Controlli del ragionamento

Funzionalità aggiuntive multimodali

Configurazione avanzata

Contenuti correlati