Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Z.AI ist die API-Plattform für GLM-Modelle. Sie stellt REST-APIs für GLM bereit und verwendet API-Schlüssel für die Authentifizierung. Erstellen Sie Ihren API-Schlüssel in der Z.AI-Konsole. OpenClaw verwendet den zai-Provider mit einem Z.AI-API-Schlüssel.
  • Provider: zai
  • Authentifizierung: ZAI_API_KEY
  • API: Z.AI Chat Completions (Bearer-Authentifizierung)

​
Erste Schritte

Am besten für: die meisten Nutzer. OpenClaw erkennt den passenden Z.AI-Endpoint aus dem Schlüssel und wendet automatisch die richtige Basis-URL an.
1

Onboarding ausführen

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

Ein Standardmodell festlegen

{
  env: { ZAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
}
3

Prüfen, ob das Modell aufgelistet ist

openclaw models list --all --provider zai

​
Integrierter Katalog

OpenClaw liefert den gebündelten zai-Provider-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 zai
Der manifestgestützte Katalog enthält derzeit:
ModellreferenzHinweise
zai/glm-5.1Standardmodell
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-Modelle sind als zai/<model> verfügbar (Beispiel: zai/glm-5). Die standardmäßig gebündelte Modellreferenz ist zai/glm-5.1.

​
Erweiterte Konfiguration

Unbekannte glm-5*-IDs werden im gebündelten Provider-Pfad weiterhin vorwärtsaufgelöst, indem Provider-eigene Metadaten aus der glm-4.7-Vorlage synthetisiert werden, wenn die ID der aktuellen Form der GLM-5-Familie entspricht.
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 },
        },
      },
    },
  },
}
Z.AI-Thinking folgt den /think-Steuerungen von OpenClaw. Wenn Thinking ausgeschaltet ist, sendet OpenClaw thinking: { type: "disabled" }, um Antworten zu vermeiden, die das Ausgabebudget für reasoning_content vor sichtbarem Text verbrauchen.Beibehaltenes Thinking ist Opt-in, da Z.AI verlangt, dass der vollständige historische reasoning_content erneut abgespielt wird, was die Prompt-Tokens erhöht. Aktivieren Sie es pro Modell:
{
  agents: {
    defaults: {
      models: {
        "zai/glm-5.1": {
          params: { preserveThinking: true },
        },
      },
    },
  },
}
Wenn es aktiviert ist und Thinking eingeschaltet ist, sendet OpenClaw thinking: { type: "enabled", clear_thinking: false } und spielt vorherigen reasoning_content für dasselbe OpenAI-kompatible Transkript erneut ab.Fortgeschrittene Nutzer können die exakte Provider-Payload weiterhin mit params.extra_body.thinking überschreiben.
Das gebündelte Z.AI-Plugin registriert Bildverständnis.
EigenschaftWert
Modellglm-4.6v
Bildverständnis wird automatisch aus der konfigurierten Z.AI-Authentifizierung aufgelöst; es ist keine zusätzliche Konfiguration erforderlich.
  • Z.AI verwendet Bearer-Authentifizierung mit Ihrem API-Schlüssel.
  • Die Onboarding-Auswahl zai-api-key erkennt den passenden Z.AI-Endpoint automatisch aus dem Schlüsselpräfix.
  • Verwenden Sie die expliziten regionalen Auswahlen (zai-coding-global, zai-coding-cn, zai-global, zai-cn), wenn Sie eine bestimmte API-Oberfläche erzwingen möchten.

​
Verwandte Themen

GLM-Modellfamilie

Überblick über die Modellfamilie für GLM.

Modellauswahl

Provider, Modellreferenzen und Failover-Verhalten auswählen.