Z.AI

Z.AI is het API-platform voor GLM-modellen. Het biedt REST-API’s voor GLM en gebruikt API-sleutels voor authenticatie. Maak je API-sleutel aan in de Z.AI-console. OpenClaw gebruikt de provider zai met een Z.AI-API-sleutel.

Eigenschap	Waarde
Provider	`zai`
Pakket	`@openclaw/zai-provider`
Auth	`ZAI_API_KEY` (verouderde alias: `Z_AI_API_KEY`)
API	Z.AI Chat Completions (Bearer-authenticatie)

GLM-modellen

GLM is een modelfamilie, geen afzonderlijke provider. In OpenClaw gebruiken GLM-modellen verwijzingen zoals zai/glm-5.2: provider zai, model-id glm-5.2.

Aan de slag

Installeer eerst de provider-Plugin:

openclaw plugins install @openclaw/zai-provider

Endpoint automatisch detecteren
Expliciet regionaal endpoint

Het meest geschikt voor: de meeste gebruikers. OpenClaw test ondersteunde Z.AI-endpoints met je API-sleutel en past automatisch de juiste basis-URL toe.

Onboarding uitvoeren

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

Controleren of het model wordt vermeld

openclaw models list --all --provider zai

Het meest geschikt voor: gebruikers die een specifiek Coding Plan- of algemeen API-oppervlak willen afdwingen.

De juiste onboardingkeuze selecteren

# Coding Plan Global (aanbevolen voor gebruikers van Coding Plan)
openclaw onboard --auth-choice zai-coding-global

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

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

# Algemene API CN (regio China)
openclaw onboard --auth-choice zai-cn

Controleren of het model wordt vermeld

openclaw models list --all --provider zai

Endpoints

Onboardingkeuze	Basis-URL	Standaardmodel
`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`

Z.AI publiceert ook de met Anthropic compatibele Coding Plan-basis-URL https://api.z.ai/api/anthropic. De Z.AI-keuzes van OpenClaw gebruiken de hierboven gedocumenteerde OpenAI Chat Completions-endpoints; de Anthropic-URL is bedoeld voor clients die rechtstreeks met Anthropic Messages communiceren. zai-api-key detecteert automatisch een van deze vier door je sleutel te testen met de chat-completions-API van elk endpoint. Daarbij worden eerst de algemene endpoints gecontroleerd (zai-global, daarna zai-cn) en vervolgens de Coding Plan-endpoints (zai-coding-global, daarna zai-coding-cn). Het proces stopt bij het eerste endpoint dat een verzoek accepteert. Gebruik een expliciete --auth-choice om een Coding Plan-endpoint af te dwingen als je sleutel op beide werkt.

Snelheidslimieten en overbelasting

Z.AI beschrijft Coding Plan en de algemene agenttools als diensten met beheerde capaciteit. Volgens de eigen documentatie van Z.AI:

Algemene agenttools, waaronder OpenClaw, worden op basis van best effort aangeboden. Tijdens een hoge inferentiebelasting, doorgaans rond 14.00-18.00 uur Singaporese tijd, kunnen voor sommige verzoeken tijdelijke snelheidslimieten gelden.
Snelheids- en gelijktijdigheidslimieten van Coding Plan zijn gekoppeld aan het abonnementsniveau en kunnen dynamisch worden aangepast op basis van de beschikbare resources. Buiten piekuren kan een hogere gelijktijdigheid beschikbaar zijn.
API-foutcode 1302 betekent “Snelheidslimiet voor verzoeken bereikt”. API-foutcode 1305 betekent “De dienst is mogelijk tijdelijk overbelast. Probeer het later opnieuw”.

Als je tijdens een drukke periode een tijdelijk antwoord met 429 of 1305 ziet, wacht dan en probeer het verzoek opnieuw. Als fouten ook buiten piekuren herhaaldelijk optreden of alleen bij één endpoint, model of verzoekstructuur voorkomen, controleer dan eerst het geconfigureerde endpoint en model:

openclaw models list --all --provider zai
openclaw config get models.providers.zai.baseUrl

Coding Plan-sleutels moeten een Coding Plan-endpoint gebruiken, zoals https://api.z.ai/api/coding/paas/v4; algemene API-sleutels moeten een algemeen API-endpoint gebruiken, zoals https://api.z.ai/api/paas/v4. Aanhoudende fouten met dezelfde sleutel en hetzelfde endpoint kunnen duiden op een weigering door de provider of een abonnementsbeperking, niet op normale beperking vanwege piekbelasting.

Configuratievoorbeeld

Met zai-api-key kan OpenClaw het bij de sleutel passende Z.AI-endpoint detecteren en automatisch de juiste basis-URL toepassen. Gebruik de expliciete regionale keuzes wanneer je een specifiek Coding Plan- of algemeen API-oppervlak wilt afdwingen.

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

Ingebouwde catalogus

De provider-Plugin zai levert zijn catalogus mee in het Plugin-manifest, zodat een alleen-lezenlijst bekende GLM-rijen kan weergeven zonder de provider-runtime te laden:

openclaw models list --all --provider zai

De door het manifest ondersteunde catalogus bevat momenteel:

Modelverwijzing	Opmerkingen
`zai/glm-5.2`	Standaard voor Coding Plan; context van 1M
`zai/glm-5.1`	Standaard voor algemene API
`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`

De metadata over tokenkosten in de catalogus volgt de huidige prijzen voor betalen naar gebruik van Z.AI. Coding Plan- abonnementen gebruiken een abonnementsquotum in plaats van facturering per token; raadpleeg de actuele abonnementspagina voor prijzen en beschikbaarheid van abonnementen.

GLM-modellen zijn beschikbaar als zai/<model> (voorbeeld: zai/glm-5).

De configuratie van Coding Plan gebruikt standaard zai/glm-5.2; de configuratie van de algemene API behoudt zai/glm-5.1. Op de Coding Plan-endpoints valt automatische detectie terug op glm-5.1 en daarna glm-4.7 wanneer de sleutel of het abonnement GLM-5.2 niet beschikbaar stelt. GLM- versies en beschikbaarheid kunnen veranderen; voer openclaw models list --all --provider zai uit om de catalogus te bekijken die je geïnstalleerde versie kent.

Denkniveaus

GLM-5.2
Andere GLM-modellen

Volledig bereik: off, low, high, max (standaard off). OpenClaw wijst low en high toe aan de redeneerinspanning high van Z.AI, en max aan de inspanning max van Z.AI, via reasoning_effort in de verzoekpayload.

Alleen binaire schakelaar: off en low (weergegeven als on in keuzelijsten), standaard off. Als denken wordt ingesteld op off, wordt thinking: { type: "disabled" } verzonden; bij elk ander niveau blijft de verzoekpayload ongewijzigd (het eigen standaardgedrag voor redeneren van Z.AI wordt toegepast).

Door denken in te stellen op off voorkom je antwoorden die het uitvoerbudget besteden aan reasoning_content vóór zichtbare tekst.

Geavanceerde configuratie

Onbekende GLM-5-modellen voorwaarts oplossen

Onbekende glm-5*-id’s worden nog steeds voorwaarts opgelost in het providerpad door metadata van de provider te genereren op basis van de glm-4.7-sjabloon wanneer de id overeenkomt met de huidige vorm van de GLM-5-familie.

Streaming van toolaanroepen

tool_stream is standaard ingeschakeld voor streaming van Z.AI-toolaanroepen. Zo schakel je dit uit:

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

Bewaard denkproces

Het bewaren van het denkproces is opt-in, omdat Z.AI vereist dat de volledige historische reasoning_content opnieuw wordt afgespeeld, waardoor het aantal prompttokens toeneemt. Schakel dit per model in:

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

Wanneer dit is ingeschakeld en denken aanstaat, verzendt OpenClaw thinking: { type: "enabled", clear_thinking: false } en speelt het eerdere reasoning_content opnieuw af voor hetzelfde met OpenAI compatibele transcript. De snake_case- parametersleutel preserve_thinking werkt als alias.Geavanceerde gebruikers kunnen de exacte providerpayload nog steeds overschrijven met params.extra_body.thinking.

Beeldbegrip

De Z.AI-Plugin registreert beeldbegrip.

Eigenschap	Waarde
Model	`glm-4.6v`

Beeldbegrip wordt automatisch afgeleid uit de geconfigureerde Z.AI-authenticatie — er is geen aanvullende configuratie nodig.

Authenticatiedetails

Z.AI gebruikt Bearer-authenticatie met je API-sleutel.
De onboardingkeuze zai-api-key detecteert automatisch het passende Z.AI-endpoint door ondersteunde endpoints met je sleutel te testen.
Gebruik de expliciete regionale keuzes (zai-coding-global, zai-coding-cn, zai-global, zai-cn) wanneer je een specifiek API-oppervlak wilt afdwingen.
De verouderde omgevingsvariabele Z_AI_API_KEY wordt nog steeds geaccepteerd; OpenClaw kopieert deze bij het opstarten naar ZAI_API_KEY als ZAI_API_KEY niet is ingesteld.

Overview

Concepts and configuration

Providers

GLM-modellen

Aan de slag

Endpoints

Snelheidslimieten en overbelasting

Configuratievoorbeeld

Ingebouwde catalogus

Denkniveaus

Geavanceerde configuratie

Gerelateerd

Modelselectie

Configuratiereferentie

​GLM-modellen

​Aan de slag

​Endpoints

​Snelheidslimieten en overbelasting

​Configuratievoorbeeld

​Ingebouwde catalogus

​Denkniveaus

​Geavanceerde configuratie

​Gerelateerd

Modelselectie

Configuratiereferentie

GLM-modellen

Aan de slag

Endpoints

Snelheidslimieten en overbelasting

Configuratievoorbeeld

Ingebouwde catalogus

Denkniveaus

Geavanceerde configuratie

Gerelateerd