Passer au contenu principal
Z.AI est la plateforme d’API pour les modèles GLM. Elle fournit des API REST pour GLM et utilise des clés d’API pour l’authentification. Créez votre clé d’API dans la console Z.AI. OpenClaw utilise le provider zai avec une clé d’API Z.AI.
PropriétéValeur
Providerzai
Package@openclaw/zai-provider
AuthZAI_API_KEY (alias hérité : Z_AI_API_KEY)
APIChat Completions Z.AI (authentification Bearer)

​
Modèles GLM

GLM est une famille de modèles, pas un provider distinct. Dans OpenClaw, les modèles GLM utilisent des références comme zai/glm-5.2 : provider zai, identifiant de modèle glm-5.2.

​
Premiers pas

Installez d’abord le Plugin provider : 
openclaw plugins install @openclaw/zai-provider
Idéal pour : la plupart des utilisateurs. OpenClaw sonde les points de terminaison Z.AI pris en charge avec votre clé d’API et applique automatiquement l’URL de base correcte.
1

Exécuter l’onboarding

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

Vérifier que le modèle est listé

openclaw models list --all --provider zai

​
Exemple de configuration

zai-api-key permet à OpenClaw de détecter le point de terminaison Z.AI correspondant à partir de la clé et d’appliquer automatiquement l’URL de base correcte. Utilisez les options régionales explicites lorsque vous voulez forcer un Coding Plan spécifique ou une surface d’API générale.
{
  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" } } },
}

​
Catalogue intégré

Le Plugin provider zai livre son catalogue dans le manifeste du Plugin, ce qui permet à une liste en lecture seule d’afficher les lignes GLM connues sans charger le runtime du provider : 
openclaw models list --all --provider zai
Le catalogue adossé au manifeste inclut actuellement :
Référence du modèleNotes
zai/glm-5.2Valeur par défaut du Coding Plan ; contexte 1M
zai/glm-5.1Valeur par défaut de l’API générale
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
Les modèles GLM sont disponibles sous la forme zai/<model> (exemple : zai/glm-5).
GLM-5.2 prend en charge les niveaux de réflexion off, low, high et max. OpenClaw mappe low et high vers l’effort de raisonnement élevé de Z.AI, et max vers l’effort maximal.
La configuration du Coding Plan utilise zai/glm-5.2 par défaut ; la configuration de l’API générale conserve zai/glm-5.1. La détection automatique du point de terminaison revient à glm-5.1 ou glm-4.7 lorsque le plan sélectionné n’expose pas GLM-5.2. Les versions et la disponibilité de GLM peuvent changer ; exécutez openclaw models list --all --provider zai pour voir le catalogue connu de votre version installée.

​
Configuration avancée

Les identifiants glm-5* inconnus se résolvent tout de même de manière prospective sur le chemin du provider en synthétisant des métadonnées détenues par le provider à partir du modèle glm-4.7 lorsque l’identifiant correspond à la forme actuelle de la famille GLM-5.
tool_stream est activé par défaut pour la diffusion en continu des appels d’outils Z.AI. Pour le désactiver :
{
  agents: {
    defaults: {
      models: {
        "zai/<model>": {
          params: { tool_stream: false },
        },
      },
    },
  },
}
La réflexion Z.AI suit les contrôles /think d’OpenClaw. Lorsque la réflexion est désactivée, OpenClaw envoie thinking: { type: "disabled" } afin d’éviter les réponses qui consomment le budget de sortie avec reasoning_content avant le texte visible.La réflexion préservée est optionnelle, car Z.AI exige que l’intégralité de l’historique reasoning_content soit relue, ce qui augmente les tokens de prompt. Activez-la par modèle :
{
  agents: {
    defaults: {
      models: {
        "zai/glm-5.2": {
          params: { preserveThinking: true },
        },
      },
    },
  },
}
Lorsqu’elle est activée et que la réflexion est active, OpenClaw envoie thinking: { type: "enabled", clear_thinking: false } et relit le précédent reasoning_content pour le même transcript compatible OpenAI.Les utilisateurs avancés peuvent toujours remplacer exactement la charge utile du provider avec params.extra_body.thinking.
Le Plugin Z.AI enregistre la compréhension des images.
PropriétéValeur
Modèleglm-4.6v
La compréhension des images est résolue automatiquement à partir de l’authentification Z.AI configurée ; aucune configuration supplémentaire n’est nécessaire.
  • Z.AI utilise l’authentification Bearer avec votre clé d’API.
  • L’option d’onboarding zai-api-key détecte automatiquement le point de terminaison Z.AI correspondant en sondant les points de terminaison pris en charge avec votre clé.
  • Utilisez les options régionales explicites (zai-coding-global, zai-coding-cn, zai-global, zai-cn) lorsque vous voulez forcer une surface d’API spécifique.
  • La variable d’environnement héritée Z_AI_API_KEY est toujours acceptée ; OpenClaw la copie vers ZAI_API_KEY au démarrage si ZAI_API_KEY n’est pas défini.

​
Associé

Sélection du modèle

Choisir les providers, les références de modèles et le comportement de basculement.

Référence de configuration

Schéma complet de configuration OpenClaw, y compris les paramètres de provider et de modèle.