मुख्य सामग्री पर जाएं
Z.AI GLM मॉडल के लिए API प्लेटफ़ॉर्म है। यह GLM के लिए REST APIs प्रदान करता है और प्रमाणीकरण के लिए API keys का उपयोग करता है। अपनी API key Z.AI console में बनाएं। OpenClaw, Z.AI API key के साथ zai provider का उपयोग करता है।
गुणमान
Providerzai
Package@openclaw/zai-provider
AuthZAI_API_KEY (लेगेसी उपनाम: Z_AI_API_KEY)
APIZ.AI Chat Completions (Bearer प्रमाणीकरण)

​
GLM मॉडल

GLM एक मॉडल परिवार है, अलग provider नहीं। OpenClaw में, GLM मॉडल zai/glm-5.2 जैसे refs का उपयोग करते हैं: provider zai, model id glm-5.2.

​
शुरू करना

पहले provider plugin इंस्टॉल करें: 
openclaw plugins install @openclaw/zai-provider
इनके लिए सर्वश्रेष्ठ: अधिकांश उपयोगकर्ता। OpenClaw आपकी API key के साथ समर्थित Z.AI endpoints की जांच करता है और सही base URL अपने-आप लागू करता है।
1

Run onboarding

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

Verify the model is listed

openclaw models list --all --provider zai

​
कॉन्फ़िगरेशन उदाहरण

zai-api-key OpenClaw को key से मेल खाने वाला Z.AI endpoint पहचानने और सही base URL अपने-आप लागू करने देता है। जब आप किसी विशिष्ट Coding Plan या सामान्य API surface को बाध्य करना चाहते हों, तो स्पष्ट क्षेत्रीय विकल्पों का उपयोग करें।
{
  env: { ZAI_API_KEY: "sk-..." },
  models: {
    providers: {
      zai: {
        // GLM-5.2 Coding Plan endpoint का उपयोग करता है।
        baseUrl: "https://api.z.ai/api/coding/paas/v4",
      },
    },
  },
  agents: { defaults: { model: { primary: "zai/glm-5.2" } } },
}

​
बिल्ट-इन कैटलॉग

zai provider plugin अपना कैटलॉग plugin manifest में भेजता है, इसलिए read-only listing provider runtime लोड किए बिना ज्ञात GLM पंक्तियां दिखा सकती है: 
openclaw models list --all --provider zai
manifest-समर्थित कैटलॉग में वर्तमान में शामिल हैं:
Model refटिप्पणियां
zai/glm-5.2Coding Plan डिफ़ॉल्ट; 1M context
zai/glm-5.1General API डिफ़ॉल्ट
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
GLM मॉडल zai/<model> के रूप में उपलब्ध हैं (उदाहरण: zai/glm-5)।
GLM-5.2 off, low, high, और max thinking levels का समर्थन करता है। OpenClaw low और high को Z.AI high reasoning effort से, और max को max effort से मैप करता है।
Coding Plan setup डिफ़ॉल्ट रूप से zai/glm-5.2 का उपयोग करता है; general API setup zai/glm-5.1 रखता है। जब चुना गया plan GLM-5.2 उपलब्ध नहीं कराता, तो endpoint auto-detection glm-5.1 या glm-4.7 पर वापस चला जाता है। GLM versions और उपलब्धता बदल सकती है; अपने installed version को ज्ञात कैटलॉग देखने के लिए openclaw models list --all --provider zai चलाएं।

​
उन्नत कॉन्फ़िगरेशन

अज्ञात glm-5* ids तब भी provider path पर forward-resolve होते हैं, जब id मौजूदा GLM-5 family shape से मेल खाता है, तो glm-4.7 template से provider-owned metadata synthesize करके।
Z.AI tool-call streaming के लिए tool_stream डिफ़ॉल्ट रूप से सक्षम है। इसे अक्षम करने के लिए:
{
  agents: {
    defaults: {
      models: {
        "zai/<model>": {
          params: { tool_stream: false },
        },
      },
    },
  },
}
Z.AI thinking OpenClaw के /think controls का पालन करता है। thinking बंद होने पर, OpenClaw thinking: { type: "disabled" } भेजता है, ताकि ऐसे responses से बचा जा सके जो visible text से पहले reasoning_content पर output budget खर्च करते हैं।Preserved thinking opt-in है क्योंकि Z.AI को पूरा historical reasoning_content replay करना होता है, जिससे prompt tokens बढ़ते हैं। इसे प्रति model सक्षम करें:
{
  agents: {
    defaults: {
      models: {
        "zai/glm-5.2": {
          params: { preserveThinking: true },
        },
      },
    },
  },
}
सक्षम होने और thinking on होने पर, OpenClaw thinking: { type: "enabled", clear_thinking: false } भेजता है और उसी OpenAI-compatible transcript के लिए पहले का reasoning_content replay करता है।उन्नत उपयोगकर्ता अब भी exact provider payload को params.extra_body.thinking से override कर सकते हैं।
Z.AI plugin image understanding register करता है।
गुणमान
Modelglm-4.6v
Image understanding configured Z.AI auth से अपने-आप resolve होता है — किसी अतिरिक्त config की आवश्यकता नहीं है।
  • Z.AI आपकी API key के साथ Bearer auth का उपयोग करता है।
  • zai-api-key onboarding choice आपकी key के साथ समर्थित endpoints probe करके मेल खाने वाला Z.AI endpoint अपने-आप पहचानता है।
  • जब आप किसी विशिष्ट API surface को बाध्य करना चाहते हों, तो स्पष्ट क्षेत्रीय विकल्पों (zai-coding-global, zai-coding-cn, zai-global, zai-cn) का उपयोग करें।
  • लेगेसी env var Z_AI_API_KEY अब भी स्वीकार किया जाता है; अगर ZAI_API_KEY unset है, तो OpenClaw startup पर इसे ZAI_API_KEY में copy करता है।

​
संबंधित

Model selection

providers, model refs, और failover behavior चुनना।

Configuration reference

पूरा OpenClaw config schema, जिसमें provider और model settings शामिल हैं।