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.

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

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

openclaw models list --all --provider zai

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

openclaw models list --all --provider zai

Endpoints

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 zaiopenclaw 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

{  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:

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.

Denkniveaus

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

Geavanceerde configuratie

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

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

Gerelateerd