OpenClaw 2026 auf macOS: GLM (Zhipu Z.AI)—zai-Provider, Coding Plan, openclaw.json und Cloud-Mac-mini-Staging

Wer neben Anthropic oder OpenAI ein zweisprachiges, kostenbewusstes LLM betreiben will, ergänzt oft GLM—die Modellfamilie über Z.AI (Zhipus globale API-Oberfläche). In OpenClaw auf macOS in 2026 ist GLM kein Sonderfall: Der gebündelte Laufzeit-Provider zai liefert Refs wie zai/glm-5.1, OpenAI-kompatibles HTTP und Onboarding-Optionen, die Coding Plan vs. allgemeine API-Regionen festnageln. Dieses Tutorial führt Schlüssel, openclaw.json, Failover-Paarung und openclaw doctor auf einem gemieteten Apple Silicon Mac mini durch (laut MacHTML-Preisliste ab ca. 16,9 $/Tag).

Hinweis: MacHTML stellt den in diesem Artikel genannten Cloud-Mac-mini-Mietdienst bereit.

Kombinieren Sie den Leitfaden mit Modell-Failover-Routing, JSON- und Umgebungsprofilen, 429-Retry-Disziplin und doctor-Diagnostik, damit GLM in eine dokumentierte Kette rutscht—nicht als Einmal-Experiment.

Warum GLM in OpenClaw

GLM-Modelle eignen sich für Chinesisch–Englisch-gemischte Agent-Turns, Long-Context-Reasoning und preissensibles Batch-Processing. OpenClaw bindet sie über zai mit demselben Tool-Calling-Pfad wie andere OpenAI-kompatible Anbieter. Teams auf einem Cloud-Mac-mini nutzen GLM typischerweise als:

1. Primär für CN-lastige Slack- oder Telegram-Kanäle
2. Sekundär nach Anthropic-429 (separates Kontingent)
3. Vision über zai/glm-4.6v, wenn das Primärmodell nur Text liefert

Offizielle Referenz: OpenClaw GLM-Provider-Dokumentation und die Z.AI-Plattform.

Provider-Fakten (zai)

Eigenschaft	Wert
Provider-ID	zai
Auth-Umgebungsvariablen	ZAI_API_KEY oder Z_AI_API_KEY
Standard-Base-URL	https://api.z.ai/api/paas/v4
Empfohlenes Standardmodell	zai/glm-5.1
Standard-Bildmodell	zai/glm-4.6v
API-Form	OpenAI-kompatibel

Entwickler in Festlandchina nutzen oft https://open.bigmodel.cn/api/paas/v4 (dokumentiert auf Zhipu BigModel); OpenClaws zai-cn- und zai-coding-cn-Onboarding pinnt die richtige Oberfläche, damit Sie nicht das falsche Kontingent verbrennen.

Onboarding und Geheimnisse

API-Schlüssel nie committen. In ~/.openclaw/.env mit chmod 600 ablegen.

# Generischer Schlüssel — OpenClaw erkennt Endpunkt an Schlüsselform
openclaw onboard --auth-choice zai-api-key

# Coding Plan erzwingen (global)
openclaw onboard --auth-choice zai-coding-global

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

# Katalog prüfen
openclaw models list --provider zai

Standard-Agentenmodell setzen:

openclaw config set agents.defaults.model.primary "zai/glm-5.1"

Nach jeder Secret- oder Routing-Änderung openclaw doctor ausführen.

openclaw.json-Gerüst

{
  env: { ZAI_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: {
        primary: "zai/glm-5.1",
        fallbacks: ["anthropic/claude-sonnet-4", "openai/gpt-4.1-mini"]
      }
    }
  },
  providers: {
    zai: { timeoutMs: 45000 }
  }
}

Feldnamen ändern sich zwischen Releases—vor dem Einfügen gegen Ihre installierte OpenClaw-Version diffen. Details zu Profilen: JSON- und .env-Artikel.

Coding Plan vs. allgemeine API

Auth-Wahl	Einsatz
zai-api-key	Endpunkt automatisch aus Schlüssel
zai-coding-global	Coding Plan (global)
zai-coding-cn	Coding Plan (China)
zai-global	Allgemeine API (global)
zai-cn	Allgemeine API (China)

Symptom: HTTP 429 mit „insufficient balance“, obwohl Coding-Plan-Kontingent da ist—meist trifft Traffic den allgemeinen statt den Coding-Plan-Pfad (/api/coding/paas/v4). Onboarding mit explizitem zai-coding-* wiederholen; Retry-Budgets siehe 429-Artikel.

Modellkatalog

openclaw models list --provider zai liefert den Live-Katalog. Übliche Refs (2026):

Modell-Ref	Einsatz
zai/glm-5.1	Standard-Reasoning, 202k Kontext
zai/glm-5v-turbo	Reasoning + Bildeingabe
zai/glm-4.7-flash	Geringere Latenz für interne Bots
zai/glm-4.6v	Standard-Vision-Modell

Pro Anbieterversuch nahe 45 s und Gesamt-Turn-Budget nahe 120 s kappen, wenn GLM in einer Failover-Kette sitzt—siehe Failover-Leitfaden.

Failover und Tool-Kompatibilität

GLM in einer Fallback-Kette muss dasselbe JSON-Tool-Schema akzeptieren wie Ihr Primärmodell. Drei feste Tool-Aufrufe—Datei lesen, Patch schreiben, Verzeichnis listen—gegen zai/glm-5.1 im Staging, bevor Sie in Produktion gehen. Bildteile entfernen, wenn Sie auf text-only GLM-Varianten failovern.

macOS-Staging-Checkliste

1. Fingerabdruck von openclaw.json (ohne Secrets) in git-ignorierten Speicher exportieren.
2. zai mit der passenden regionalen Auth-Wahl onboarden.
3. openclaw models list --provider zai — mindestens 1 GLM-Zeile bestätigen.
4. Synthetischer Chat + Tool-Smoke auf dem Staging-Port.
5. Primärausfall simulieren; GLM-Antwort innerhalb 10 s erwarten.
6. LaunchAgent erst nach 24 h sauberer Metriken promoten.

Ein Apple Silicon Mac mini über MacHTML hält GLM-Tests auf denselben Node- und Keychain-Pfaden wie Produktion—kein Linux-Shim. Nach der Übung Instanz stoppen; Routing-Tabellen bleiben dokumentiert, CapEx über 36 Monate nicht.

FAQ

Ist GLM dasselbe wie der Firmenname Zhipu?

Nein—GLM ist die Modellfamilie; Abrechnung und Keys laufen über Z.AI / BigModel.

Welche Umgebungsvariable?

ZAI_API_KEY bevorzugen; Z_AI_API_KEY ist Alias.

Kann GLM Anthropic für destruktive Tools ersetzen?

Nur nach Tool-Schema-Smoke-Tests und Human-in-the-Loop-Policy-Review.

Wie oft doctor?

Nach jeder zai-Secret-, Endpunkt- oder Default-Modell-Änderung—wöchentlich in Produktion; Details in doctor-Artikel.