Aller au contenu

Qwen

OpenClaw considère désormais Qwen comme un fournisseur intégré de premier plan avec l’ID canonique qwen. Le fournisseur intégré cible les points de terminaison Qwen Cloud / Alibaba DashScope et Coding Plan et maintient les anciens ID modelstudio fonctionnels comme un alias de compatibilité.

  • Fournisseur : qwen
  • Variable d’environnement préférée : QWEN_API_KEY
  • Également accepté pour la compatibilité : MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
  • Style d’API : compatible OpenAI

Choisissez votre type de plan et suivez les étapes de configuration.

Idéal pour : l’accès par abonnement via le Qwen Coding Plan.

  1. APIObtenez votre clé API

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

  2. Exécutez l'intégration

    Pour le point de terminaison Global :

    Fenêtre de terminal
    openclaw onboard --auth-choice qwen-api-key

    Pour le point de terminaison China :

    Fenêtre de terminal
    openclaw onboard --auth-choice qwen-api-key-cn
  3. Définir un model par défaut

    {
    agents: {
    defaults: {
    model: { primary: "qwen/qwen3.5-plus" },
    },
    },
    }
  4. Vérifiez que le model est disponible

    Fenêtre de terminal
    openclaw models list --provider qwen
PlanRégionChoix d’authentificationPoint de terminaison
Standard (pay-as-you-go)Chineqwen-standard-api-key-cndashscope.aliyuncs.com/compatible-mode/v1
Standard (pay-as-you-go)Mondeqwen-standard-api-keydashscope-intl.aliyuncs.com/compatible-mode/v1
Coding Plan (abonnement)Chineqwen-api-key-cncoding.dashscope.aliyuncs.com/v1
Coding Plan (abonnement)Mondeqwen-api-keycoding-intl.dashscope.aliyuncs.com/v1

Le fournisseur sélectionne automatiquement le point de terminaison en fonction de votre choix d’authentification. Les choix canoniques utilisent la famille qwen-* ; modelstudio-* reste uniquement pour la compatibilité. Vous pouvez remplacer cela par un baseUrl personnalisé dans la configuration.

OpenClaw inclut actuellement ce catalogue Qwen intégré. Le catalogue configuré est conscient du point de terminaison (endpoint-aware) : les configurations du Coding Plan omettent les modèles qui sont connus pour ne fonctionner que sur le point de terminaison Standard.

Réf 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

Pour les modèles Cloud Qwen avec raisonnement activé, le fournisseur intégré mappe les niveaux de réflexion de OpenClaw sur l’indicateur de requête de niveau supérieur enable_thinking de DashScope. La réflexion désactivée envoie enable_thinking: false ; les autres niveaux de réflexion envoient enable_thinking: true.

Le plugin qwen expose également les capacités multimodales sur les points de terminaison DashScope Standard (pas sur les points de terminaison du 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" },
},
},
}

Compréhension d'images et de vidéos

Le plugin Qwen intégré enregistre la compréhension de média pour les images et les vidéos sur les points de terminaison DashScope Standard (pas les points de terminaison du Coding Plan).

PropriétéValeur
Modèleqwen-vl-max-latest
Entrée prise en chargeImages, vidéo

La compréhension de média 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 (pay-as-you-go) pour bénéficier de la prise en charge de la compréhension de média.

Disponibilité de Qwen 3.6 Plus

qwen3.6-plus est disponible sur les points de terminaison Standard (pay-as-you-go) du Model Studio :

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

Si les points de terminaison du Coding Plan renvoient une erreur « model non pris en charge » pour qwen3.6-plus, passez à Standard (pay-as-you-go) au lieu de la paire point de terminaison/clé du Coding Plan.

Le catalogue intégré OpenClaw de Qwen n’annonce pas qwen3.6-plus sur les points de terminaison du Coding Plan, mais les entrées qwen/qwen3.6-plus explicitement configurées sous models.providers.qwen.models sont honorées sur les baseUrl du Coding Plan, vous pouvez donc activer ce model si Aliyun l’active pour votre abonnement. L’API en amont décide toujours si l’appel aboutit.

Plan de fonctionnalités

Le plugin qwen est positionné comme la base du fournisseur pour l’ensemble de la surface Qwen Cloud, et pas seulement pour les modèles de codage/texte.

  • Modèles de texte/discussion : intégrés maintenant
  • Appel d’outils, sortie structurée, réflexion : hérités du transport compatible OpenAI
  • Génération d’images : prévu au niveau du plugin de fournisseur
  • Compréhension d’images/vidéos : intégré maintenant sur le point de terminaison Standard
  • Synthèse vocale/audio : prévu au niveau du plugin de fournisseur
  • Embeddings de mémoire/reranking : prévus via la surface de l’adaptateur d’embeddings
  • Génération de vidéos : intégrée maintenant via la capacité de génération de vidéos partagée
Détails de la génération vidéo

Pour la génération vidéo, OpenClaw mappe la région Qwen configurée sur l’hôte AIGC DashScope 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 du Coding Plan ou les hôtes standards Qwen maintient toujours la génération vidéo sur le point de terminaison vidéo DashScope régional correct.

Limites actuelles de la génération vidéo pour le Qwen intégré :

  • Jusqu’à 1 vidéo de sortie par requête
  • Jusqu’à 1 image d’entrée
  • Jusqu’à 4 vidéos d’entrée
  • Durée maximale de 10 secondes
  • Prend en charge size, aspectRatio, resolution, audio et watermark
  • Le mode image/vidéo de référence nécessite actuellement des URL http(s) distantes. Les chemins de fichiers locaux sont rejetés immédiatement car le point de terminaison vidéo DashScope n’accepte pas les tampons locaux téléchargés pour ces références.
Compatibilité de l'utilisation en streaming

Les points de terminaison natifs de Model Studio annoncent une compatibilité de l’utilisation en streaming sur le transport partagé openai-completions. Les clés OpenClaw désactivent désormais les capacités du point de terminaison, donc les identifiants de fournisseur personnalisés compatibles DashScope ciblant les mêmes hôtes natifs héritent du même comportement d’utilisation en streaming au lieu d’exiger spécifiquement l’identifiant de fournisseur intégré qwen.

La compatibilité de l’utilisation en streaming natif s’applique à la fois aux hôtes du Coding Plan et aux hôtes compatibles Standard 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
Régions de point de terminaison multimodales

Les surfaces multimodales (compréhension vidéo et génération vidéo Wan) utilisent les points de terminaison Standard DashScope, et non les points de terminaison Coding Plan :

  • URL de base Standard internationale : https://dashscope-intl.aliyuncs.com/compatible-mode/v1
  • URL de base Standard Chine : https://dashscope.aliyuncs.com/compatible-mode/v1
Configuration de l'environnement et du démon

Si le Gateway s’exécute en tant que démon (launchd/systemd), assurez-vous que QWEN_API_KEY est disponible pour ce processus (par exemple, dans ~/.openclaw/.env ou via env.shellEnv).

Sélection du modèle

Choix des providers, références de modèle et comportement de basculement.

Génération vidéo

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

Alibaba (ModelStudio)

Provider ModelStudio hérité et notes de migration.

Dépannage

Dépannage général et FAQ.