OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Z.AI

Z.AI es la plataforma de API para los modelos GLM. Proporciona API REST para GLM y utiliza claves de API para la autenticación. Cree su clave de API en la consola de Z.AI. OpenClaw utiliza el proveedor zai con una clave de API de Z.AI.

Propiedad Valor
Proveedor zai
Paquete @openclaw/zai-provider
Autenticación ZAI_API_KEY (alias heredado: Z_AI_API_KEY)
API Finalizaciones de chat de Z.AI (autenticación Bearer)

Modelos GLM

GLM es una familia de modelos, no un proveedor independiente. En OpenClaw, los modelos GLM utilizan referencias como zai/glm-5.2: proveedor zai, identificador de modelo glm-5.2.

Primeros pasos

Instale primero el Plugin del proveedor:

bash
openclaw plugins install @openclaw/zai-provider

Detección automática del endpoint

Recomendado para: la mayoría de los usuarios. OpenClaw prueba los endpoints compatibles de Z.AI con su clave de API y aplica automáticamente la URL base correcta.

  • Ejecutar la incorporación

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

  • Verificar que el modelo aparece en la lista

    bash
    openclaw models list --all --provider zai

    • Endpoint regional explícito

    Recomendado para: usuarios que deseen forzar un Coding Plan específico o la API general.

  • Elegir la opción de incorporación correcta

    bash
    # Coding Plan global (recomendado para usuarios de Coding Plan)openclaw onboard --auth-choice zai-coding-global # Coding Plan de China (región de China)openclaw onboard --auth-choice zai-coding-cn # API generalopenclaw onboard --auth-choice zai-global # API general de China (región de China)openclaw onboard --auth-choice zai-cn

  • Verificar que el modelo aparece en la lista

    bash
    openclaw models list --all --provider zai

    • Endpoints

    Opción de incorporación URL base Modelo predeterminado
    zai-global https://api.z.ai/api/paas/v4 glm-5.1
    zai-cn https://open.bigmodel.cn/api/paas/v4 glm-5.1
    zai-coding-global https://api.z.ai/api/coding/paas/v4 glm-5.2
    zai-coding-cn https://open.bigmodel.cn/api/coding/paas/v4 glm-5.2

    zai-api-key detecta automáticamente uno de estos cuatro endpoints probando su clave con la API de finalizaciones de chat de cada endpoint. Comprueba primero los endpoints generales (zai-global, seguido de zai-cn) y después los endpoints de Coding Plan (zai-coding-global, seguido de zai-coding-cn), y se detiene en el primer endpoint que acepta una solicitud. Utilice una opción --auth-choice explícita para forzar un endpoint de Coding Plan si su clave funciona en ambos.

    Ejemplo de configuración

    json5
    {  env: { ZAI_API_KEY: "sk-..." },  models: {    providers: {      zai: {        // GLM-5.2 utiliza el endpoint de Coding Plan.        baseUrl: "https://api.z.ai/api/coding/paas/v4",      },    },  },  agents: { defaults: { model: { primary: "zai/glm-5.2" } } },}

    Catálogo integrado

    El Plugin del proveedor zai incluye su catálogo en el manifiesto del Plugin, por lo que el listado de solo lectura puede mostrar las filas de GLM conocidas sin cargar el entorno de ejecución del proveedor:

    bash
    openclaw models list --all --provider zai

    El catálogo respaldado por el manifiesto incluye actualmente:

    Referencia del modelo Notas
    zai/glm-5.2 Predeterminado de Coding Plan; contexto de 1 M
    zai/glm-5.1 Predeterminado de la API general
    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

    Niveles de razonamiento

    GLM-5.2

    Intervalo completo: off, low, high, max (valor predeterminado: off). OpenClaw asigna low y high al esfuerzo de razonamiento high de Z.AI, y max al esfuerzo max de Z.AI, mediante reasoning_effort en la carga útil de la solicitud.

    Otros modelos GLM

    Solo conmutación binaria: off y low (se muestra como on en los selectores); el valor predeterminado es off. Establecer el razonamiento en off envía thinking: { type: "disabled" }; cualquier otro nivel deja intacta la carga útil de la solicitud (se aplica el comportamiento de razonamiento predeterminado de Z.AI).

    Establecer el razonamiento en off evita respuestas que consuman el presupuesto de salida en reasoning_content antes del texto visible.

    Configuración avanzada

    Resolución anticipada de modelos GLM-5 desconocidos

    Los identificadores glm-5* desconocidos también se resuelven de forma anticipada en la ruta del proveedor mediante la síntesis de metadatos propiedad del proveedor a partir de la plantilla glm-4.7 cuando el identificador coincide con la estructura actual de la familia GLM-5.

    Transmisión de llamadas a herramientas

    tool_stream está activado de forma predeterminada para la transmisión de llamadas a herramientas de Z.AI. Para desactivarlo:

    json5
    {  agents: {    defaults: {      models: {        "zai/<model>": {          params: { tool_stream: false },        },      },    },  },}
    Razonamiento conservado

    El razonamiento conservado debe activarse explícitamente porque Z.AI requiere que se reproduzca todo el reasoning_content histórico, lo que aumenta los tokens del prompt. Actívelo para cada modelo:

    json5
    {  agents: {    defaults: {      models: {        "zai/glm-5.2": {          params: { preserveThinking: true },        },      },    },  },}

    Cuando está activado y el razonamiento está habilitado, OpenClaw envía thinking: { type: "enabled", clear_thinking: false } y reproduce el reasoning_content anterior para la misma transcripción compatible con OpenAI. La clave de parámetro en snake_case preserve_thinking funciona como alias.

    Los usuarios avanzados también pueden sobrescribir la carga útil exacta del proveedor mediante params.extra_body.thinking.

    Comprensión de imágenes

    El Plugin de Z.AI registra la comprensión de imágenes.

    Propiedad Valor
    Modelo glm-4.6v

    La comprensión de imágenes se resuelve automáticamente a partir de la autenticación configurada de Z.AI; no se necesita ninguna configuración adicional.

    Detalles de autenticación
    • Z.AI utiliza autenticación Bearer con su clave de API.
    • La opción de incorporación zai-api-key detecta automáticamente el endpoint de Z.AI correspondiente probando los endpoints compatibles con su clave.
    • Utilice las opciones regionales explícitas (zai-coding-global, zai-coding-cn, zai-global, zai-cn) cuando desee forzar una API específica.
    • La variable de entorno heredada Z_AI_API_KEY sigue siendo compatible; OpenClaw la copia a ZAI_API_KEY al iniciarse si ZAI_API_KEY no está definida.

    Temas relacionados

    Selección de modelos

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

    Esquema de configuración completo de OpenClaw, incluidos los ajustes de proveedores y modelos.
    Was this useful?
    On this page

    On this page