Providers
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 |
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-provideropenclaw gateway restartPer iniziare
Scegli il tipo di piano e segui i passaggi di configurazione.
Coding Plan (abbonamento)
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-keyPer l'endpoint cinese:
openclaw onboard --auth-choice qwen-api-key-cnImposta un modello predefinito
{ agents: { defaults: { model: { primary: "qwen/qwen3.5-plus" }, }, },}Verifica che il modello sia disponibile
openclaw models list --provider qwenStandard (pagamento in base al consumo)
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-keyPer l'endpoint cinese:
openclaw onboard --auth-choice qwen-standard-api-key-cnImposta un modello predefinito
{ agents: { defaults: { model: { primary: "qwen/qwen3.5-plus" }, }, },}Verifica che il modello sia disponibile
openclaw models list --provider qwenToken Plan (edizione Team)
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-planPer l'endpoint cinese a Pechino:
openclaw onboard --auth-choice qwen-token-plan-cnVerifica il provider
openclaw models list --provider qwen-token-planopenclaw agent --model qwen-token-plan/qwen3.7-plus --message "Reply with: token plan ready"Qwen OAuth / Portal
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-oauthImposta un modello predefinito
{ agents: { defaults: { model: { primary: "qwen-oauth/qwen3.5-plus" }, }, },}Verifica che il modello sia disponibile
openclaw models list --provider qwen-oauthTipi 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.
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 |
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.
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/v1https://coding-intl.dashscope.aliyuncs.com/v1https://dashscope.aliyuncs.com/compatible-mode/v1https://dashscope-intl.aliyuncs.com/compatible-mode/v1https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1https://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
Scelta dei provider, dei riferimenti ai modelli e del comportamento di failover.
Parametri condivisi dello strumento video e selezione del provider.
Provider integrato per la generazione di video Wan sulla stessa piattaforma DashScope.
Risoluzione generale dei problemi e domande frequenti.