OpenClaw 2026 sur macOS : fournisseur GLM (zai), ZAI_API_KEY, Coding Plan, doctor, Mac mini cloud

En 2026, les équipes qui veulent un LLM bilingue et économique à côté d'Anthropic ou d'OpenAI ajoutent souvent GLM, la famille de modèles servie via Z.AI (surface API globale de Zhipu). Sur macOS, OpenClaw l'expose comme runtime zai intégré : refs zai/glm-5.1, HTTP compatible OpenAI, choix d'onboarding Coding Plan vs API générale. Ce guide couvre ZAI_API_KEY, openclaw.json, la bascule modèle, les profils JSON et .env, la gestion du 429 et le diagnostic doctor.

Transparence : MacHTML fournit le service de location de Mac mini cloud mentionné dans cet article.

Sur un Mac mini Apple Silicon loué (tarif public ~16,9 $/jour), vous validez GLM avec le même comportement Node et Keychain qu'en production—notamment via les nœuds MacHTML en Europe et Asie. Référence officielle : documentation OpenClaw GLM.

Pourquoi GLM dans OpenClaw

GLM excelle sur les tours agent chinois-anglais, le raisonnement long contexte et le travail par lots à coût maîtrisé. OpenClaw garde le même chemin d'appel d'outils que les autres fournisseurs compatibles OpenAI. Sur Mac mini cloud, trois usages dominent :

1. Primaire pour les canaux Slack/Telegram à fort contenu CN
2. Secondaire après un 429 Anthropic (quota séparé)
3. Vision via zai/glm-4.6v quand le primaire est texte seul

Faits sur le fournisseur zai

Propriété	Valeur
ID fournisseur	zai
Auth	ZAI_API_KEY ou Z_AI_API_KEY
URL de base par défaut	https://api.z.ai/api/paas/v4
Modèle suggéré	zai/glm-5.1
Modèle image par défaut	zai/glm-4.6v
Forme API	Compatible OpenAI

En Chine continentale, https://open.bigmodel.cn/api/paas/v4 est courant ; les choix zai-cn et zai-coding-cn épinglent le bon quota.

Onboarding et secrets

Ne commitez jamais les clés API. Stockez-les dans ~/.openclaw/.env avec chmod 600.

# Détection auto de l'endpoint depuis la clé
openclaw onboard --auth-choice zai-api-key

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

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

# Vérifier le catalogue
openclaw models list --provider zai

# Modèle agent par défaut
openclaw config set agents.defaults.model.primary "zai/glm-5.1"

Lancez openclaw doctor après chaque changement de secret ou de routage.

Squelette openclaw.json

{
  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 }
  }
}

Les noms de champs évoluent entre versions—comparez avec votre build OpenClaw avant déploiement.

Coding Plan vs API générale

auth-choice	Usage
zai-api-key	Auto-détection endpoint
zai-coding-global	Coding Plan (global)
zai-coding-cn	Coding Plan (Chine)
zai-global	API générale (global)
zai-cn	API générale (Chine)

Symptôme : HTTP 429 « solde insuffisant » alors que le quota Coding Plan reste disponible—souvent le trafic part vers l'API générale au lieu de /api/coding/paas/v4. Relancez l'onboarding avec zai-coding-*.

Catalogue de modèles

Exécutez openclaw models list --provider zai pour le catalogue live. Refs courantes en 2026 :

Ref modèle	Cas d'usage
zai/glm-5.1	Raisonnement par défaut, contexte 202k
zai/glm-5v-turbo	Raisonnement + entrée image
zai/glm-4.7-flash	Bots internes basse latence
zai/glm-4.6v	Modèle vision par défaut

En chaîne de bascule : plafond ~45 s par fournisseur et ~120 s par tour.

Bascule et compatibilité outils

GLM dans une chaîne doit accepter le même schéma JSON d'outils que le primaire. Avant la prod, exécutez trois appels outils (lecture, patch, liste) sur zai/glm-5.1 en staging. Retirez les parties image lors d'une bascule vers une variante texte seul. Voir l'article bascule modèle et routage.

Checklist de staging macOS

1. Exporter l'empreinte openclaw.json (sans secrets) hors git
2. Onboarder zai avec le bon auth-choice régional
3. openclaw models list --provider zai — au moins 1 ligne GLM
4. Chat synthétique + smoke outils sur le port staging
5. Simuler une panne primaire ; GLM répond en 10 s
6. Promouvoir le LaunchAgent après 24 h de métriques propres

Louer un Mac mini via MacHTML (~16,9 $/jour) évite un shim Linux et aligne les tests GLM sur macOS réel.

FAQ

GLM est-il le nom de l'entreprise Zhipu ?

Non—GLM est la famille de modèles ; facturation et clés sur Z.AI / BigModel.

Quelle variable d'environnement ?

Préférez ZAI_API_KEY ; Z_AI_API_KEY est un alias accepté.

GLM peut-il remplacer Anthropic pour les outils destructifs ?

Seulement après tests de schéma d'outils et revue de politique human-in-the-loop.

Fréquence de doctor ?

À chaque changement zai (secret, endpoint, modèle par défaut) et chaque semaine en production.