Providers
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 uw 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 |
| Authenticatie | 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-providerEindpunt automatisch detecteren
Meest geschikt voor: de meeste gebruikers. OpenClaw test ondersteunde Z.AI-eindpunten met uw API-sleutel en past automatisch de juiste basis-URL toe.
Onboarding uitvoeren
openclaw onboard --auth-choice zai-api-keyControleren of het model wordt vermeld
openclaw models list --all --provider zaiExpliciet regionaal eindpunt
Meest geschikt voor: gebruikers die een specifiek Coding Plan of algemeen API-oppervlak willen afdwingen.
De juiste onboardingkeuze selecteren
# Coding Plan wereldwijd (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-cnControleren of het model wordt vermeld
openclaw models list --all --provider zaiEindpunten
| 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 |
zai-api-key detecteert automatisch een van deze vier door uw sleutel te testen met de
chat-completions-API van elk eindpunt. Hierbij worden eerst de algemene eindpunten
(zai-global, daarna zai-cn) gecontroleerd en vervolgens de Coding Plan-eindpunten
(zai-coding-global, daarna zai-coding-cn). Het proces stopt bij het eerste eindpunt
dat een aanvraag accepteert. Gebruik een expliciete --auth-choice om een Coding Plan-eindpunt
af te dwingen als uw sleutel op beide werkt.
Configuratievoorbeeld
{ env: { ZAI_API_KEY: "sk-..." }, models: { providers: { zai: { // GLM-5.2 gebruikt het Coding Plan-eindpunt. 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 in het Plugin-manifest, zodat een alleen-lezen
vermelding bekende GLM-rijen kan tonen zonder de providerruntime te laden:
openclaw models list --all --provider zaiDe 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 de 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 |
Denkniveaus
GLM-5.2
Volledig bereik: off, low, high, max (standaard off). OpenClaw koppelt
low en high aan de redeneerinspanning high van Z.AI en max aan de inspanning
max van Z.AI, via reasoning_effort in de aanvraagpayload.
Andere GLM-modellen
Alleen een binaire schakelaar: off en low (weergegeven als on in keuzelijsten),
standaard off. Als denken op off wordt ingesteld, wordt
thinking: { type: "disabled" } verzonden; bij elk ander niveau blijft de aanvraagpayload
ongewijzigd (het eigen standaardgedrag voor redeneren van Z.AI is van toepassing).
Door denken op off in te stellen, voorkomt u dat antwoorden het uitvoerbudget aan
reasoning_content besteden voordat zichtbare tekst verschijnt.
Geavanceerde configuratie
Onbekende GLM-5-modellen voorwaarts oplossen
Onbekende glm-5*-id's worden nog steeds voorwaarts opgelost in het providerpad door
metadata die eigendom is van de provider samen te stellen 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. U schakelt dit als volgt uit:
{ agents: { defaults: { models: { "zai/<model>": { params: { tool_stream: false }, }, }, }, },}Behoud van denkwerk
Het behoud van denkwerk moet expliciet worden ingeschakeld, omdat Z.AI vereist dat de
volledige historische reasoning_content opnieuw wordt afgespeeld, wat het aantal
prompttokens verhoogt. 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 OpenAI-compatibele transcript. De
parameternaam preserve_thinking in snake_case 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 bepaald op basis van de geconfigureerde Z.AI-authenticatie; er is geen aanvullende configuratie nodig.
Authenticatiedetails
- Z.AI gebruikt Bearer-authenticatie met uw API-sleutel.
- De onboardingkeuze
zai-api-keydetecteert automatisch het overeenkomende Z.AI-eindpunt door ondersteunde eindpunten met uw sleutel te testen. - Gebruik de expliciete regionale keuzes (
zai-coding-global,zai-coding-cn,zai-global,zai-cn) wanneer u een specifiek API-oppervlak wilt afdwingen. - De verouderde omgevingsvariabele
Z_AI_API_KEYwordt nog steeds geaccepteerd; OpenClaw kopieert deze bij het opstarten naarZAI_API_KEYalsZAI_API_KEYniet is ingesteld.
