Z.AI

Z.AI est la plateforme API pour les modèles GLM. Elle fournit des API REST pour GLM et utilise des clés API pour l’authentification. Créez votre clé API dans la console Z.AI. OpenClaw utilise le fournisseur APIGLMGLMAPIAPIOpenClawzaiAPI avec une clé API Z.AI.

Propriété	Valeur
Fournisseur	`zai`
Auth	`ZAI_API_KEY` (alias legacy : `Z_AI_API_KEY`)
API	Z.AI Chat Completions (auth Bearer)

Modèles GLM

GLM est une famille de modèles, pas un fournisseur distinct. Dans OpenClaw, les modèles GLM utilisent des références telles que GLMOpenClawGLMzai/glm-5.1 : fournisseur zai, id de modèle glm-5.1.

Getting started

Idéal pour : la plupart des utilisateurs. OpenClaw sonde les points de terminaison Z.AI pris en charge avec votre clé API et applique l’URL de base correcte automatiquement.

Run onboarding

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

Verify the model is listed

openclaw models list --all --provider zai

Idéal pour : les utilisateurs qui souhaitent forcer un plan de codage spécifique ou une surface API générale.

Pick the right onboarding choice

# Coding Plan Global (recommended for Coding Plan users)
openclaw onboard --auth-choice zai-coding-global

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

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

# General API CN (China region)
openclaw onboard --auth-choice zai-cn

Verify the model is listed

openclaw models list --all --provider zai

Config example

{
  env: { ZAI_API_KEY: "sk-..." },
  models: {
    providers: {
      zai: {
        // Example value. Onboarding writes the matching baseUrl for your endpoint.
        baseUrl: "https://api.z.ai/api/paas/v4",
      },
    },
  },
  agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
}

Catalogue intégré

OpenClaw fournit le catalogue de provider OpenClawzai groupé dans le manifeste du plugin, de sorte que la liste en lecture seule peut afficher les lignes GLM connues sans charger le runtime du provider :

openclaw models list --all --provider zai

Le catalogue basé sur le manifeste inclut actuellement :

Réf de model	Notes
`zai/glm-5.1`	Model par défaut
`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`

Configuration avancée

Résolution directe des models GLM-5 inconnus

Les ids glm-5* inconnus sont encore résolus directement sur le chemin du provider groupé en synthétisant les métadonnées appartenant au provider à partir du modèle glm-4.7 lorsque l’id correspond à la forme actuelle de la famille GLM-5.

Streaming des appels d'outil

tool_stream est activé par défaut pour le streaming des appels d’outil Z.AI. Pour le désactiver :

{
  agents: {
    defaults: {
      models: {
        "zai/

”: { params: { tool_stream: false }, }, }, }, }, } ```

Thinking and preserved thinking

La réflexion de Z.AI suit les contrôles /thinkOpenClaw d’OpenClaw. Avec la réflexion désactivée, OpenClaw envoie thinking: { type: "disabled" } pour éviter les réponses qui dépensent le budget de sortie sur 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 de reasoning_content soit rejoué, ce qui augmente les jetons de prompt. Activez-la par modèle :

{
  agents: {
    defaults: {
      models: {
        "zai/glm-5.1": {
          params: { preserveThinking: true },
        },
      },
    },
  },
}
```OpenClaw

Lorsqu'elle est activée et que la réflexion est activée, OpenClaw envoie
`thinking: { type: "enabled", clear_thinking: false }` et rejoue le `reasoning_content`OpenAI
précédent pour la même transcription compatible OpenAI.

Les utilisateurs avancés peuvent toujours remplacer la charge utile exacte du provider avec
`params.extra_body.thinking`.

Image understanding

Le plugin Z.AI inclus enregistre la compréhension d’image.

Property	Value
Modèle	`glm-4.6v`

La compréhension d’image est résolue automatiquement à partir de l’authentification Z.AI configurée — aucune configuration supplémentaire n’est nécessaire.

<Accordion title=“Auth details”API> - Z.AI utilise l’authentification Bearer avec votre clé API. - Le choix 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 choix régionaux explicites (zai-coding-global, zai-coding-cn, zai-global, zai-cnAPI) lorsque vous souhaitez forcer une surface API spécifique. - La variable d’environnement (env var) héritée Z_AI_API_KEYOpenClaw est toujours acceptée ; OpenClaw la copie vers ZAI_API_KEY au démarrage si ZAI_API_KEY n’est pas défini.

Connexes

Sélection du modèle

Choix des providers, des références de modèles et du comportement de basculement.

Référence de configuration

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