English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Providers

Z.AI

Z.AI es la plataforma de API para los 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.

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

Modelos GLM

GLM es una familia de modelos, no un proveedor independiente. En OpenClaw, los modelos GLM usan refs como zai/glm-5.2: proveedor zai, id de modelo glm-5.2.

Primeros pasos

Instala primero el Plugin del proveedor:

bash
openclaw plugins install @openclaw/zai-provider

Detectar endpoint automáticamente

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

  • Ejecutar onboarding

    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

    Ideal para: usuarios que quieren forzar un Coding Plan específico o una superficie de API general.

  • Elegir la opción de onboarding correcta

    bash
    # 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 APIopenclaw onboard --auth-choice zai-global # General API CN (China region)openclaw onboard --auth-choice zai-cn

  • Verificar que el modelo aparece en la lista

    bash
    openclaw models list --all --provider zai

    • Ejemplo de configuración

    json5
    {  env: { ZAI_API_KEY: "sk-..." },  models: {    providers: {      zai: {        // GLM-5.2 uses the Coding Plan endpoint.        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 filas GLM conocidas sin cargar el runtime del proveedor:

    bash
    openclaw models list --all --provider zai

    El catálogo respaldado por el manifiesto incluye actualmente:

    Ref de modelo Notas
    zai/glm-5.2 Valor predeterminado de Coding Plan; contexto de 1M
    zai/glm-5.1 Valor 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

    Configuración avanzada

    Resolución futura de modelos GLM-5 desconocidos

    Los ids glm-5* desconocidos siguen resolviéndose hacia adelante en la ruta del proveedor mediante la sintetización de 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.

    Transmisión en streaming de llamadas a herramientas

    tool_stream está habilitado de forma predeterminada para la transmisión en streaming de llamadas a herramientas de Z.AI. Para deshabilitarlo:

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

    El razonamiento de Z.AI sigue los controles /think de OpenClaw. Con el razonamiento desactivado, OpenClaw envía thinking: { type: "disabled" } para evitar respuestas que gasten el presupuesto de salida en reasoning_content antes del texto visible.

    El razonamiento preservado es opcional porque Z.AI requiere reproducir todo el reasoning_content histórico, lo que aumenta los tokens del prompt. Habilítalo por modelo:

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

    Cuando está habilitado y el razonamiento está activado, OpenClaw envía thinking: { type: "enabled", clear_thinking: false } y reproduce el reasoning_content anterior 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 Plugin de Z.AI registra 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 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-key detecta automáticamente el endpoint de Z.AI correspondiente sondeando los endpoints compatibles con tu 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.
    • La variable de entorno heredada Z_AI_API_KEY todavía se acepta; OpenClaw la copia a ZAI_API_KEY al iniciar si ZAI_API_KEY no está definida.

    Relacionado

    Selección de modelos

    Elegir proveedores, refs de modelo y comportamiento de conmutación por error.
    Referencia de configuración

    Esquema completo de configuración de OpenClaw, incluida la configuración de proveedores y modelos.
    Was this useful?
    On this page

    On this page