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.

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

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

Ejecutar onboarding

openclaw onboard --auth-choice zai-api-key
2

Establecer un modelo predeterminado

{
  env: { ZAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
}
3

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 modeloNotas
zai/glm-5.1Modelo 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
Los modelos GLM están disponibles como zai/<model> (ejemplo: zai/glm-5). La referencia de modelo incluida predeterminada es zai/glm-5.1.

​
Configuración avanzada

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.
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 },
        },
      },
    },
  },
}
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.
El Plugin de Z.AI incluido registra la comprensión de imágenes.
PropiedadValor
Modeloglm-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.
  • Z.AI usa autenticación Bearer con tu clave de API.
  • La opción de onboarding zai-api-key detecta 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.

​
Relacionado

Familia de modelos GLM

Descripción general de la familia de modelos GLM.

Selección de modelos

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