Saltar al contenido principal
Qwen Cloud es un Plugin proveedor externo oficial de OpenClaw con id canónico qwen. Está orientado a los puntos de conexión Standard y Coding Plan de Qwen Cloud / Alibaba DashScope, mantiene los ids heredados modelstudio funcionando como alias de compatibilidad y expone el flujo de token de Qwen Portal como un proveedor separado, qwen-oauth.
PropiedadValor
Proveedorqwen
Proveedor del Portalqwen-oauth
Variable de entorno preferidaQWEN_API_KEY
También aceptadas (compatibilidad)MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
Estilo de APICompatible con OpenAI
Para qwen3.6-plus, usa un punto de conexión Standard (pago por uso). No está disponible en los puntos de conexión de Coding Plan.

​
Instalar Plugin

qwen se distribuye como un Plugin externo oficial, no incluido con el núcleo. Instálalo y reinicia Gateway: 
openclaw plugins install @openclaw/qwen-provider
openclaw gateway restart

​
Primeros pasos

Elige tu tipo de plan y sigue los pasos de configuración.
Ideal para: acceso basado en suscripción mediante Qwen Coding Plan.
1

Obtén tu clave de API

Crea o copia una clave de API desde home.qwencloud.com/api-keys.
2

Ejecuta la incorporación

Para el punto de conexión Global:
openclaw onboard --auth-choice qwen-api-key
Para el punto de conexión de China:
openclaw onboard --auth-choice qwen-api-key-cn
3

Configura un modelo predeterminado

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

Verifica que el modelo esté disponible

openclaw models list --provider qwen
Los ids heredados de auth-choice modelstudio-* y las referencias de modelo modelstudio/... aún funcionan como alias de compatibilidad, pero los nuevos flujos de configuración deben preferir los ids canónicos de auth-choice qwen-* y las referencias de modelo qwen/.... Si defines una entrada personalizada exacta models.providers.modelstudio con otro valor de api, ese proveedor personalizado es propietario de las referencias modelstudio/... en lugar del alias de compatibilidad de Qwen.

​
Tipos de plan y puntos de conexión

PlanRegiónOpción de autenticaciónPunto de conexión
Coding Plan (suscripción)Chinaqwen-api-key-cncoding.dashscope.aliyuncs.com/v1
Coding Plan (suscripción)Globalqwen-api-keycoding-intl.dashscope.aliyuncs.com/v1
Qwen PortalGlobalqwen-oauthportal.qwen.ai/v1
Standard (pago por uso)Chinaqwen-standard-api-key-cndashscope.aliyuncs.com/compatible-mode/v1
Standard (pago por uso)Globalqwen-standard-api-keydashscope-intl.aliyuncs.com/compatible-mode/v1
El proveedor selecciona automáticamente el punto de conexión según tu opción de autenticación. Las opciones canónicas usan la familia qwen-*; modelstudio-* se mantiene solo por compatibilidad. Sobrescríbelo con un baseUrl personalizado en la configuración.
Administrar claves: home.qwencloud.com/api-keys | Documentación: docs.qwencloud.com

​
Catálogo integrado

OpenClaw distribuye este catálogo estático de Qwen. El catálogo tiene en cuenta el punto de conexión: las configuraciones de Coding Plan omiten modelos que solo funcionan en el punto de conexión Standard.
Referencia de modeloEntradaContextoNotas
qwen/qwen3.5-plustexto, imagen1,000,000Modelo predeterminado
qwen/qwen3.6-plustexto, imagen1,000,000Solo puntos de conexión Standard
qwen/qwen3-max-2026-01-23texto262,144Línea Qwen Max
qwen/qwen3-coder-nexttexto262,144Programación
qwen/qwen3-coder-plustexto1,000,000Programación
qwen/MiniMax-M2.5texto1,000,000Razonamiento habilitado
qwen/glm-5texto202,752GLM
qwen/glm-4.7texto202,752GLM
qwen/kimi-k2.5texto, imagen262,144Moonshot AI vía Alibaba
qwen-oauth/qwen3.5-plustexto, imagen1,000,000Predeterminado de Qwen Portal
La disponibilidad aún puede variar según el punto de conexión y el plan de facturación, incluso cuando un modelo está presente en el catálogo estático.

​
Controles de pensamiento

qwen/MiniMax-M2.5 es el único modelo con razonamiento habilitado en el catálogo integrado. Para modelos de razonamiento en la familia qwen, el proveedor asigna los niveles de pensamiento de OpenClaw al indicador de solicitud de nivel superior enable_thinking de DashScope: el pensamiento deshabilitado envía enable_thinking: false; cualquier otro nivel envía enable_thinking: true. Los modelos personalizados pueden optar por una carga útil de pensamiento alternativa de plantilla de chat configurando compat.thinkingFormat: "qwen-chat-template" en la entrada del modelo.

​
Complementos multimodales

El Plugin qwen expone capacidades multimodales solo en los puntos de conexión Standard de DashScope, no en los puntos de conexión de Coding Plan:
  • Comprensión de imágenes y video mediante qwen-vl-max-latest
  • Generación de video Wan mediante wan2.6-t2v (predeterminado), wan2.6-i2v, wan2.6-r2v, wan2.6-r2v-flash, wan2.7-r2v
La comprensión de medios se resuelve automáticamente a partir de la autenticación de Qwen configurada; no se necesita configuración adicional. Asegúrate de estar en un punto de conexión Standard (pago por uso) para que funcione la comprensión de medios. Para hacer que Qwen sea el proveedor de video predeterminado: 
{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },
    },
  },
}
Límites de generación de video: 1 video de salida por solicitud, hasta 1 imagen de entrada (imagen a video), hasta 4 videos de entrada (video a video), duración máxima de 10 segundos. Admite size, aspectRatio, resolution, audio y watermark. Las entradas de imagen/video de referencia requieren URL remotas http(s); las rutas de archivos locales se rechazan desde el inicio porque el punto de conexión de video de DashScope no acepta búferes locales cargados para esas referencias.
Consulta Generación de video para conocer los parámetros compartidos de la herramienta, la selección de proveedor y el comportamiento de conmutación por error.

​
Configuración avanzada

qwen3.6-plus está disponible en los puntos de conexión Standard (pago por uso):
  • China: dashscope.aliyuncs.com/compatible-mode/v1
  • Global: dashscope-intl.aliyuncs.com/compatible-mode/v1
Si los puntos de conexión de Coding Plan devuelven un error de “modelo no compatible” para qwen3.6-plus, cambia a Standard (pago por uso) en lugar del par de punto de conexión/clave de Coding Plan.El catálogo estático de Qwen de OpenClaw no anuncia qwen3.6-plus en los puntos de conexión de Coding Plan, pero se respeta una entrada qwen/qwen3.6-plus configurada explícitamente bajo models.providers.qwen.models en URLs base de Coding Plan, por lo que puedes optar por incluir ese modelo si Aliyun lo habilita en tu suscripción. La API upstream sigue decidiendo si la llamada se realiza correctamente.
OpenClaw asigna la región de Qwen configurada al host AIGC de DashScope correspondiente antes de enviar un trabajo de video:
  • Global/Intl: https://dashscope-intl.aliyuncs.com
  • China: https://dashscope.aliyuncs.com
Un models.providers.qwen.baseUrl normal que apunte a los hosts de Coding Plan o Standard de Qwen sigue enrutando la generación de video al punto de conexión de video regional correspondiente de DashScope.
Los puntos de conexión nativos de Qwen anuncian compatibilidad de uso en streaming en el transporte compartido openai-completions, por lo que los ids de proveedores personalizados compatibles con DashScope orientados a los mismos hosts nativos heredan el mismo comportamiento sin requerir específicamente el id del proveedor integrado qwen. Esto se aplica tanto a los puntos de conexión de Coding Plan como a los Standard:
  • 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
El Plugin qwen se está posicionando como el hogar del proveedor para toda la superficie de Qwen Cloud, no solo para modelos de programación/texto.
  • Modelos de texto/chat: disponibles a través del plugin
  • Llamadas a herramientas, salida estructurada, razonamiento: heredado del transporte compatible con OpenAI
  • Generación de imágenes: planificada en la capa de plugin de proveedor
  • Comprensión de imágenes/video: disponible a través del plugin en el endpoint Standard
  • Voz/audio: planificado en la capa de plugin de proveedor
  • Embeddings/reranking de memoria: planificado a través de la superficie del adaptador de embeddings
  • Generación de video: disponible a través del plugin mediante la capacidad compartida de generación de video
Si el Gateway se ejecuta como daemon (launchd/systemd), asegúrate de que QWEN_API_KEY esté disponible para ese proceso (por ejemplo, en ~/.openclaw/.env o mediante env.shellEnv).

​
Relacionado

Selección de modelo

Elegir proveedores, referencias de modelo y comportamiento de conmutación por error.

Generación de video

Parámetros de la herramienta de video compartida y selección de proveedor.

Alibaba Model Studio

Proveedor incluido de generación de video Wan en la misma plataforma DashScope.

Solución de problemas

Solución de problemas general y preguntas frecuentes.