Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Qwen OAuth a été supprimé. L’intégration OAuth gratuite (qwen-portal) qui utilisait les points de terminaison portal.qwen.ai n’est plus disponible. Consultez Issue #49557 pour le contexte.
OpenClaw traite désormais Qwen comme un fournisseur intégré de premier plan avec l’identifiant canonique qwen. Le fournisseur intégré cible les points de terminaison Qwen Cloud / Alibaba DashScope et Coding Plan, et maintient les anciens identifiants modelstudio comme alias de compatibilité.
  • Fournisseur : qwen
  • 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’usage). La prise en charge de Coding Plan peut être en retard par rapport au catalogue public.

Premiers pas

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

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 de choix d’authentification modelstudio-* et les références de modèles modelstudio/... fonctionnent encore comme alias de compatibilité, mais les nouveaux flux de configuration devraient préférer les identifiants de choix d’authentification canoniques qwen-* et les références de modèles qwen/.... Si vous définissez une entrée models.providers.modelstudio personnalisée exacte 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 plans et points de terminaison

PlanRégionChoix d’authentificationPoint de terminaison
Standard (paiement à l’usage)Chineqwen-standard-api-key-cndashscope.aliyuncs.com/compatible-mode/v1
Standard (paiement à l’usage)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
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 réservé à la compatibilité. Vous pouvez remplacer ce comportement avec un baseUrl personnalisé dans la configuration.

Catalogue intégré

OpenClaw fournit actuellement ce catalogue Qwen intégré. Le catalogue configuré est adapté au point de terminaison : les configurations Coding Plan omettent les modèles connus pour fonctionner uniquement sur le point de terminaison Standard.
Référence de modèleEntréeContexteRemarques
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
La disponibilité peut encore varier selon le point de terminaison et le plan de facturation, même lorsqu’un modèle est présent dans le catalogue intégré.

Contrôles de réflexion

Pour les modèles Qwen Cloud avec raisonnement activé, le fournisseur intégré mappe les niveaux de réflexion OpenClaw au drapeau de requête de premier niveau enable_thinking de DashScope. Une réflexion désactivée envoie enable_thinking: false ; les autres niveaux de réflexion envoient enable_thinking: true.

Modules complémentaires multimodaux

Le Plugin qwen expose également des capacités multimodales sur les points de terminaison DashScope Standard (pas 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 d’outil partagés, la sélection du fournisseur et le comportement de basculement.

Configuration avancée

Le Plugin Qwen intégré enregistre la compréhension des médias pour les images et la vidéo sur les points de terminaison DashScope Standard (pas 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’usage) 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’usage) 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’usage) au lieu de la paire point de terminaison/clé Coding Plan.Le catalogue Qwen intégré 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 en amont décide toujours si l’appel réussit.
Le Plugin qwen est positionné comme l’emplacement fournisseur pour toute la surface Qwen Cloud, pas seulement pour les modèles de codage/texte.
  • Modèles texte/chat : 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évue au niveau du Plugin de fournisseur
  • Compréhension d’images/vidéos : intégrée maintenant sur le point de terminaison Standard
  • Parole/audio : prévu au niveau du Plugin de fournisseur
  • Embeddings/réordonnancement de mémoire : prévus via la surface d’adaptateur d’embeddings
  • Génération vidéo : intégrée maintenant via 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 à 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 Coding Plan ou Standard Qwen maintient quand 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 intégrées :
  • 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 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éversés pour ces références.
Les points de terminaison Model Studio natifs annoncent la compatibilité d’utilisation en streaming sur le transport partagé openai-completions. OpenClaw l’indexe désormais sur les capacités des points de terminaison, de sorte que les identifiants de fournisseurs 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é d’utilisation en streaming natif s’applique à la fois aux hôtes Coding Plan et 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
Les surfaces multimodales (compréhension vidéo et génération vidéo Wan) utilisent les points de terminaison DashScope Standard, pas 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
Si le Gateway s’exécute comme un démon (launchd/systemd), assurez-vous que QWEN_API_KEY est disponible pour ce processus (par exemple, dans ~/.openclaw/.env ou via env.shellEnv).

Articles associés

Sélection du modèle

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

Génération de vidéos

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.