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`
Authentifizierung	`ZAI_API_KEY` (veralteter Alias: `Z_AI_API_KEY`)
API	Z.AI Chat Completions (Bearer-Authentifizierung)

GLM-Modelle

GLM ist eine Modellfamilie und kein separater Provider. In OpenClaw verwenden GLM-Modelle Referenzen wie zai/glm-5.2: Provider zai, Modell-ID glm-5.2.

Erste Schritte

Installieren Sie zunächst das Provider-Plugin:

openclaw plugins install @openclaw/zai-provider

Endpunkt automatisch erkennen
Expliziter regionaler Endpunkt

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 korrekte Basis-URL an.

Onboarding ausführen

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

Prüfen, ob das Modell aufgeführt ist

openclaw models list --all --provider zai

Am besten geeignet für: Benutzer, die eine bestimmte Coding-Plan- oder allgemeine API-Oberfläche erzwingen möchten.

Die richtige Onboarding-Auswahl treffen

# Coding Plan Global (für Coding-Plan-Benutzer empfohlen)
openclaw onboard --auth-choice zai-coding-global

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

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

# Allgemeine API CN (Region China)
openclaw onboard --auth-choice zai-cn

Prüfen, ob das Modell aufgeführt ist

openclaw models list --all --provider zai

Endpunkte

Onboarding-Auswahl	Basis-URL	Standardmodell
`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 veröffentlicht außerdem die Anthropic-kompatible Coding-Plan-Basis-URL https://api.z.ai/api/anthropic. Die Z.AI-Auswahlmöglichkeiten von OpenClaw verwenden die oben dokumentierten OpenAI-Chat-Completions-Endpunkte; die Anthropic-URL ist für Clients vorgesehen, die direkt über Anthropic Messages kommunizieren. zai-api-key erkennt automatisch einen dieser vier Endpunkte, indem Ihr Schlüssel mit der Chat-Completions-API jedes Endpunkts geprüft wird. Dabei werden zuerst die allgemeinen Endpunkte (zai-global, danach zai-cn) und anschließend die Coding-Plan-Endpunkte (zai-coding-global, danach zai-coding-cn) geprüft. Die Prüfung endet beim ersten Endpunkt, der eine Anfrage akzeptiert. Verwenden Sie eine explizite Auswahl --auth-choice, um einen Coding-Plan-Endpunkt zu erzwingen, wenn Ihr Schlüssel mit beiden funktioniert.

Ratenbegrenzungen und Überlastungen

Z.AI beschreibt den Coding Plan und die allgemeinen Agent-Tools als Dienste mit verwalteter Kapazität. Laut der Z.AI-Dokumentation:

Allgemeine Agent-Tools, einschließlich OpenClaw, werden nach dem Best-Effort-Prinzip bereitgestellt. Bei hoher Inferenzlast, üblicherweise zwischen 14 und 18 Uhr Singapur-Zeit, können einige Anfragen vorübergehend von Ratenbegrenzungen betroffen sein.
Raten- und Parallelitätsbegrenzungen des Coding Plan sind an die Tarifstufe gebunden und können abhängig von der Ressourcenverfügbarkeit dynamisch angepasst werden. Außerhalb der Spitzenzeiten kann eine höhere Parallelität verfügbar sein.
API-Fehlercode 1302 bedeutet „Ratenbegrenzung für Anfragen erreicht“. API-Fehlercode 1305 bedeutet „Der Dienst ist möglicherweise vorübergehend überlastet. Versuchen Sie es später erneut“.

Wenn während einer stark ausgelasteten Zeit vorübergehend eine Antwort 429 oder 1305 angezeigt wird, warten Sie und wiederholen Sie die Anfrage. Wenn die Fehler außerhalb der Spitzenzeiten reproduzierbar sind oder nur bei einem bestimmten Endpunkt, Modell oder Anfrageformat auftreten, prüfen Sie zunächst den konfigurierten Endpunkt und das Modell:

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

Coding-Plan-Schlüssel sollten einen Coding-Plan-Endpunkt wie https://api.z.ai/api/coding/paas/v4 verwenden; allgemeine API-Schlüssel sollten einen allgemeinen API-Endpunkt wie https://api.z.ai/api/paas/v4 verwenden. Dauerhafte Fehler mit demselben Schlüssel und Endpunkt können auf eine Ablehnung durch den Provider oder eine Tarifbeschränkung hindeuten und nicht auf eine gewöhnliche Drosselung aufgrund von Spitzenlast.

Konfigurationsbeispiel

Mit zai-api-key kann OpenClaw anhand des Schlüssels den passenden Z.AI-Endpunkt erkennen und automatisch die korrekte Basis-URL anwenden. Verwenden Sie die expliziten regionalen Auswahlmöglichkeiten, wenn Sie eine bestimmte Coding-Plan- oder allgemeine API-Oberfläche erzwingen möchten.

{
  env: { ZAI_API_KEY: "sk-..." },
  models: {
    providers: {
      zai: {
        // GLM-5.2 verwendet den Coding-Plan-Endpunkt.
        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 die schreibgeschützte Auflistung bekannte GLM-Zeilen anzeigen kann, ohne die Provider-Laufzeit zu laden:

openclaw models list --all --provider zai

Der manifestbasierte Katalog enthält derzeit:

Modellreferenz	Hinweise
`zai/glm-5.2`	Coding-Plan-Standard; 1M Kontext
`zai/glm-5.1`	Standard der allgemeinen 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`

Die Metadaten zu Token-Kosten im Katalog entsprechen den aktuellen nutzungsabhängigen Preisen von Z.AI. Coding-Plan- Abonnements verwenden ein Tarifkontingent anstelle einer Abrechnung pro Token; aktuelle Tarifpreise und die Verfügbarkeit finden Sie auf der Abonnementseite.

GLM-Modelle sind als zai/<model> verfügbar (Beispiel: zai/glm-5).

Die Coding-Plan-Einrichtung verwendet standardmäßig zai/glm-5.2; bei der Einrichtung der allgemeinen API bleibt zai/glm-5.1 erhalten. An den Coding-Plan-Endpunkten greift die automatische Erkennung auf glm-5.1 und anschließend auf glm-4.7 zurück, wenn GLM-5.2 für den Schlüssel oder Tarif nicht verfügbar ist. GLM- Versionen und ihre Verfügbarkeit können sich ändern; führen Sie openclaw models list --all --provider zai aus, um den Ihrer installierten Version bekannten Katalog anzuzeigen.

Thinking-Stufen

GLM-5.2
Andere GLM-Modelle

Vollständiger Bereich: off, low, high, max (Standard: off). OpenClaw ordnet low und high dem Reasoning-Aufwand high von Z.AI und max dem Aufwand max von Z.AI zu, und zwar über reasoning_effort in der Anfrage-Nutzlast.

Nur binärer Umschalter: off und low (in Auswahlfeldern als on angezeigt), Standard: off. Wird Thinking auf off gesetzt, wird thinking: { type: "disabled" } gesendet; bei jeder anderen Stufe bleibt die Anfrage-Nutzlast unverändert (es gilt das eigene standardmäßige Reasoning-Verhalten von Z.AI).

Wenn Thinking auf off gesetzt wird, werden Antworten vermieden, die das Ausgabebudget für reasoning_content aufbrauchen, bevor sichtbarer Text ausgegeben wird.

Erweiterte Konfiguration

Unbekannte GLM-5-Modelle vorwärtsauflösen

Unbekannte glm-5*-IDs werden im Provider-Pfad weiterhin vorwärtsaufgelöst, indem Provider-eigene Metadaten aus der Vorlage glm-4.7 erzeugt werden, wenn die ID dem aktuellen Format der GLM-5-Familie entspricht.

Tool-Call-Streaming

tool_stream ist standardmäßig für das Tool-Call-Streaming von Z.AI aktiviert. So deaktivieren Sie es:

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

Beibehaltenes Thinking

Beibehaltenes Thinking muss explizit aktiviert werden, da Z.AI die Wiedergabe des vollständigen historischen reasoning_content erfordert, wodurch sich die Anzahl der Prompt-Token erhöht. Aktivieren Sie es pro Modell:

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

Wenn es aktiviert und Thinking eingeschaltet ist, sendet OpenClaw thinking: { type: "enabled", clear_thinking: false } und gibt frühere reasoning_content für dasselbe OpenAI-kompatible Transkript wieder. Der snake_case- Parameterschlüssel preserve_thinking funktioniert als Alias.Fortgeschrittene Benutzer können die genaue Provider-Nutzlast weiterhin mit params.extra_body.thinking überschreiben.

Bildverständnis

Das Z.AI-Plugin registriert Bildverständnis.

Eigenschaft	Wert
Modell	`glm-4.6v`

Das Bildverständnis wird automatisch anhand der konfigurierten Z.AI-Authentifizierung aufgelöst — es ist keine zusätzliche Konfiguration erforderlich.

Authentifizierungsdetails

Z.AI verwendet die Bearer-Authentifizierung mit Ihrem API-Schlüssel.
Die Onboarding-Auswahl zai-api-key erkennt den passenden Z.AI-Endpunkt automatisch, indem unterstützte Endpunkte mit Ihrem Schlüssel geprüft werden.
Verwenden Sie die expliziten regionalen Auswahlmöglichkeiten (zai-coding-global, zai-coding-cn, zai-global, zai-cn), wenn Sie eine bestimmte API-Oberfläche erzwingen möchten.
Die veraltete Umgebungsvariable Z_AI_API_KEY wird weiterhin akzeptiert; OpenClaw kopiert sie beim Start nach ZAI_API_KEY, wenn ZAI_API_KEY nicht gesetzt ist.

Modellauswahl

Auswahl von Providern, Modellreferenzen und Failover-Verhalten.

Konfigurationsreferenz

Vollständiges OpenClaw-Konfigurationsschema einschließlich Provider- und Modelleinstellungen.

Overview

Concepts and configuration

Providers

GLM-Modelle

Erste Schritte

Endpunkte

Ratenbegrenzungen und Überlastungen

Konfigurationsbeispiel

Integrierter Katalog

Thinking-Stufen

Erweiterte Konfiguration

Verwandte Themen

Modellauswahl

Konfigurationsreferenz

​GLM-Modelle

​Erste Schritte

​Endpunkte

​Ratenbegrenzungen und Überlastungen

​Konfigurationsbeispiel

​Integrierter Katalog

​Thinking-Stufen

​Erweiterte Konfiguration

​Verwandte Themen

Modellauswahl

Konfigurationsreferenz

GLM-Modelle

Erste Schritte

Endpunkte

Ratenbegrenzungen und Überlastungen

Konfigurationsbeispiel

Integrierter Katalog

Thinking-Stufen

Erweiterte Konfiguration

Verwandte Themen