Passer au contenu principal
OpenClaw traite désormais Qwen comme un Plugin fournisseur de premier rang avec l’id canonique qwen. Le Plugin fournisseur cible les points de terminaison Qwen Cloud / Alibaba DashScope et Coding Plan, maintient le fonctionnement des anciens identifiants modelstudio comme alias de compatibilité, et expose aussi le flux de jeton Qwen Portal comme fournisseur qwen-oauth.
  • Fournisseur : qwen
  • Fournisseur Portal : qwen-oauth
  • Variable d’environnement préférée : QWEN_API_KEY
  • Également acceptées pour compatibilité : MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
  • Style d’API : compatible OpenAI
Si vous voulez qwen3.6-plus, préférez le point de terminaison Standard (paiement à l’utilisation). La prise en charge de Coding Plan peut être en retard par rapport au catalogue public.

Installer le Plugin

Installez le Plugin officiel, puis redémarrez Gateway :
openclaw plugins install @openclaw/qwen-provider
openclaw gateway restart

Premiers pas

Choisissez votre type de forfait et suivez les étapes de configuration.
Idéal pour : un accès par abonnement via Qwen Coding Plan.
1

Get your API key

Créez ou copiez une clé API depuis home.qwencloud.com/api-keys.
2

Run onboarding

Pour le point de terminaison Global :
openclaw onboard --auth-choice qwen-api-key
Pour le point de terminaison Chine :
openclaw onboard --auth-choice qwen-api-key-cn
3

Set a default model

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

Verify the model is available

openclaw models list --provider qwen
Les anciens identifiants auth-choice modelstudio-* et les références de modèle modelstudio/... fonctionnent toujours comme alias de compatibilité, mais les nouveaux flux de configuration devraient préférer les identifiants auth-choice canoniques qwen-* et les références de modèle qwen/.... Si vous définissez une entrée personnalisée exacte models.providers.modelstudio avec une autre valeur api, ce fournisseur personnalisé possède les références modelstudio/... au lieu de l’alias de compatibilité Qwen.

Types de forfaits et points de terminaison

ForfaitRégionChoix d’authentificationPoint de terminaison
Standard (paiement à l’utilisation)Chineqwen-standard-api-key-cndashscope.aliyuncs.com/compatible-mode/v1
Standard (paiement à l’utilisation)Globalqwen-standard-api-keydashscope-intl.aliyuncs.com/compatible-mode/v1
Coding Plan (abonnement)Chineqwen-api-key-cncoding.dashscope.aliyuncs.com/v1
Coding Plan (abonnement)Globalqwen-api-keycoding-intl.dashscope.aliyuncs.com/v1
Qwen PortalGlobalqwen-oauthportal.qwen.ai/v1
Le fournisseur sélectionne automatiquement le point de terminaison selon votre choix d’authentification. Les choix canoniques utilisent la famille qwen-* ; modelstudio-* reste réservé à la compatibilité. Vous pouvez remplacer cela avec un baseUrl personnalisé dans la configuration.

Catalogue intégré

OpenClaw fournit actuellement ce catalogue statique Qwen. Le catalogue configuré est adapté au point de terminaison : les configurations Coding Plan omettent les modèles uniquement connus comme fonctionnant sur le point de terminaison Standard.
Référence de modèleEntréeContexteNotes
qwen/qwen3.5-plustexte, image1,000,000Modèle par défaut
qwen/qwen3.6-plustexte, image1,000,000Préférez les points de terminaison Standard lorsque vous avez besoin de ce modèle
qwen/qwen3-max-2026-01-23texte262,144Gamme Qwen Max
qwen/qwen3-coder-nexttexte262,144Codage
qwen/qwen3-coder-plustexte1,000,000Codage
qwen/MiniMax-M2.5texte1,000,000Raisonnement activé
qwen/glm-5texte202,752GLM
qwen/glm-4.7texte202,752GLM
qwen/kimi-k2.5texte, image262,144Moonshot AI via Alibaba
qwen-oauth/qwen3.5-plustexte, image1,000,000Valeur par défaut de Qwen Portal
La disponibilité peut encore varier selon le point de terminaison et le forfait de facturation, même lorsqu’un modèle est présent dans le catalogue statique.

Contrôles de raisonnement

Pour les modèles Qwen Cloud avec raisonnement activé, le fournisseur mappe les niveaux de raisonnement OpenClaw vers l’indicateur de requête de premier niveau enable_thinking de DashScope. Le raisonnement désactivé envoie enable_thinking: false ; les autres niveaux de raisonnement envoient enable_thinking: true.

Modules multimodaux complémentaires

Le Plugin qwen expose aussi des capacités multimodales sur les points de terminaison DashScope Standard (et non sur les points de terminaison Coding Plan) :
  • Compréhension vidéo via qwen-vl-max-latest
  • Génération vidéo Wan via wan2.6-t2v (par défaut), wan2.6-i2v, wan2.6-r2v, wan2.6-r2v-flash, wan2.7-r2v
Pour utiliser Qwen comme fournisseur vidéo par défaut :
{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },
    },
  },
}
Consultez Génération vidéo pour les paramètres partagés de l’outil, la sélection du fournisseur et le comportement de basculement.

Configuration avancée

Le Plugin Qwen enregistre la compréhension des médias pour les images et la vidéo sur les points de terminaison DashScope Standard (et non sur les points de terminaison Coding Plan).
PropriétéValeur
Modèleqwen-vl-max-latest
Entrée prise en chargeImages, vidéo
La compréhension des médias est résolue automatiquement à partir de l’authentification Qwen configurée : aucune configuration supplémentaire n’est nécessaire. Assurez-vous d’utiliser un point de terminaison Standard (paiement à l’utilisation) pour la prise en charge de la compréhension des médias.
qwen3.6-plus est disponible sur les points de terminaison Standard (paiement à l’utilisation) Model Studio :
  • Chine : dashscope.aliyuncs.com/compatible-mode/v1
  • Global : dashscope-intl.aliyuncs.com/compatible-mode/v1
Si les points de terminaison Coding Plan renvoient une erreur « modèle non pris en charge » pour qwen3.6-plus, passez à Standard (paiement à l’utilisation) au lieu de la paire point de terminaison/clé Coding Plan.Le catalogue statique Qwen d’OpenClaw n’annonce pas qwen3.6-plus sur les points de terminaison Coding Plan, mais les entrées qwen/qwen3.6-plus explicitement configurées sous models.providers.qwen.models sont respectées sur les baseUrls Coding Plan afin que vous puissiez activer ce modèle si Aliyun l’active sur votre abonnement. L’API amont décide toujours si l’appel réussit.
Le Plugin qwen est positionné comme l’emplacement fournisseur pour toute la surface Qwen Cloud, et pas seulement pour les modèles de codage/texte.
  • Modèles texte/chat : disponibles via le Plugin
  • Appel d’outils, sortie structurée, raisonnement : hérités du transport compatible OpenAI
  • Génération d’images : prévue au niveau du Plugin fournisseur
  • Compréhension image/vidéo : disponible via le Plugin sur le point de terminaison Standard
  • Parole/audio : prévue au niveau du Plugin fournisseur
  • Embeddings/réordonnancement mémoire : prévus via la surface d’adaptateur d’embeddings
  • Génération vidéo : disponible via le Plugin par la capacité partagée de génération vidéo
Pour la génération vidéo, OpenClaw mappe la région Qwen configurée vers l’hôte DashScope AIGC correspondant avant de soumettre la tâche :
  • Global/Intl : https://dashscope-intl.aliyuncs.com
  • Chine : https://dashscope.aliyuncs.com
Cela signifie qu’un models.providers.qwen.baseUrl normal pointant vers les hôtes Qwen Coding Plan ou Standard conserve tout de même la génération vidéo sur le bon point de terminaison vidéo DashScope régional.Limites actuelles de génération vidéo Qwen :
  • Jusqu’à 1 vidéo de sortie par requête
  • Jusqu’à 1 image d’entrée
  • Jusqu’à 4 vidéos d’entrée
  • Jusqu’à 10 secondes de durée
  • Prend en charge size, aspectRatio, resolution, audio et watermark
  • Le mode image/vidéo de référence exige actuellement des URL http(s) distantes. Les chemins de fichiers locaux sont rejetés dès le départ, car le point de terminaison vidéo DashScope n’accepte pas les tampons locaux téléversés pour ces références.
Les endpoints natifs Model Studio annoncent la compatibilité de l’utilisation en streaming sur le transport partagé openai-completions. OpenClaw s’appuie désormais sur les capacités des endpoints ; ainsi, les identifiants de fournisseurs personnalisés compatibles avec DashScope qui ciblent les mêmes hôtes natifs héritent du même comportement d’utilisation en streaming au lieu de nécessiter spécifiquement l’identifiant du fournisseur intégré qwen.La compatibilité de l’utilisation en streaming native s’applique à la fois aux hôtes Coding Plan et aux hôtes Standard compatibles avec 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
Les surfaces multimodales (compréhension vidéo et génération vidéo Wan) utilisent les endpoints DashScope Standard, et non les endpoints Coding Plan :
  • URL de base Standard mondiale/internationale : https://dashscope-intl.aliyuncs.com/compatible-mode/v1
  • URL de base Standard Chine : https://dashscope.aliyuncs.com/compatible-mode/v1
Si le Gateway s’exécute comme daemon (launchd/systemd), assurez-vous que QWEN_API_KEY est disponible pour ce processus (par exemple, dans ~/.openclaw/.env ou via env.shellEnv).

Connexe

Sélection du modèle

Choisir les fournisseurs, les références de modèle et le comportement de basculement.

Génération vidéo

Paramètres partagés de l’outil vidéo et sélection du fournisseur.

Alibaba (ModelStudio)

Ancien fournisseur ModelStudio et notes de migration.

Dépannage

Dépannage général et FAQ.