Aller au contenu

QwenQwen

OpenClaw traite désormais Qwen comme un provider intégré de premier plan avec l’ID canonique OpenClawQwenqwenQwen. Le provider intégré cible les points de terminaison Qwen Cloud / Alibaba DashScope et Coding Plan, maintient les IDs modelstudioQwen hérités fonctionnant comme un alias de compatibilité, et expose également le flux de jetons Qwen Portal en tant que provider qwen-oauth.

  • Provider : qwen
  • Provider Portal : qwen-oauth
  • Env var 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 : un accès par abonnement via le plan de codage Qwen.

  1. APIObtenez votre clé d'API

    Créez ou copiez une clé d’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 Chine :

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

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

    Fenêtre de terminal
    openclaw models list --provider qwen
ForfaitRégionChoix d’authPoint de terminaison
Standard (paiement à l’utilisation)Chineqwen-standard-api-key-cndashscope.aliyuncs.com/compatible-mode/v1
Standard (paiement à l’utilisation)Mondialqwen-standard-api-keydashscope-intl.aliyuncs.com/compatible-mode/v1
Forfait Coding (abonnement)Chineqwen-api-key-cncoding.dashscope.aliyuncs.com/v1
Forfait Coding (abonnement)Mondialqwen-api-keycoding-intl.dashscope.aliyuncs.com/v1
Portail QwenMondialqwen-oauthportal.qwen.ai/v1

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

OpenClaw fournit actuellement ce catalogue Qwen intégré. Le catalogue configuré est conscient du point de terminaison : les configurations de Coding Plan omettent les modèles connus pour fonctionner uniquement sur le point de terminaison Standard.

Réf modèleEntréeContexteRemarques
qwen/qwen3.5-plustexte, image1 000 000Modèle par défaut
qwen/qwen3.6-plustexte, image1 000 000Privilégiez les points de terminaison Standard lorsque vous avez besoin de ce modèle
qwen/qwen3-max-2026-01-23texte262 144Ligne 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 000Défaut Portail Qwen

Pour les modèles Qwen Cloud avec raisonnement activé, le fournisseur intégré mappe les niveaux de réflexion OpenClaw à 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 des capacités multimodales sur les points de terminaison DashScope Standard (pas 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" },
},
},
}

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 (et non sur les points de terminaison Coding Plan).

PropriétéValeur
Modèleqwen-vl-max-latestQwen
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 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 Model Studio Standard (pay-as-you-go) :

  • 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 (pay-as-you-go) au lieu du point de terminaison Coding Plan / paire de clés.

Le catalogue OpenClaw intégré d’Qwen 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 honorées sur les baseUrl Coding Plan afin que vous puissiez activer ce modèle si Aliyun l’active sur votre abonnement. L’API en amont décide toujours si l’appel aboutit.

Plan de capacité

Le plugin qwen est positionné comme la page d’accueil 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 : regroupé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 de la couche du fournisseur-plugin
  • Compréhension d’images/vidéos : regroupé maintenant sur le point de terminaison Standard
  • Discours/audio : prévu au niveau de la couche du fournisseur-plugin
  • Memory embeddings/reranking : prévu via la surface de l’adaptateur d’embeddings
  • Génération de vidéos : regroupé maintenant via la capacité partagée de génération de vidéos
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 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 maintient toujours la génération vidéo sur le bon point de terminaison vidéo DashScope régional.

Limites actuelles de la génération vidéo Qwen regroupée :

  • Jusqu’à 1 vidéo de sortie par demande
  • 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 de référence image/vidéo nécessite 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échargés pour ces références.
Compatibilité de l'utilisation en streaming

Les points de terminaison natifs de Model Studio annoncent la compatibilité de l’utilisation en streaming sur le transport partagé openai-completionsOpenClaw. Les clés OpenClaw qui désactivent les capacités des points de terminaison maintenant, donc les ids 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 de nécessiter spécifiquement l’ID de fournisseur intégré qwen.

La compatibilité de l’utilisation en streaming natif s’applique aux hôtes Coding Plan ainsi qu’aux hôtes Standard compatibles 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 des points de terminaison multimodaux

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

  • URL de base Standard Global/Intl : 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 la 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 de modèle

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

Génération vidéo

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

Alibaba (ModelStudio)

Fournisseur ModelStudio hérité et notes de migration.

Troubleshooting

Dépannage général et FAQ.