---
read_when:
    - Desea usar Qwen con OpenClaw
    - Anteriormente usaste Qwen OAuth
summary: Usa Qwen Cloud mediante el proveedor qwen incluido con OpenClaw
title: Qwen
x-i18n:
    generated_at: "2026-04-30T05:58:48Z"
    model: gpt-5.5
    provider: openai
    source_hash: 898a7ef1f071c838f3bd877632dd06cf0e6112adfa2833895280f99642df56e6
    source_path: providers/qwen.md
    workflow: 16
---

<Warning>

**Qwen OAuth se ha eliminado.** La integración OAuth de nivel gratuito
(`qwen-portal`) que usaba endpoints de `portal.qwen.ai` ya no está disponible.
Consulta [Issue #49557](https://github.com/openclaw/openclaw/issues/49557) para
ver el contexto.

</Warning>

OpenClaw ahora trata a Qwen como un proveedor incluido de primera clase con el id canónico
`qwen`. El proveedor incluido apunta a los endpoints de Qwen Cloud / Alibaba DashScope y
Coding Plan, y mantiene los ids heredados de `modelstudio` funcionando como un
alias de compatibilidad.

- Proveedor: `qwen`
- Variable de entorno preferida: `QWEN_API_KEY`
- También aceptadas por compatibilidad: `MODELSTUDIO_API_KEY`, `DASHSCOPE_API_KEY`
- Estilo de API: compatible con OpenAI

<Tip>
Si quieres `qwen3.6-plus`, prefiere el endpoint **Standard (pay-as-you-go)**.
El soporte de Coding Plan puede ir por detrás del catálogo público.
</Tip>

## Primeros pasos

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

<Tabs>
  <Tab title="Coding Plan (suscripción)">
    **Mejor para:** acceso basado en suscripción mediante el Qwen Coding Plan.

    <Steps>
      <Step title="Obtén tu clave de API">
        Crea o copia una clave de API desde [home.qwencloud.com/api-keys](https://home.qwencloud.com/api-keys).
      </Step>
      <Step title="Ejecuta 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
        ```
      </Step>
      <Step title="Establece un modelo predeterminado">
        ```json5
        {
          agents: {
            defaults: {
              model: { primary: "qwen/qwen3.5-plus" },
            },
          },
        }
        ```
      </Step>
      <Step title="Verifica que el modelo esté disponible">
        ```bash
        openclaw models list --provider qwen
        ```
      </Step>
    </Steps>

    <Note>
    Los ids de auth-choice heredados `modelstudio-*` y las referencias de modelo `modelstudio/...` todavía
    funcionan como alias de compatibilidad, pero los flujos de configuración nuevos deberían preferir los ids de auth-choice
    canónicos `qwen-*` y las referencias de modelo `qwen/...`. Si defines una entrada
    personalizada exacta `models.providers.modelstudio` con otro valor de `api`, ese
    proveedor personalizado posee las referencias `modelstudio/...` en lugar del alias de compatibilidad
    de Qwen.
    </Note>

  </Tab>

  <Tab title="Standard (pago por uso)">
    **Mejor para:** acceso de pago por uso mediante el endpoint Standard Model Studio, incluidos modelos como `qwen3.6-plus` que quizá no estén disponibles en el Coding Plan.

    <Steps>
      <Step title="Obtén tu clave de API">
        Crea o copia una clave de API desde [home.qwencloud.com/api-keys](https://home.qwencloud.com/api-keys).
      </Step>
      <Step title="Ejecuta 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
        ```
      </Step>
      <Step title="Establece un modelo predeterminado">
        ```json5
        {
          agents: {
            defaults: {
              model: { primary: "qwen/qwen3.5-plus" },
            },
          },
        }
        ```
      </Step>
      <Step title="Verifica que el modelo esté disponible">
        ```bash
        openclaw models list --provider qwen
        ```
      </Step>
    </Steps>

    <Note>
    Los ids de auth-choice heredados `modelstudio-*` y las referencias de modelo `modelstudio/...` todavía
    funcionan como alias de compatibilidad, pero los flujos de configuración nuevos deberían preferir los ids de auth-choice
    canónicos `qwen-*` y las referencias de modelo `qwen/...`. Si defines una entrada
    personalizada exacta `models.providers.modelstudio` con otro valor de `api`, ese
    proveedor personalizado posee las referencias `modelstudio/...` en lugar del alias de compatibilidad
    de Qwen.
    </Note>

  </Tab>
</Tabs>

## Tipos de plan y endpoints

| Plan                       | Región | Opción de autenticación     | Endpoint                                         |
| -------------------------- | ------ | -------------------------- | ------------------------------------------------ |
| 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` |
| 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`          |

El proveedor selecciona automáticamente el endpoint según tu opción de autenticación. Las opciones
canónicas usan la familia `qwen-*`; `modelstudio-*` queda solo para compatibilidad.
Puedes sobrescribirlo con un `baseUrl` personalizado en la configuración.

<Tip>
**Gestionar claves:** [home.qwencloud.com/api-keys](https://home.qwencloud.com/api-keys) |
**Docs:** [docs.qwencloud.com](https://docs.qwencloud.com/developer-guides/getting-started/introduction)
</Tip>

## Catálogo integrado

OpenClaw actualmente incluye este catálogo Qwen incluido. El catálogo configurado es
consciente del endpoint: las configuraciones de Coding Plan omiten modelos que solo se sabe que funcionan en
el endpoint Standard.

| Referencia de modelo        | Entrada     | Contexto  | Notas                                                       |
| --------------------------- | ----------- | --------- | ----------------------------------------------------------- |
| `qwen/qwen3.5-plus`         | texto, imagen | 1,000,000 | Modelo predeterminado                                       |
| `qwen/qwen3.6-plus`         | texto, imagen | 1,000,000 | Prefiere endpoints Standard cuando necesites este modelo    |
| `qwen/qwen3-max-2026-01-23` | texto       | 262,144   | Línea Qwen Max                                              |
| `qwen/qwen3-coder-next`     | texto       | 262,144   | Coding                                                      |
| `qwen/qwen3-coder-plus`     | texto       | 1,000,000 | Coding                                                      |
| `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                                |

<Note>
La disponibilidad todavía puede variar según el endpoint y el plan de facturación, incluso cuando un modelo está
presente en el catálogo incluido.
</Note>

## Controles de pensamiento

Para los modelos de Qwen Cloud con razonamiento habilitado, el proveedor incluido 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`; los demás niveles de pensamiento envían
`enable_thinking: true`.

## Complementos multimodales

El Plugin `qwen` también expone capacidades multimodales en los endpoints DashScope **Standard**
(no en los endpoints de Coding Plan):

- **Comprensión de 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`

Para usar Qwen como proveedor de video predeterminado:

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

<Note>
Consulta [Generación de video](/es/tools/video-generation) para ver parámetros de herramienta compartidos, selección de proveedor y comportamiento de conmutación por error.
</Note>

## Configuración avanzada

<AccordionGroup>
  <Accordion title="Comprensión de imágenes y video">
    El Plugin Qwen incluido registra comprensión multimedia para imágenes y video
    en los endpoints DashScope **Standard** (no en los endpoints de Coding Plan).

    | Propiedad       | Valor                 |
    | --------------- | --------------------- |
    | Modelo          | `qwen-vl-max-latest`  |
    | Entrada compatible | Imágenes, video    |

    La comprensión multimedia se resuelve automáticamente desde la autenticación de Qwen configurada; no se
    necesita configuración adicional. Asegúrate de usar un endpoint Standard (pago por uso)
    para el soporte de comprensión multimedia.

  </Accordion>

  <Accordion title="Disponibilidad de Qwen 3.6 Plus">
    `qwen3.6-plus` está disponible en los endpoints Standard (pago por uso) de Model Studio:

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

    Si los endpoints de Coding Plan devuelven un error de "modelo no compatible" para
    `qwen3.6-plus`, cambia a Standard (pago por uso) en lugar del par
    endpoint/clave de Coding Plan.

    El catálogo Qwen incluido de OpenClaw no anuncia `qwen3.6-plus` en endpoints de Coding
    Plan, pero las entradas `qwen/qwen3.6-plus` configuradas explícitamente bajo
    `models.providers.qwen.models` se respetan en baseUrls de Coding Plan para que
    puedas habilitar ese modelo si Aliyun lo activa en tu suscripción. La
    API upstream sigue decidiendo si la llamada se realiza correctamente.

  </Accordion>

  <Accordion title="Plan de capacidades">
    El Plugin `qwen` se está posicionando como el hogar del proveedor para toda la superficie de Qwen
    Cloud, no solo para modelos de codificación/texto.

    - **Modelos de texto/chat:** incluidos ahora
    - **Llamadas a herramientas, salida estructurada, pensamiento:** heredados del transporte compatible con OpenAI
    - **Generación de imágenes:** planificada en la capa de Plugin de proveedor
    - **Comprensión de imágenes/video:** incluida ahora en el endpoint Standard
    - **Voz/audio:** planificada en la capa de Plugin de proveedor
    - **Embeddings/reordenamiento de memoria:** planificado mediante la superficie del adaptador de embeddings
    - **Generación de video:** incluida ahora mediante la capacidad compartida de generación de video

  </Accordion>

  <Accordion title="Detalles de generación de video">
    Para la generación de video, OpenClaw asigna la región Qwen configurada al host AIGC
    de DashScope correspondiente antes de enviar el trabajo:

    - Global/Intl: `https://dashscope-intl.aliyuncs.com`
    - China: `https://dashscope.aliyuncs.com`

    Eso significa que un `models.providers.qwen.baseUrl` normal que apunte a los hosts
    Qwen de Coding Plan o Standard todavía mantiene la generación de video en el endpoint de video
    regional correcto de DashScope.

    Límites actuales incluidos para generación de video con Qwen:

    - Hasta **1** video de salida por solicitud
    - Hasta **1** imagen de entrada
    - Hasta **4** videos de entrada
    - Hasta **10 segundos** de duración
    - Admite `size`, `aspectRatio`, `resolution`, `audio` y `watermark`
    - El modo de imagen/video de referencia actualmente requiere **URL http(s) remotas**. Las
      rutas de archivos locales se rechazan de entrada porque el endpoint de video de DashScope no
      acepta búferes locales subidos para esas referencias.

  </Accordion>

  <Accordion title="Compatibilidad de uso en streaming">
    Los endpoints nativos de Model Studio anuncian compatibilidad de uso en streaming en el
    transporte compartido `openai-completions`. OpenClaw ahora se basa en las capacidades
    del endpoint, por lo que los ids de proveedor personalizados compatibles con DashScope que apunten a los
    mismos hosts nativos heredan el mismo comportamiento de uso en streaming en lugar de
    requerir específicamente el id del proveedor integrado `qwen`.

    La compatibilidad de uso con streaming nativo se aplica tanto a los hosts de Coding Plan como
    a los hosts compatibles con Standard 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`

  </Accordion>

  <Accordion title="Regiones de endpoints multimodales">
    Las superficies multimodales (comprensión de video y generación de video Wan) usan los
    endpoints DashScope **Standard**, no los endpoints de Coding Plan:

    - URL base Global/Intl Standard: `https://dashscope-intl.aliyuncs.com/compatible-mode/v1`
    - URL base China Standard: `https://dashscope.aliyuncs.com/compatible-mode/v1`

  </Accordion>

  <Accordion title="Configuración del entorno y del daemon">
    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`).
  </Accordion>
</AccordionGroup>

## Relacionado

<CardGroup cols={2}>
  <Card title="Selección de modelos" href="/es/concepts/model-providers" icon="layers">
    Elección de proveedores, referencias de modelos y comportamiento de conmutación por error.
  </Card>
  <Card title="Generación de video" href="/es/tools/video-generation" icon="video">
    Parámetros compartidos de la herramienta de video y selección de proveedores.
  </Card>
  <Card title="Alibaba (ModelStudio)" href="/es/providers/alibaba" icon="cloud">
    Proveedor heredado de ModelStudio y notas de migración.
  </Card>
  <Card title="Solución de problemas" href="/es/help/troubleshooting" icon="wrench">
    Solución general de problemas y preguntas frecuentes.
  </Card>
</CardGroup>