> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Z.AI
Z.AI **GLM** मॉडल के लिए API प्लेटफ़ॉर्म है। यह GLM के लिए REST APIs प्रदान करता है और
प्रमाणीकरण के लिए API keys का उपयोग करता है। अपनी API key Z.AI console में बनाएं।
OpenClaw, Z.AI API key के साथ `zai` provider का उपयोग करता है।
| गुण | मान |
| -------- | -------------------------------------------- |
| Provider | `zai` |
| Package | `@openclaw/zai-provider` |
| Auth | `ZAI_API_KEY` (लेगेसी उपनाम: `Z_AI_API_KEY`) |
| API | Z.AI Chat Completions (Bearer प्रमाणीकरण) |
## GLM मॉडल
GLM एक मॉडल परिवार है, अलग provider नहीं। OpenClaw में, GLM मॉडल
`zai/glm-5.2` जैसे refs का उपयोग करते हैं: provider `zai`, model id `glm-5.2`.
## शुरू करना
पहले provider plugin इंस्टॉल करें:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/zai-provider
```
**इनके लिए सर्वश्रेष्ठ:** अधिकांश उपयोगकर्ता। OpenClaw आपकी API key के साथ समर्थित Z.AI endpoints की जांच करता है और सही base URL अपने-आप लागू करता है।
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice zai-api-key
```
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --all --provider zai
```
**इनके लिए सर्वश्रेष्ठ:** वे उपयोगकर्ता जो किसी विशिष्ट Coding Plan या सामान्य API surface को बाध्य करना चाहते हैं।
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# Coding Plan Global (Coding Plan उपयोगकर्ताओं के लिए अनुशंसित)
openclaw onboard --auth-choice zai-coding-global
# Coding Plan CN (चीन क्षेत्र)
openclaw onboard --auth-choice zai-coding-cn
# General API
openclaw onboard --auth-choice zai-global
# General API CN (चीन क्षेत्र)
openclaw onboard --auth-choice zai-cn
```
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --all --provider zai
```
## कॉन्फ़िगरेशन उदाहरण
`zai-api-key` OpenClaw को key से मेल खाने वाला Z.AI endpoint पहचानने और
सही base URL अपने-आप लागू करने देता है। जब आप किसी विशिष्ट Coding Plan या
सामान्य API surface को बाध्य करना चाहते हों, तो स्पष्ट क्षेत्रीय विकल्पों का उपयोग करें।
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
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 पंक्तियां दिखा सकती है:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --all --provider zai
```
manifest-समर्थित कैटलॉग में वर्तमान में शामिल हैं:
| Model ref | टिप्पणियां |
| -------------------- | -------------------------------- |
| `zai/glm-5.2` | Coding Plan डिफ़ॉल्ट; 1M context |
| `zai/glm-5.1` | General 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/` के रूप में उपलब्ध हैं (उदाहरण: `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` डिफ़ॉल्ट रूप से सक्षम है। इसे अक्षम करने के लिए:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
agents: {
defaults: {
models: {
"zai/": {
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 सक्षम करें:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
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 करता है।
| गुण | मान |
| ----- | ---------- |
| Model | `glm-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 करता है।
## संबंधित
providers, model refs, और failover behavior चुनना।
पूरा OpenClaw config schema, जिसमें provider और model settings शामिल हैं।