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 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

Instalar el plugin

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

bash
openclaw plugins install @openclaw/qwen-provideropenclaw gateway restart

Primeros pasos

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

Coding Plan (suscripción)

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:

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

    Para el endpoint China:

    bash
    openclaw onboard --auth-choice qwen-api-key-cn
  • Establecer un modelo predeterminado

    json5
    {  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}
  • Verificar que el modelo esté disponible

    bash
    openclaw models list --provider qwen
  • Standard (pago por uso)

    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:

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

    Para el endpoint China:

    bash
    openclaw onboard --auth-choice qwen-standard-api-key-cn
  • Establecer un modelo predeterminado

    json5
    {  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}
  • Verificar que el modelo esté disponible

    bash
    openclaw models list --provider qwen
  • Token Plan (edición para equipos)

    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:

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

    Para el endpoint China en Pekín:

    bash
    openclaw onboard --auth-choice qwen-token-plan-cn
  • Verificar el proveedor

    bash
    openclaw models list --provider qwen-token-planopenclaw agent --model qwen-token-plan/qwen3.7-plus --message "Responde con: token plan listo"
  • 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.

    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

    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:

    json5
    {  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.

    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

    Was this useful?
    On this page

    On this page