Naar hoofdinhoud gaan
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 zai-provider met een Z.AI API-sleutel.
EigenschapWaarde
Providerzai
Pakket@openclaw/zai-provider
AuthZAI_API_KEY (verouderde alias: Z_AI_API_KEY)
APIZ.AI Chat Completions (Bearer-auth)

​
GLM-modellen

GLM is een modelfamilie, geen afzonderlijke provider. In OpenClaw gebruiken GLM-modellen refs 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
Beste voor: de meeste gebruikers. OpenClaw test ondersteunde Z.AI-endpoints met je API-sleutel en past automatisch de juiste basis-URL toe.
1

Onboarding uitvoeren

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

Controleren of het model wordt vermeld

openclaw models list --all --provider zai

​
Configuratievoorbeeld

Met zai-api-key kan OpenClaw het bijbehorende Z.AI-endpoint uit de sleutel 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 uses the Coding Plan endpoint.
        baseUrl: "https://api.z.ai/api/coding/paas/v4",
      },
    },
  },
  agents: { defaults: { model: { primary: "zai/glm-5.2" } } },
}

​
Ingebouwde catalogus

De zai provider-Plugin levert zijn catalogus mee in het Plugin-manifest, zodat alleen-lezen weergave bekende GLM-rijen kan tonen zonder de provider-runtime te laden: 
openclaw models list --all --provider zai
De door het manifest ondersteunde catalogus bevat momenteel:
ModelrefOpmerkingen
zai/glm-5.2Coding Plan-standaard; 1M-context
zai/glm-5.1Standaard 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
GLM-modellen zijn beschikbaar als zai/<model> (voorbeeld: zai/glm-5).
GLM-5.2 ondersteunt de denkniveaus off, low, high en max. OpenClaw koppelt low en high aan hoge redeneerinspanning in Z.AI, en max aan maximale inspanning.
De installatie van Coding Plan gebruikt standaard zai/glm-5.2; de installatie van de algemene API behoudt zai/glm-5.1. Automatische endpointdetectie valt terug op glm-5.1 of glm-4.7 wanneer het geselecteerde plan GLM-5.2 niet aanbiedt. GLM-versies en beschikbaarheid kunnen veranderen; voer openclaw models list --all --provider zai uit om de catalogus te zien die bekend is bij je geïnstalleerde versie.

​
Geavanceerde configuratie

Onbekende glm-5*-id’s worden nog steeds vooruit opgelost op het providerpad door provider-eigen metadata te synthetiseren uit de glm-4.7-template wanneer de id overeenkomt met de huidige vorm van de GLM-5-familie.
tool_stream is standaard ingeschakeld voor Z.AI tool-call-streaming. Om dit uit te schakelen:
{
  agents: {
    defaults: {
      models: {
        "zai/<model>": {
          params: { tool_stream: false },
        },
      },
    },
  },
}
Denken in Z.AI volgt de /think-besturing van OpenClaw. Wanneer denken uit staat, stuurt OpenClaw thinking: { type: "disabled" } om reacties te vermijden die het uitvoerbudget besteden aan reasoning_content vóór zichtbare tekst.Bewaard denken is opt-in omdat Z.AI vereist dat de volledige historische reasoning_content opnieuw wordt afgespeeld, wat prompttokens verhoogt. Schakel dit per model in:
{
  agents: {
    defaults: {
      models: {
        "zai/glm-5.2": {
          params: { preserveThinking: true },
        },
      },
    },
  },
}
Wanneer dit is ingeschakeld en denken aan staat, stuurt OpenClaw thinking: { type: "enabled", clear_thinking: false } en speelt eerdere reasoning_content opnieuw af voor hetzelfde OpenAI-compatibele transcript.Geavanceerde gebruikers kunnen de exacte provider-payload nog steeds overschrijven met params.extra_body.thinking.
De Z.AI-Plugin registreert begrip van afbeeldingen.
EigenschapWaarde
Modelglm-4.6v
Begrip van afbeeldingen wordt automatisch opgelost vanuit de geconfigureerde Z.AI-authenticatie: er is geen aanvullende configuratie nodig.
  • Z.AI gebruikt Bearer-auth met je API-sleutel.
  • De onboarding-keuze zai-api-key detecteert automatisch het bijbehorende 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 env-var 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.

​
Gerelateerd

Modelselectie

Providers, modelrefs en failovergedrag kiezen.

Configuratiereferentie

Volledig OpenClaw-configuratieschema, inclusief provider- en modelinstellingen.