Providers

Qwen

OpenClaw ora tratta Qwen come Plugin provider di prima classe con id canonico qwen. Il Plugin provider punta agli endpoint Qwen Cloud / Alibaba DashScope e Coding Plan, mantiene funzionanti gli id legacy modelstudio come alias di compatibilità ed espone anche il flusso del token Qwen Portal come provider qwen-oauth.

Provider: qwen
Provider Portal: qwen-oauth
Variabile env preferita: QWEN_API_KEY
Accettate anche per compatibilità: MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
Stile API: compatibile con OpenAI

Installa Plugin

Installa il Plugin ufficiale, poi riavvia Gateway:

bash

openclaw plugins install @openclaw/qwen-provideropenclaw gateway restart

Per iniziare

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

Coding Plan (abbonamento)

Ideale per: accesso basato su abbonamento tramite Qwen Coding Plan.

Ottieni la tua chiave API

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

Esegui l'onboarding

Per l'endpoint Global:

bash

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

Per l'endpoint China:

bash

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

Imposta un modello predefinito

json5

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

Verifica che il modello sia disponibile

bash

openclaw models list --provider qwen

Standard (pagamento a consumo)

Ideale per: accesso a consumo tramite l'endpoint Standard Model Studio, inclusi modelli come qwen3.6-plus che potrebbero non essere disponibili nel Coding Plan.

Ottieni la tua chiave API

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

Esegui l'onboarding

Per l'endpoint Global:

bash

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

Per l'endpoint China:

bash

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

Imposta un modello predefinito

json5

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

Verifica che il modello sia disponibile

bash

openclaw models list --provider qwen

Qwen OAuth / Portal

Ideale per: un token Qwen Portal per https://portal.qwen.ai/v1.

Consulta Qwen OAuth / Portal per la pagina dedicata del provider e le note di migrazione.

Fornisci il tuo token Portal

bash

openclaw onboard --auth-choice qwen-oauth

Imposta un modello predefinito

json5

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

Verifica che il modello sia disponibile

bash

openclaw models list --provider qwen-oauth

Tipi di piano ed endpoint

Piano	Regione	Scelta auth	Endpoint
Standard (pagamento a consumo)	China	`qwen-standard-api-key-cn`	`dashscope.aliyuncs.com/compatible-mode/v1`
Standard (pagamento a consumo)	Global	`qwen-standard-api-key`	`dashscope-intl.aliyuncs.com/compatible-mode/v1`
Coding Plan (abbonamento)	China	`qwen-api-key-cn`	`coding.dashscope.aliyuncs.com/v1`
Coding Plan (abbonamento)	Global	`qwen-api-key`	`coding-intl.dashscope.aliyuncs.com/v1`
Qwen Portal	Global	`qwen-oauth`	`portal.qwen.ai/v1`

Il provider seleziona automaticamente l'endpoint in base alla tua scelta auth. Le scelte canoniche usano la famiglia qwen-*; modelstudio-* resta solo per compatibilità. Puoi eseguire l'override con un baseUrl personalizzato nella configurazione.

Catalogo integrato

OpenClaw attualmente distribuisce questo catalogo statico Qwen. Il catalogo configurato è consapevole dell'endpoint: le configurazioni Coding Plan omettono i modelli noti per funzionare solo sull'endpoint Standard.

Riferimento modello	Input	Contesto	Note
`qwen/qwen3.5-plus`	text, image	1,000,000	Modello predefinito
`qwen/qwen3.6-plus`	text, image	1,000,000	Preferisci endpoint Standard quando ti serve questo modello
`qwen/qwen3-max-2026-01-23`	text	262,144	Linea Qwen Max
`qwen/qwen3-coder-next`	text	262,144	Coding
`qwen/qwen3-coder-plus`	text	1,000,000	Coding
`qwen/MiniMax-M2.5`	text	1,000,000	Ragionamento abilitato
`qwen/glm-5`	text	202,752	GLM
`qwen/glm-4.7`	text	202,752	GLM
`qwen/kimi-k2.5`	text, image	262,144	Moonshot AI tramite Alibaba
`qwen-oauth/qwen3.5-plus`	text, image	1,000,000	Predefinito Qwen Portal

Controlli di ragionamento

Per i modelli Qwen Cloud con ragionamento abilitato, il provider mappa i livelli di ragionamento di OpenClaw al flag di richiesta di primo livello enable_thinking di DashScope. Il ragionamento disabilitato invia enable_thinking: false; gli altri livelli di ragionamento inviano enable_thinking: true.

Add-on multimodali

Il Plugin qwen espone anche capacità multimodali sugli endpoint DashScope Standard (non sugli endpoint Coding Plan):

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

Per usare Qwen come provider video predefinito:

json5

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

Configurazione avanzata

Comprensione di immagini e video

Il Plugin Qwen registra la comprensione multimediale per immagini e video sugli endpoint DashScope Standard (non sugli endpoint Coding Plan).

Proprietà	Valore
Modello	`qwen-vl-max-latest`
Input supportato	Immagini, video

La comprensione multimediale viene risolta automaticamente dall'autenticazione Qwen configurata: non serve configurazione aggiuntiva. Assicurati di usare un endpoint Standard (pagamento a consumo) per il supporto alla comprensione multimediale.

Disponibilità di Qwen 3.6 Plus

qwen3.6-plus è disponibile sugli endpoint Standard (pagamento a consumo) Model Studio:

China: dashscope.aliyuncs.com/compatible-mode/v1
Global: dashscope-intl.aliyuncs.com/compatible-mode/v1

Se gli endpoint Coding Plan restituiscono un errore "unsupported model" per qwen3.6-plus, passa a Standard (pagamento a consumo) invece della coppia endpoint/chiave del Coding Plan.

Il catalogo statico Qwen di OpenClaw non pubblicizza qwen3.6-plus sugli endpoint Coding Plan, ma le voci qwen/qwen3.6-plus configurate esplicitamente sotto models.providers.qwen.models vengono rispettate sui baseUrl Coding Plan, così puoi abilitare quel modello se Aliyun lo abilita sul tuo abbonamento. L'API upstream decide comunque se la chiamata va a buon fine.

Piano delle capacità

Il Plugin qwen viene posizionato come sede vendor per l'intera superficie Qwen Cloud, non solo per i modelli di coding/testo.

Modelli testo/chat: disponibili tramite il Plugin
Tool calling, output strutturato, ragionamento: ereditati dal trasporto compatibile con OpenAI
Generazione immagini: pianificata a livello di Plugin provider
Comprensione immagini/video: disponibile tramite il Plugin sull'endpoint Standard
Voce/audio: pianificati a livello di Plugin provider
Embedding/reranking di memoria: pianificati tramite la superficie dell'adattatore embedding
Generazione video: disponibile tramite il Plugin attraverso la capacità condivisa di generazione video

Dettagli sulla generazione video

Per la generazione video, OpenClaw mappa la regione Qwen configurata sull'host DashScope AIGC corrispondente prima di inviare il job:

Global/Intl: https://dashscope-intl.aliyuncs.com
China: https://dashscope.aliyuncs.com

Ciò significa che un normale models.providers.qwen.baseUrl che punta agli host Qwen Coding Plan o Standard mantiene comunque la generazione video sull'endpoint video DashScope regionale corretto.

Limiti attuali della generazione video Qwen:

Fino a 1 video di output per richiesta
Fino a 1 immagine di input
Fino a 4 video di input
Fino a 10 secondi di durata
Supporta size, aspectRatio, resolution, audio e watermark
La modalità immagine/video di riferimento attualmente richiede URL http(s) remoti. I percorsi di file locali vengono rifiutati in anticipo perché l'endpoint video DashScope non accetta buffer locali caricati per tali riferimenti.

Compatibilità dell'utilizzo in streaming

Gli endpoint nativi di Model Studio dichiarano la compatibilità dell'utilizzo in streaming sul trasporto condiviso openai-completions. OpenClaw ora determina questo in base alle capacità degli endpoint, quindi gli ID di provider personalizzati compatibili con DashScope che puntano agli stessi host nativi ereditano lo stesso comportamento di utilizzo in streaming invece di richiedere specificamente l'ID del provider integrato qwen.

La compatibilità dell'utilizzo con streaming nativo si applica sia agli host Coding Plan sia agli host Standard compatibili con 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

Regioni degli endpoint multimodali

Le superfici multimodali (comprensione video e generazione video Wan) usano gli endpoint DashScope Standard, non gli endpoint Coding Plan:

URL di base Standard Global/Intl: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
URL di base Standard Cina: https://dashscope.aliyuncs.com/compatible-mode/v1

Configurazione dell'ambiente e del daemon

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

Correlati

Selezione del modello

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

Generazione video

Parametri condivisi dello strumento video e selezione del provider.

Alibaba (ModelStudio)

Provider ModelStudio legacy e note sulla migrazione.

Risoluzione dei problemi

Risoluzione generale dei problemi e FAQ.

Was this useful?

Qwen

Installa Plugin

Per iniziare

Coding Plan (abbonamento)

Ottieni la tua chiave API

Esegui l'onboarding

Imposta un modello predefinito

Verifica che il modello sia disponibile

Standard (pagamento a consumo)

Ottieni la tua chiave API

Esegui l'onboarding

Imposta un modello predefinito

Verifica che il modello sia disponibile

Qwen OAuth / Portal

Fornisci il tuo token Portal

Imposta un modello predefinito

Verifica che il modello sia disponibile

Tipi di piano ed endpoint

Catalogo integrato

Controlli di ragionamento

Add-on multimodali

Configurazione avanzata

Correlati

On this page

Molty