Providers
Z.AI
Z.AI es la plataforma de API para modelos GLM. Proporciona API REST para GLM y usa claves de API
para la autenticación. Crea tu clave de API en la consola de Z.AI. OpenClaw usa el proveedor zai
con una clave de API de Z.AI.
- Proveedor:
zai - Autenticación:
ZAI_API_KEY - API: Chat Completions de Z.AI (autenticación Bearer)
Primeros pasos
Endpoint de detección automática
Ideal para: la mayoría de los usuarios. OpenClaw detecta el endpoint de Z.AI correspondiente a partir de la clave y aplica automáticamente la URL base correcta.
Ejecutar onboarding
openclaw onboard --auth-choice zai-api-key
Establecer un modelo predeterminado
{
env: { ZAI_API_KEY: "sk-..." },
agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
}
Verificar que el modelo esté listado
openclaw models list --all --provider zai
Endpoint regional explícito
Ideal para: usuarios que quieren forzar un Coding Plan específico o una superficie de API general.
Elegir la opción de onboarding correcta
# Coding Plan Global (recomendado para usuarios de Coding Plan)
openclaw onboard --auth-choice zai-coding-global
# Coding Plan CN (región de China)
openclaw onboard --auth-choice zai-coding-cn
# API general
openclaw onboard --auth-choice zai-global
# API general CN (región de China)
openclaw onboard --auth-choice zai-cn
Establecer un modelo predeterminado
{
env: { ZAI_API_KEY: "sk-..." },
agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
}
Verificar que el modelo esté listado
openclaw models list --all --provider zai
Catálogo integrado
OpenClaw incluye el catálogo del proveedor zai en el manifiesto del Plugin, por lo que el listado
de solo lectura puede mostrar filas GLM conocidas sin cargar el runtime del proveedor:
openclaw models list --all --provider zai
El catálogo respaldado por el manifiesto incluye actualmente:
| Referencia de modelo | Notas |
|---|---|
zai/glm-5.1 |
Modelo predeterminado |
zai/glm-5 |
|
zai/glm-5-turbo |
|
zai/glm-5v-turbo |
|
zai/glm-4.7 |
|
zai/glm-4.7-flash |
|
zai/glm-4.7-flashx |
|
zai/glm-4.6 |
|
zai/glm-4.6v |
|
zai/glm-4.5 |
|
zai/glm-4.5-air |
|
zai/glm-4.5-flash |
|
zai/glm-4.5v |
Configuración avanzada
Resolución futura de modelos GLM-5 desconocidos
Los ids glm-5* desconocidos aún se resuelven hacia delante en la ruta del proveedor incluido
sintetizando metadatos propiedad del proveedor a partir de la plantilla glm-4.7 cuando el id
coincide con la forma actual de la familia GLM-5.
Streaming de llamadas a herramientas
tool_stream está habilitado de forma predeterminada para el streaming de llamadas a herramientas de Z.AI. Para deshabilitarlo:
{
agents: {
defaults: {
models: {
"zai/<model>": {
params: { tool_stream: false },
},
},
},
},
}
Pensamiento y pensamiento preservado
El pensamiento de Z.AI sigue los controles /think de OpenClaw. Con el pensamiento desactivado,
OpenClaw envía thinking: { type: "disabled" } para evitar respuestas que
gasten el presupuesto de salida en reasoning_content antes del texto visible.
El pensamiento preservado es opcional porque Z.AI requiere que se reproduzca todo el
reasoning_content histórico, lo que aumenta los tokens del prompt. Habilítalo
por modelo:
{
agents: {
defaults: {
models: {
"zai/glm-5.1": {
params: { preserveThinking: true },
},
},
},
},
}
Cuando está habilitado y el pensamiento está activado, OpenClaw envía
thinking: { type: "enabled", clear_thinking: false } y reproduce el
reasoning_content previo para la misma transcripción compatible con OpenAI.
Los usuarios avanzados aún pueden anular el payload exacto del proveedor con
params.extra_body.thinking.
Comprensión de imágenes
El Plugin de Z.AI incluido registra la comprensión de imágenes.
| Propiedad | Valor |
|---|---|
| Modelo | glm-4.6v |
La comprensión de imágenes se resuelve automáticamente desde la autenticación de Z.AI configurada; no se necesita configuración adicional.
Detalles de autenticación
- Z.AI usa autenticación Bearer con tu clave de API.
- La opción de onboarding
zai-api-keydetecta automáticamente el endpoint de Z.AI correspondiente a partir del prefijo de la clave. - Usa las opciones regionales explícitas (
zai-coding-global,zai-coding-cn,zai-global,zai-cn) cuando quieras forzar una superficie de API específica.