Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 para ver el contexto.
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
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.

​
Primeros pasos

Elige tu tipo de plan y sigue los pasos de configuración.
Mejor para: acceso basado en suscripción mediante el 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 endpoint Global:
openclaw onboard --auth-choice qwen-api-key
Para el endpoint China:
openclaw onboard --auth-choice qwen-api-key-cn
3

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

​
Tipos de plan y endpoints

PlanRegiónOpción de autenticaciónEndpoint
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
Coding Plan (suscripción)Chinaqwen-api-key-cncoding.dashscope.aliyuncs.com/v1
Coding Plan (suscripción)Globalqwen-api-keycoding-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.
Gestionar claves: home.qwencloud.com/api-keys | Docs: docs.qwencloud.com

​
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 modeloEntradaContextoNotas
qwen/qwen3.5-plustexto, imagen1,000,000Modelo predeterminado
qwen/qwen3.6-plustexto, imagen1,000,000Prefiere endpoints Standard cuando necesites este modelo
qwen/qwen3-max-2026-01-23texto262,144Línea Qwen Max
qwen/qwen3-coder-nexttexto262,144Coding
qwen/qwen3-coder-plustexto1,000,000Coding
qwen/MiniMax-M2.5texto1,000,000Razonamiento habilitado
qwen/glm-5texto202,752GLM
qwen/glm-4.7texto202,752GLM
qwen/kimi-k2.5texto, imagen262,144Moonshot AI mediante Alibaba
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.

​
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: 
{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },
    },
  },
}
Consulta Generación de video para ver parámetros de herramienta compartidos, selección de proveedor y comportamiento de conmutación por error.

​
Configuración avanzada

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).
PropiedadValor
Modeloqwen-vl-max-latest
Entrada compatibleImá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.
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.
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
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.
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
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
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 modelos

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

Generación de video

Parámetros compartidos de la herramienta de video y selección de proveedores.

Alibaba (ModelStudio)

Proveedor heredado de ModelStudio y notas de migración.

Solución de problemas

Solución general de problemas y preguntas frecuentes.