Providers
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, gestiona de forma independiente el id de proveedor personalizado documentado por Alibaba bailian-token-plan y expone el flujo de tokens de Qwen Portal como qwen-oauth.
| Propiedad | Valor |
|---|---|
| Proveedor | qwen |
| Proveedor de Token Plan | qwen-token-plan |
| Proveedor de Portal | qwen-oauth |
| Variable de entorno preferida | QWEN_API_KEY |
| Variable de entorno de Token Plan | QWEN_TOKEN_PLAN_API_KEY |
| También aceptadas (compatibilidad) | MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY |
| Estilo de API | Compatible con OpenAI |
Instalar el plugin
qwen se distribuye como plugin externo oficial y no viene incluido con el núcleo. Instálalo y reinicia el Gateway:
openclaw plugins install @openclaw/qwen-provideropenclaw gateway restartPrimeros pasos
Elige el tipo de plan y sigue los pasos de configuración.
Coding Plan (suscripción)
Recomendado para: acceso mediante suscripción a través de Qwen Coding Plan.
Obtener tu 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-keyPara el endpoint de China:
openclaw onboard --auth-choice qwen-api-key-cnEstablecer un modelo predeterminado
{ agents: { defaults: { model: { primary: "qwen/qwen3.5-plus" }, }, },}Comprobar que el modelo esté disponible
openclaw models list --provider qwenStandard (pago por uso)
Recomendado 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 tu 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-keyPara el endpoint de China:
openclaw onboard --auth-choice qwen-standard-api-key-cnEstablecer un modelo predeterminado
{ agents: { defaults: { model: { primary: "qwen/qwen3.5-plus" }, }, },}Comprobar que el modelo esté disponible
openclaw models list --provider qwenToken Plan (edición para equipos)
Recomendado para: acceso mediante 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 tu clave dedicada
Asigna una plaza de Token Plan y crea su clave dedicada sk-sp-.... Las claves de Token Plan, Coding Plan y pago por uso no son intercambiables. Consulta la descripción general de Token Plan 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-planPara el endpoint de China en Pekín:
openclaw onboard --auth-choice qwen-token-plan-cnComprobar el proveedor
openclaw models list --provider qwen-token-planopenclaw agent --model qwen-token-plan/qwen3.7-plus --message "Reply with: token plan ready"Qwen OAuth / Portal
Recomendado para: un token de Qwen Portal para https://portal.qwen.ai/v1.
Consulta Qwen OAuth / Portal para ver la página dedicada al proveedor y las notas de migración.
Proporcionar tu token de Portal
openclaw onboard --auth-choice qwen-oauthEstablecer un modelo predeterminado
{ agents: { defaults: { model: { primary: "qwen-oauth/qwen3.5-plus" }, }, },}Comprobar que el modelo esté disponible
openclaw models list --provider qwen-oauthTipos de planes y endpoints
| Plan | Región | Opció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 |
| Qwen Portal | Global | qwen-oauth |
portal.qwen.ai/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.dashscope.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 tu opción de autenticación. Las opciones
canónicas usan la familia qwen-*; modelstudio-* se mantiene solo por compatibilidad.
Puedes reemplazarlo con un baseUrl personalizado en la configuración.
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 |
qwen-oauth/qwen3.5-plus |
texto, imagen | 1,000,000 | Valor predeterminado de Qwen Portal |
Catálogo de Token Plan
Token Plan usa una lista de permitidos independiente basada en coincidencias exactas de cadenas. Los modelos del plan exclusivos para generación de 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 pensamiento de OpenClaw
al indicador de solicitud de nivel superior enable_thinking de DashScope: con el
pensamiento deshabilitado se envía enable_thinking: false, y con cualquier otro
nivel se envía enable_thinking: true. Los modelos personalizados pueden optar por
una carga útil de pensamiento alternativa 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 compatibles con el razonamiento.
kimi-k2.7-code y MiniMax-M2.5 solo funcionan con el pensamiento activado, por lo
que OpenClaw lo mantiene 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
Estándar de DashScope, no en los endpoints de Coding Plan:
- Comprensión de imágenes y vídeos mediante
qwen-vl-max-latest - Generación de vídeo 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úrese de utilizar un endpoint Estándar (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 (imagen a vídeo), hasta 4 vídeos de entrada (vídeo a vídeo) y una 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.
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 Estándar. qwen3.7-max y qwen3.6-flash solo están disponibles en Estándar. Los endpoints Estándar (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 Estándar y a la clave correspondientes.
Enrutamiento regional de la generación de vídeo
OpenClaw asigna la región de Qwen configurada al host 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 valor normal de models.providers.qwen.baseUrl que apunte a los hosts de
Coding Plan o Estándar de Qwen 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 con el 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 del proveedor
integrado qwen. Esto se aplica a los endpoints de Coding Plan, Estándar y Token Plan:
https://coding.dashscope.aliyuncs.com/v1https://coding-intl.dashscope.aliyuncs.com/v1https://dashscope.aliyuncs.com/compatible-mode/v1https://dashscope-intl.aliyuncs.com/compatible-mode/v1https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
Plan de capacidades
El Plugin qwen se está posicionando como el punto de referencia del proveedor para
toda la oferta 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 pensamiento: heredados del transporte compatible con OpenAI
- Generación de imágenes: planificada en la capa del Plugin del proveedor
- Comprensión de imágenes y vídeos: disponible mediante el Plugin en el endpoint Estándar
- Voz/audio: planificados en la capa del Plugin del proveedor
- Embeddings/reordenación de memoria: planificados mediante la interfaz 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 demonio
Si el Gateway se ejecuta como demonio (launchd/systemd), asegúrese de que
QWEN_API_KEY o QWEN_TOKEN_PLAN_API_KEY estén disponibles para ese proceso
(por ejemplo, en ~/.openclaw/.env o mediante env.shellEnv).
Contenido relacionado
Elección de proveedores, referencias de modelos y comportamiento de conmutación por error.
Parámetros compartidos de la herramienta de vídeo y selección de proveedores.
Proveedor integrado de generación de vídeo Wan en la misma plataforma DashScope.
Solución de problemas generales y preguntas frecuentes.