Vai al contenuto principale

Qwen

Qwen OAuth è stato rimosso. L’integrazione OAuth del livello gratuito (qwen-portal) che usava gli endpoint portal.qwen.ai non è più disponibile. Consulta Issue #49557 per il contesto.
OpenClaw ora considera Qwen come un provider integrato di prima classe con ID canonico qwen. Il provider integrato è destinato agli endpoint Qwen Cloud / Alibaba DashScope e Coding Plan e mantiene funzionanti gli ID legacy modelstudio come alias di compatibilità.
  • Provider: qwen
  • Variabile d’ambiente preferita: QWEN_API_KEY
  • Accettate anche per compatibilità: MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
  • Stile API: compatibile con OpenAI
Se vuoi qwen3.6-plus, preferisci l’endpoint Standard (pay-as-you-go). Il supporto del Coding Plan può essere in ritardo rispetto al catalogo pubblico.

Per iniziare

Scegli il tuo tipo di piano e segui i passaggi di configurazione.
Ideale per: accesso in abbonamento tramite il Qwen Coding Plan.
1

Ottieni la tua chiave API

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

Esegui l’onboarding

Per l’endpoint Global:
openclaw onboard --auth-choice qwen-api-key
Per l’endpoint China:
openclaw onboard --auth-choice qwen-api-key-cn
3

Imposta un modello predefinito

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

Verifica che il modello sia disponibile

openclaw models list --provider qwen
Gli ID auth-choice legacy modelstudio-* e i riferimenti di modello modelstudio/... continuano a funzionare come alias di compatibilità, ma i nuovi flussi di configurazione dovrebbero preferire gli ID auth-choice canonici qwen-* e i riferimenti di modello qwen/....

Tipi di piano ed endpoint

PlanRegionAuth choiceEndpoint
Standard (pay-as-you-go)Chinaqwen-standard-api-key-cndashscope.aliyuncs.com/compatible-mode/v1
Standard (pay-as-you-go)Globalqwen-standard-api-keydashscope-intl.aliyuncs.com/compatible-mode/v1
Coding Plan (abbonamento)Chinaqwen-api-key-cncoding.dashscope.aliyuncs.com/v1
Coding Plan (abbonamento)Globalqwen-api-keycoding-intl.dashscope.aliyuncs.com/v1
Il provider seleziona automaticamente l’endpoint in base alla tua scelta di autenticazione. Le scelte canoniche usano la famiglia qwen-*; modelstudio-* resta solo per compatibilità. Puoi sostituire questo comportamento con un baseUrl personalizzato nella configurazione.
Gestisci le chiavi: home.qwencloud.com/api-keys | Documentazione: docs.qwencloud.com

Catalogo integrato

OpenClaw al momento include questo catalogo Qwen integrato. Il catalogo configurato è consapevole dell’endpoint: le configurazioni Coding Plan omettono i modelli che sono noti per funzionare solo sull’endpoint Standard.
Model refInputContextNotes
qwen/qwen3.5-plustext, image1,000,000Modello predefinito
qwen/qwen3.6-plustext, image1,000,000Preferisci gli endpoint Standard quando ti serve questo modello
qwen/qwen3-max-2026-01-23text262,144Linea Qwen Max
qwen/qwen3-coder-nexttext262,144Coding
qwen/qwen3-coder-plustext1,000,000Coding
qwen/MiniMax-M2.5text1,000,000Reasoning abilitato
qwen/glm-5text202,752GLM
qwen/glm-4.7text202,752GLM
qwen/kimi-k2.5text, image262,144Moonshot AI tramite Alibaba
La disponibilità può comunque variare in base all’endpoint e al piano di fatturazione anche quando un modello è presente nel catalogo integrato.

Componenti aggiuntivi multimodali

L’estensione 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:
{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },
    },
  },
}
Consulta Video Generation per i parametri condivisi degli strumenti, la selezione del provider e il comportamento di failover.

Avanzate

Il plugin Qwen integrato registra il media understanding per immagini e video sugli endpoint DashScope Standard (non sugli endpoint Coding Plan).
PropertyValue
Modelqwen-vl-max-latest
Supported inputImmagini, video
Il media understanding viene risolto automaticamente a partire dall’autenticazione Qwen configurata: non è necessaria alcuna configurazione aggiuntiva. Assicurati di usare un endpoint Standard (pay-as-you-go) per il supporto al media understanding.
qwen3.6-plus è disponibile sugli endpoint Standard (pay-as-you-go) Model Studio:
  • China: dashscope.aliyuncs.com/compatible-mode/v1
  • Global: dashscope-intl.aliyuncs.com/compatible-mode/v1
Se gli endpoint del Coding Plan restituiscono un errore “unsupported model” per qwen3.6-plus, passa allo Standard (pay-as-you-go) invece che alla coppia endpoint/chiave del Coding Plan.
L’estensione qwen viene posizionata come la sede del vendor per l’intera superficie Qwen Cloud, non solo per i modelli di coding/testo.
  • Modelli testo/chat: integrati ora
  • Tool calling, output strutturato, thinking: ereditati dal trasporto compatibile con OpenAI
  • Generazione di immagini: pianificata al livello del provider-plugin
  • Comprensione di immagini/video: integrata ora sull’endpoint Standard
  • Speech/audio: pianificata al livello del provider-plugin
  • Embedding/reranking della memoria: pianificati tramite la superficie dell’adapter di embedding
  • Generazione video: integrata ora tramite la capacità condivisa di video-generation
Per la generazione video, OpenClaw mappa la regione Qwen configurata all’host DashScope AIGC corrispondente prima di inviare il job:
  • Global/Intl: https://dashscope-intl.aliyuncs.com
  • China: https://dashscope.aliyuncs.com
Questo significa che un normale models.providers.qwen.baseUrl che punta a uno dei host Qwen Coding Plan o Standard mantiene comunque la generazione video sul corretto endpoint video DashScope regionale.Limiti attuali della generazione video Qwen integrata:
  • Fino a 1 video di output per richiesta
  • Fino a 1 immagine di input
  • Fino a 4 video di input
  • Durata fino a 10 secondi
  • 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 quei riferimenti.
Gli endpoint nativi Model Studio pubblicizzano la compatibilità dell’uso in streaming sul trasporto condiviso openai-completions. OpenClaw ora la basa sulle capacità dell’endpoint, quindi gli ID 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 provider integrato qwen.La compatibilità dell’utilizzo in 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
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 China: https://dashscope.aliyuncs.com/compatible-mode/v1
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 di modello e del comportamento di failover.

Video generation

Parametri condivisi dello strumento video e selezione del provider.

Alibaba (ModelStudio)

Provider legacy ModelStudio e note sulla migrazione.

Risoluzione dei problemi

Risoluzione generale dei problemi e FAQ.