OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Z.AI

Z.AI est la plateforme d’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 zai avec une clé API Z.AI.

Propriété Valeur
Fournisseur zai
Paquet @openclaw/zai-provider
Authentification ZAI_API_KEY (ancien alias : Z_AI_API_KEY)
API Chat Completions de Z.AI (authentification Bearer)

Modèles GLM

GLM est une famille de modèles, et non un fournisseur distinct. Dans OpenClaw, les modèles GLM utilisent des références telles que zai/glm-5.2 : fournisseur zai, identifiant de modèle glm-5.2.

Prise en main

Installez d’abord le Plugin du fournisseur :

bash
openclaw plugins install @openclaw/zai-provider

Détection automatique du point de terminaison

Recommandé pour : la plupart des utilisateurs. OpenClaw teste les points de terminaison Z.AI pris en charge avec votre clé API et applique automatiquement l’URL de base appropriée.

  • Exécuter la configuration initiale

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

  • Vérifier que le modèle figure dans la liste

    bash
    openclaw models list --all --provider zai

    • Point de terminaison régional explicite

    Recommandé pour : les utilisateurs qui souhaitent imposer une offre Coding Plan ou une interface d’API générale particulière.

  • Choisir l’option de configuration initiale appropriée

    bash
    # 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 APIopenclaw onboard --auth-choice zai-global # General API CN (China region)openclaw onboard --auth-choice zai-cn

  • Vérifier que le modèle figure dans la liste

    bash
    openclaw models list --all --provider zai

    • Points de terminaison

    Option de configuration initiale URL de base Modèle par défaut
    zai-global https://api.z.ai/api/paas/v4 glm-5.1
    zai-cn https://open.bigmodel.cn/api/paas/v4 glm-5.1
    zai-coding-global https://api.z.ai/api/coding/paas/v4 glm-5.2
    zai-coding-cn https://open.bigmodel.cn/api/coding/paas/v4 glm-5.2

    zai-api-key détecte automatiquement l’un de ces quatre points de terminaison en testant votre clé auprès de l’API Chat Completions de chacun d’eux. Il vérifie d’abord les points de terminaison généraux (zai-global, puis zai-cn), avant ceux de Coding Plan (zai-coding-global, puis zai-coding-cn), et s’arrête au premier point de terminaison qui accepte une requête. Utilisez une valeur --auth-choice explicite pour imposer un point de terminaison Coding Plan si votre clé fonctionne avec les deux types.

    Exemple de configuration

    json5
    {  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 du fournisseur zai fournit son catalogue dans le manifeste du Plugin. Ainsi, une consultation en lecture seule peut afficher les entrées GLM connues sans charger l’environnement d’exécution du fournisseur :

    bash
    openclaw models list --all --provider zai

    Le catalogue issu du manifeste comprend actuellement :

    Référence du modèle Remarques
    zai/glm-5.2 Modèle par défaut de Coding Plan ; contexte de 1 M
    zai/glm-5.1 Modèle 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

    Niveaux de réflexion

    GLM-5.2

    Plage complète : off, low, high, max (off par défaut). OpenClaw associe low et high à l’effort de raisonnement high de Z.AI, et max à l’effort max de Z.AI, au moyen de reasoning_effort dans la charge utile de la requête.

    Autres modèles GLM

    Uniquement un choix binaire : off et low (affiché comme on dans les sélecteurs), avec off par défaut. Définir la réflexion sur off envoie thinking: { type: "disabled" } ; tout autre niveau laisse la charge utile de la requête inchangée (le comportement de raisonnement par défaut de Z.AI s’applique).

    Définir la réflexion sur off évite les réponses qui consomment le budget de sortie avec reasoning_content avant le texte visible.

    Configuration avancée

    Résolution anticipée des modèles GLM-5 inconnus

    Les identifiants glm-5* inconnus sont tout de même résolus de manière anticipée dans le chemin du fournisseur en générant des métadonnées appartenant au fournisseur à partir du modèle glm-4.7, lorsque l’identifiant correspond à la forme actuelle de la famille GLM-5.

    Diffusion en continu des appels d’outils

    tool_stream est activé par défaut pour la diffusion en continu des appels d’outils Z.AI. Pour le désactiver :

    json5
    {  agents: {    defaults: {      models: {        "zai/<model>": {          params: { tool_stream: false },        },      },    },  },}
    Réflexion conservée

    La conservation de la réflexion est facultative, car Z.AI exige de rejouer l’intégralité de l’historique reasoning_content, ce qui augmente le nombre de jetons de l’invite. Activez-la pour chaque modèle :

    json5
    {  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 rejoue le contenu reasoning_content antérieur pour la même transcription compatible avec OpenAI. La clé de paramètre en notation snake_case preserve_thinking fonctionne comme alias.

    Les utilisateurs avancés peuvent toujours remplacer précisément la charge utile du fournisseur avec params.extra_body.thinking.

    Compréhension des images

    Le Plugin Z.AI enregistre la fonctionnalité de compréhension des images.

    Propriété Valeur
    Modèle glm-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.

    Détails de l’authentification
    • Z.AI utilise l’authentification Bearer avec votre clé API.
    • L’option de configuration initiale zai-api-key détecte automatiquement le point de terminaison Z.AI correspondant en testant 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 souhaitez imposer une interface d’API particulière.
    • L’ancienne variable d’environnement Z_AI_API_KEY est toujours acceptée ; OpenClaw la copie dans ZAI_API_KEY au démarrage si ZAI_API_KEY n’est pas définie.

    Voir aussi

    Sélection du modèle

    Choix des fournisseurs, des références de modèles et du comportement de basculement.
    Référence de configuration

    Schéma de configuration complet d’OpenClaw, notamment les paramètres des fournisseurs et des modèles.
    Was this useful?
    On this page

    On this page