Z.AI

Z.AI es la plataforma API para modelos GLM. Proporciona APIs REST para GLM y utiliza 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
Auth: ZAI_API_KEY
API: Z.AI Chat Completions (autenticación Bearer)

Para empezar

Lo mejor para: la mayoría de los usuarios. OpenClaw detecta el endpoint de Z.AI coincidente desde la clave y aplica la URL base correcta automáticamente.

Ejecutar integración

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
Ventana de terminal
```
openclaw models list --all --provider zai
```

Lo mejor para: usuarios que deseen forzar un Plan de Codificación específico o una superficie de API general.

Elegir la opción de integración correcta

# Coding Plan Global (recommended for Coding Plan users)
openclaw onboard --auth-choice zai-coding-global

# Coding Plan CN (China region)
openclaw onboard --auth-choice zai-coding-cn

# General API
openclaw onboard --auth-choice zai-global

# General API CN (China region)
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
Ventana de terminal
```
openclaw models list --all --provider zai
```

Catálogo integrado

OpenClaw incluye el catálogo de proveedores zai en el manifiesto del complemento, por lo que el listado de solo lectura puede mostrar filas GLM conocidas sin cargar el tiempo de ejecución del proveedor:

openclaw models list --all --provider zai

El catálogo respaldado por el manifiesto incluye actualmente:

Ref. 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 hacia adelante de modelos GLM-5 desconocidos

Los ids de modelos glm-5* desconocidos aún se resuelven hacia adelante en la ruta del proveedor incluido sintetizando metadatos propios del proveedor a partir de la plantilla glm-4.7 cuando el id coincide con la forma de familia actual de GLM-5.

Transmisión de llamadas a herramientas

tool_stream está habilitado por defecto para la transmisión de llamadas a herramientas de Z.AI. Para deshabilitarlo:

{
  agents: {
    defaults: {
      models: {
        "zai/

”: { 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 de aviso. Actívelo 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 reasoning_content anteriores para la misma transcripción compatible con OpenAI.

Los usuarios avanzados aún pueden anular la carga útil exacta del proveedor con params.extra_body.thinking.

Comprensión de imágenes

El complemento 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 Z.AI configurada; no se necesita configuración adicional.

Detalles de autenticación

Z.AI utiliza autenticación Bearer con su clave de API.
La elección de incorporación zai-api-key detecta automáticamente el punto final de Z.AI coincidente a partir del prefijo de la clave.
Utilice las elecciones regionales explícitas (zai-coding-global, zai-coding-cn, zai-global, zai-cn) cuando desee forzar una superficie de API específica.

Relacionado

Familia de modelos GLM

Resumen de la familia de modelos para GLM.

Selección de modelos

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