Qwen

Qwen Cloud es un plugin proveedor externo oficial de OpenClaw con el id canónico qwen. Está destinado a los endpoints Standard y Coding Plan de Qwen Cloud / Alibaba DashScope, expone Token Plan como qwen-token-plan, mantiene modelstudio como alias de compatibilidad y posee de forma independiente el id de proveedor personalizado bailian-token-plan documentado por Alibaba.

Propiedad	Valor
Proveedor	`qwen`
Proveedor de Token Plan	`qwen-token-plan`
Variable de entorno preferida	`QWEN_API_KEY`
Variable de entorno de Token Plan	`QWEN_TOKEN_PLAN_API_KEY`
También se aceptan (compatibilidad)	`MODELSTUDIO_API_KEY`, `DASHSCOPE_API_KEY`
Estilo de API	Compatible con OpenAI

qwen3.7-plus y qwen3.6-plus funcionan con los endpoints Coding Plan y Standard. Para qwen3.7-max o qwen3.6-flash, usa un endpoint Standard (pago por uso).

Instalar el plugin

qwen se distribuye como plugin externo oficial y no está incluido en el núcleo. Instálalo y reinicia el Gateway:

openclaw plugins install @openclaw/qwen-provider
openclaw gateway restart

Primeros pasos

Elige el tipo de plan y sigue los pasos de configuración.

Coding Plan (suscripción)
Standard (pago por uso)
Token Plan (edición para equipos)

Ideal para: acceso mediante suscripción a través de Qwen Coding Plan.

Obtener la clave de API

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

Ejecutar la incorporación

Para el endpoint Global:

openclaw onboard --auth-choice qwen-api-key

Para el endpoint China:

openclaw onboard --auth-choice qwen-api-key-cn

Establecer un modelo predeterminado

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

Verificar que el modelo esté disponible

openclaw models list --provider qwen

Los ids heredados de selección de autenticación modelstudio-* y las referencias de modelo modelstudio/... siguen funcionando como alias de compatibilidad, pero los nuevos flujos de configuración deben preferir los ids canónicos de selección de autenticación qwen-* y las referencias de modelo qwen/.... Si defines una entrada personalizada models.providers.modelstudio exacta con otro valor de api, ese proveedor personalizado es el propietario de las referencias modelstudio/... en lugar del alias de compatibilidad de Qwen.

Ideal para: acceso de pago por uso mediante el endpoint Standard de Model Studio, incluidos qwen3.7-max y qwen3.6-flash, que no están disponibles en Coding Plan.

Obtener la clave de API

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

Ejecutar la incorporación

Para el endpoint Global:

openclaw onboard --auth-choice qwen-standard-api-key

Para el endpoint China:

openclaw onboard --auth-choice qwen-standard-api-key-cn

Establecer un modelo predeterminado

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

Verificar que el modelo esté disponible

openclaw models list --provider qwen

Ideal para: acceso mediante una suscripción de equipo basada en créditos a Qwen y a modelos de terceros compatibles a través de Alibaba Cloud Model Studio.

Obtener la clave dedicada

Asigna una plaza de Token Plan y crea su clave sk-sp-... dedicada. Las claves de Token Plan, Coding Plan y pago por uso no son intercambiables. Consulta la descripción general de Token Plan para Global o la descripción general de Token Plan para China.

Ejecutar la incorporación

Para el endpoint Global / Internacional en Singapur:

openclaw onboard --auth-choice qwen-token-plan

Para el endpoint China en Pekín:

openclaw onboard --auth-choice qwen-token-plan-cn

Verificar el proveedor

openclaw models list --provider qwen-token-plan
openclaw agent --model qwen-token-plan/qwen3.7-plus --message "Responde con: token plan listo"

La guía de OpenClaw de Alibaba usa bailian-token-plan para un proveedor personalizado manual. El plugin registra ese id como propietario de compatibilidad, pero las nuevas configuraciones deben usar qwen-token-plan. Una entrada personalizada models.providers.bailian-token-plan exacta conserva la propiedad de su transporte y catálogo configurados; nunca se combina con el catálogo canónico de OpenAI.

Usa Token Plan únicamente para sesiones interactivas de OpenClaw. No lo selecciones para trabajos de cron, scripts desatendidos ni backends de aplicaciones. Alibaba indica que el uso no interactivo puede suspender la suscripción o revocar su clave de API.

Tipos de planes y endpoints

Plan	Región	Selección de autenticación	Endpoint
Coding Plan (suscripción)	China	`qwen-api-key-cn`	`coding.dashscope.aliyuncs.com/v1`
Coding Plan (suscripción)	Global	`qwen-api-key`	`coding-intl.dashscope.aliyuncs.com/v1`
Standard (pago por uso)	China	`qwen-standard-api-key-cn`	`dashscope.aliyuncs.com/compatible-mode/v1`
Standard (pago por uso)	Global	`qwen-standard-api-key`	`dashscope-intl.aliyuncs.com/compatible-mode/v1`
Token Plan (edición para equipos)	China	`qwen-token-plan-cn`	`token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1`
Token Plan (edición para equipos)	Global	`qwen-token-plan`	`token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`

El proveedor selecciona automáticamente el endpoint según la selección de autenticación. Las selecciones canónicas usan la familia qwen-*; modelstudio-* se mantiene únicamente por compatibilidad. Sustitúyelo mediante un baseUrl personalizado en la configuración.

Administrar claves: home.qwencloud.com/api-keys | Documentación: docs.qwencloud.com

Catálogo integrado

OpenClaw incluye este catálogo estático de Qwen. El catálogo tiene en cuenta el endpoint: las configuraciones de Coding Plan omiten los modelos que solo funcionan en el endpoint Standard.

Referencia del modelo	Entrada	Contexto	Notas
`qwen/qwen3.5-plus`	texto, imagen	1,000,000	Modelo predeterminado
`qwen/qwen3.6-flash`	texto, imagen	1,000,000	Solo endpoints Standard
`qwen/qwen3.6-plus`	texto, imagen	1,000,000	Coding Plan + Standard
`qwen/qwen3.7-max`	texto	1,000,000	Solo endpoints Standard
`qwen/qwen3.7-plus`	texto, imagen	1,000,000	Coding Plan + Standard
`qwen/qwen3-max-2026-01-23`	texto	262,144	Línea Qwen Max
`qwen/qwen3-coder-next`	texto	262,144	Programación
`qwen/qwen3-coder-plus`	texto	1,000,000	Programación
`qwen/MiniMax-M2.5`	texto	1,000,000	Razonamiento habilitado
`qwen/glm-5`	texto	202,752	GLM
`qwen/glm-4.7`	texto	202,752	GLM
`qwen/kimi-k2.5`	texto, imagen	262,144	Moonshot AI mediante Alibaba

La disponibilidad puede variar según el endpoint y el plan de facturación, incluso cuando un modelo figure en el catálogo estático.

Catálogo de Token Plan

Token Plan usa una lista de permitidos independiente con coincidencia exacta de cadenas. Los modelos del plan destinados únicamente a generar imágenes no se incluyen aquí porque usan API diferentes.

Referencia del modelo	Entrada	Contexto
`qwen-token-plan/qwen3.7-max`	texto	1,000,000
`qwen-token-plan/qwen3.7-plus`	texto, imagen	1,000,000
`qwen-token-plan/qwen3.6-plus`	texto, imagen	1,000,000
`qwen-token-plan/qwen3.6-flash`	texto, imagen	1,000,000
`qwen-token-plan/deepseek-v4-pro`	texto	1,000,000
`qwen-token-plan/deepseek-v4-flash`	texto	1,000,000
`qwen-token-plan/deepseek-v3.2`	texto	131,072
`qwen-token-plan/kimi-k2.7-code`	texto, imagen	262,144
`qwen-token-plan/kimi-k2.6`	texto, imagen	262,144
`qwen-token-plan/kimi-k2.5`	texto, imagen	262,144
`qwen-token-plan/glm-5.2`	texto	1,000,000
`qwen-token-plan/glm-5.1`	texto	202,752
`qwen-token-plan/glm-5`	texto	202,752
`qwen-token-plan/MiniMax-M2.5`	texto	196,608

Controles de razonamiento

qwen3.7-max, qwen3.7-plus, qwen3.6-flash y qwen3.6-plus tienen el razonamiento habilitado en el catálogo integrado. Para los modelos de razonamiento de la familia qwen, el proveedor asigna los niveles de razonamiento de OpenClaw al indicador de solicitud enable_thinking de nivel superior de DashScope: con el razonamiento deshabilitado se envía enable_thinking: false; con cualquier otro nivel se envía enable_thinking: true. Los modelos personalizados pueden optar por una carga útil alternativa de razonamiento para la plantilla de chat estableciendo compat.thinkingFormat: "qwen-chat-template" en la entrada del modelo. Los modelos de Token Plan también están marcados como capaces de razonar. kimi-k2.7-code y MiniMax-M2.5 son exclusivamente de razonamiento, por lo que OpenClaw mantiene el razonamiento habilitado incluso cuando la sesión solicita /think off. DeepSeek V4 asigna desde minimal hasta high al esfuerzo high del servicio y asigna xhigh o max a max. GLM 5.2 acepta todo el intervalo desde minimal hasta max; GLM 5.1 y GLM 5 aceptan hasta xhigh, y los tres usan high de forma predeterminada. Los demás modelos híbridos siguen el estado de activación o desactivación solicitado.

Complementos multimodales

El plugin qwen ofrece capacidades multimodales únicamente en los endpoints Standard de DashScope, no en los endpoints Coding Plan:

Comprensión de imágenes y vídeos mediante qwen3.6-plus
Generación de vídeos con Wan mediante wan2.6-t2v (predeterminado), wan2.6-i2v, wan2.6-r2v, wan2.6-r2v-flash, wan2.7-r2v

La comprensión de contenido multimedia se resuelve automáticamente a partir de la autenticación de Qwen configurada; no se necesita ninguna configuración adicional. Asegúrate de usar un endpoint Standard (pago por uso) para que funcione la comprensión de contenido multimedia. Para establecer Qwen como proveedor de vídeo predeterminado:

{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },
    },
  },
}

Límites de generación de vídeo: 1 vídeo de salida por solicitud, hasta 1 imagen de entrada (de imagen a vídeo), hasta 4 vídeos de entrada (de vídeo a vídeo), duración máxima de 10 segundos. Admite size, aspectRatio, resolution, audio y watermark. Las entradas de imagen o vídeo de referencia requieren URL http(s) remotas; las rutas de archivos locales se rechazan de antemano porque el endpoint de vídeo de DashScope no acepta búferes locales cargados para esas referencias.

Consulte Generación de vídeo 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

Disponibilidad de Qwen 3.6 y 3.7

qwen3.7-plus y qwen3.6-plus están disponibles en los endpoints de Coding Plan y Standard. qwen3.7-max y qwen3.6-flash solo están disponibles en Standard. Los endpoints Standard (pago por uso) son:

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

OpenClaw omite qwen3.7-max y qwen3.6-flash de los catálogos de Coding Plan. Si un endpoint de Coding Plan devuelve un error de «modelo no compatible» para cualquiera de ellos, cambie al endpoint y la clave Standard correspondientes.

Enrutamiento regional de la generación de vídeo

OpenClaw asigna la región de Qwen configurada al host de AIGC de DashScope correspondiente antes de enviar un trabajo de vídeo:

Global/Internacional: https://dashscope-intl.aliyuncs.com
China: https://dashscope.aliyuncs.com

Un models.providers.qwen.baseUrl normal que apunte a los hosts de Qwen de Coding Plan o Standard sigue enrutando la generación de vídeo al endpoint regional de vídeo de DashScope correspondiente.

Compatibilidad del uso en streaming

Los endpoints nativos de Qwen anuncian compatibilidad del uso en streaming en el transporte compartido openai-completions, por lo que los identificadores de proveedores personalizados compatibles con DashScope que apunten a los mismos hosts nativos heredan el mismo comportamiento sin requerir específicamente el identificador de proveedor integrado qwen. Esto se aplica a los endpoints de Coding Plan, Standard y Token Plan:

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
https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1

Plan de capacidades

El plugin qwen se está posicionando como la sede del proveedor para toda la superficie de Qwen Cloud, no solo para los modelos de programación y texto.

Modelos de texto/chat: disponibles mediante el plugin
Llamadas a herramientas, salida estructurada y razonamiento: heredados del transporte compatible con OpenAI
Generación de imágenes: prevista en la capa del plugin de proveedor
Comprensión de imágenes/vídeos: disponible mediante el plugin en el endpoint Standard
Voz/audio: previsto en la capa del plugin de proveedor
Embeddings/reordenación de memoria: previstos mediante la superficie del adaptador de embeddings
Generación de vídeo: disponible mediante el plugin a través de la capacidad compartida de generación de vídeo

Configuración del entorno y del daemon

Si el Gateway se ejecuta como daemon (launchd/systemd), asegúrese de que QWEN_API_KEY o QWEN_TOKEN_PLAN_API_KEY esté disponible para ese proceso (por ejemplo, en ~/.openclaw/.env o mediante env.shellEnv).

Contenido relacionado

Selección de modelos

Selección de proveedores, referencias de modelos y comportamiento de conmutación por error.

Generación de vídeo

Parámetros compartidos de la herramienta de vídeo y selección de proveedor.

Alibaba Model Studio

Proveedor integrado de generación de vídeo Wan en la misma plataforma DashScope.

Solución de problemas

Solución general de problemas y preguntas frecuentes.

Overview

Concepts and configuration

Providers

Instalar el plugin

Primeros pasos

Tipos de planes y endpoints

Catálogo integrado

Catálogo de Token Plan

Controles de razonamiento

Complementos multimodales

Configuración avanzada

Contenido relacionado

Selección de modelos

Generación de vídeo

Alibaba Model Studio

Solución de problemas

​Instalar el plugin

​Primeros pasos

​Tipos de planes y endpoints

​Catálogo integrado

​Catálogo de Token Plan

​Controles de razonamiento

​Complementos multimodales

​Configuración avanzada

​Contenido relacionado

Selección de modelos

Generación de vídeo

Alibaba Model Studio

Solución de problemas

Instalar el plugin

Primeros pasos

Tipos de planes y endpoints

Catálogo integrado

Catálogo de Token Plan

Controles de razonamiento

Complementos multimodales

Configuración avanzada

Contenido relacionado