Providers
Z.AI
Z.AI ist die API-Plattform für GLM-Modelle. Sie stellt REST-APIs für GLM bereit und
verwendet API-Schlüssel zur Authentifizierung. Erstellen Sie Ihren API-Schlüssel in der Z.AI-Konsole.
OpenClaw verwendet den Provider zai mit einem Z.AI-API-Schlüssel.
| Eigenschaft | Wert |
|---|---|
| Provider | zai |
| Paket | @openclaw/zai-provider |
| Auth | ZAI_API_KEY (Legacy-Alias: Z_AI_API_KEY) |
| API | Z.AI Chat Completions (Bearer-Auth) |
GLM-Modelle
GLM ist eine Modellfamilie, kein separater Provider. In OpenClaw verwenden GLM-Modelle
Refs wie zai/glm-5.2: Provider zai, Modell-ID glm-5.2.
Erste Schritte
Installieren Sie zuerst das Provider-Plugin:
openclaw plugins install @openclaw/zai-providerAuto-detect endpoint
Am besten geeignet für: die meisten Benutzer. OpenClaw prüft unterstützte Z.AI-Endpunkte mit Ihrem API-Schlüssel und wendet automatisch die richtige Basis-URL an.
Run onboarding
openclaw onboard --auth-choice zai-api-keyVerify the model is listed
openclaw models list --all --provider zaiExplicit regional endpoint
Am besten geeignet für: Benutzer, die einen bestimmten Coding Plan oder eine allgemeine API-Oberfläche erzwingen möchten.
Pick the right onboarding choice
# 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-cnVerify the model is listed
openclaw models list --all --provider zaiKonfigurationsbeispiel
{ 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" } } },}Integrierter Katalog
Das Provider-Plugin zai liefert seinen Katalog im Plugin-Manifest aus, sodass
schreibgeschützte Auflistungen bekannte GLM-Zeilen anzeigen können, ohne die Provider-Laufzeit zu laden:
openclaw models list --all --provider zaiDer manifestgestützte Katalog enthält derzeit:
| Modell-Ref | Hinweise |
|---|---|
zai/glm-5.2 |
Standard für Coding Plan; 1M-Kontext |
zai/glm-5.1 |
Standard für allgemeine 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 |
Erweiterte Konfiguration
Forward-resolving unknown GLM-5 models
Unbekannte glm-5*-IDs werden im Provider-Pfad weiterhin vorwärts aufgelöst, indem
Provider-eigene Metadaten aus der Vorlage glm-4.7 synthetisiert werden, wenn die ID
der aktuellen Form der GLM-5-Familie entspricht.
Tool-call streaming
tool_stream ist für Z.AI-Tool-Call-Streaming standardmäßig aktiviert. So deaktivieren Sie es:
{ agents: { defaults: { models: { "zai/<model>": { params: { tool_stream: false }, }, }, }, },}Thinking and preserved thinking
Das Denken von Z.AI folgt den /think-Steuerungen von OpenClaw. Wenn Denken deaktiviert ist,
sendet OpenClaw thinking: { type: "disabled" }, um Antworten zu vermeiden, die
das Ausgabebudget für reasoning_content vor sichtbarem Text verbrauchen.
Beibehaltenes Denken ist Opt-in, weil Z.AI verlangt, dass der gesamte historische
reasoning_content erneut abgespielt wird, was Prompt-Token erhöht. Aktivieren Sie es
pro Modell:
{ agents: { defaults: { models: { "zai/glm-5.2": { params: { preserveThinking: true }, }, }, }, },}Wenn es aktiviert ist und Denken eingeschaltet ist, sendet OpenClaw
thinking: { type: "enabled", clear_thinking: false } und spielt vorherigen
reasoning_content für dasselbe OpenAI-kompatible Transkript erneut ab.
Fortgeschrittene Benutzer können die exakte Provider-Nutzlast weiterhin mit
params.extra_body.thinking überschreiben.
Image understanding
Das Z.AI-Plugin registriert Bildverständnis.
| Eigenschaft | Wert |
|---|---|
| Modell | glm-4.6v |
Bildverständnis wird automatisch aus der konfigurierten Z.AI-Authentifizierung aufgelöst; es ist keine zusätzliche Konfiguration erforderlich.
Auth details
- Z.AI verwendet Bearer-Auth mit Ihrem API-Schlüssel.
- Die Onboarding-Option
zai-api-keyerkennt den passenden Z.AI-Endpunkt automatisch, indem unterstützte Endpunkte mit Ihrem Schlüssel geprüft werden. - Verwenden Sie die expliziten regionalen Optionen (
zai-coding-global,zai-coding-cn,zai-global,zai-cn), wenn Sie eine bestimmte API-Oberfläche erzwingen möchten. - Die Legacy-Umgebungsvariable
Z_AI_API_KEYwird weiterhin akzeptiert; OpenClaw kopiert sie beim Start nachZAI_API_KEY, wennZAI_API_KEYnicht gesetzt ist.
