Zhipu GLM कनेक्ट करना: Z.AI के दो एंडपॉइंट और Coding Plan
OpenClaw से GLM (Zhipu) कनेक्ट करना घरेलू मॉडल पेज का तीसरा स्टेशन है। पिछले दो पाठों में DeepSeek एक एनवायरनमेंट वेरिएबल से ही चल पड़ा, Qwen ने तीन में से एक चुना; GLM का बहुविकल्पी प्रश्न और भी सरल है——General API या Coding Plan, फिर एक बार औरअंतरराष्ट्रीय साइट api.z.ai या घरेलू साइट open.bigmodel.cn। गलत एंडपॉइंट चुनने पर Key अस्वीकार हो जाएगी और डिफ़ॉल्ट मॉडल भी मेल नहीं खाएगा। पूरी प्रक्रिया में लगभग 8 मिनट लगते हैं (Z.AI पंजीकरण अलग से)।
पहले आपको एक क्विक-लुक तालिका देते हैं, इस पाठ की सारी कॉन्फ़िगरेशन इसी से शुरू होती है (गुण और मान आधिकारिक दस्तावेज़ से यथावत लिए गए हैं):
| गुण | मान |
|---|---|
| Provider id | zai |
| प्रमाणीकरण एनवायरनमेंट वेरिएबल | ZAI_API_KEY (पुराना उपनाम Z_AI_API_KEY अभी भी स्वीकार्य है, स्टार्टअप पर ऑटोमैटिक कॉपी होता है) |
| API रूप | Z.AI Chat Completions (Bearer प्रमाणीकरण) |
| आधिकारिक प्लगइन | @openclaw/zai-provider (बाहरी प्लगइन, इंस्टॉल आवश्यक) |
| डिफ़ॉल्ट मॉडल | Coding Plan: zai/glm-5.3; General API: zai/glm-5.2 |
| Key प्रबंधन कंसोल | https://z.ai/manage-apikey/apikey-list |
एक बात जो पहले जानना ज़रूरी है: GLM एक मॉडल परिवार है, अलग provider नहीं (आधिकारिक मूल शब्द: "GLM is a model family, not a separate provider")। मॉडल संदर्भ हमेशा zai/ से शुरू होते हैं, जैसे zai/glm-5.3——provider zai है, मॉडल id glm-5.3 है।
चार एंडपॉइंट, पूरा पाठ इसी तालिका पर टिका है (auth-choice और एंडपॉइंट आधिकारिक दस्तावेज़ से यथावत लिए गए हैं):
| उपयोग | auth-choice | Base URL | डिफ़ॉल्ट मॉडल |
|---|---|---|---|
| General API · अंतरराष्ट्रीय साइट | zai-global | https://api.z.ai/api/paas/v4 | glm-5.2 |
| General API · घरेलू साइट | zai-cn | https://open.bigmodel.cn/api/paas/v4 | glm-5.2 |
| Coding Plan · अंतरराष्ट्रीय साइट | zai-coding-global | https://api.z.ai/api/coding/paas/v4 | glm-5.3 |
| Coding Plan · घरेलू साइट | zai-coding-cn | https://open.bigmodel.cn/api/coding/paas/v4 | glm-5.3 |
कैसे चुनें, तीन वाक्यों में:
| आपकी स्थिति | यह चुनें |
|---|---|
| आपने GLM Coding Plan सब्सक्राइब किया है (मासिक कोडिंग पैकेज) | zai-coding-global / zai-coding-cn, डिफ़ॉल्ट मॉडल सीधे glm-5.3 |
| उपयोग के अनुसार भुगतान (pay-as-you-go) | zai-global / zai-cn, डिफ़ॉल्ट मॉडल glm-5.2 |
| निश्चित नहीं कि यह Key किस एंडपॉइंट पर चलेगी | zai-api-key: OpenClaw Key से एक-एक करके एंडपॉइंट आज़माएं, पहला जो स्वीकार करे उसी का उपयोग करें |
दो अतिरिक्त तथ्य, जो आगे ट्रबलशूटिंग में काम आएंगे:
- Z.AI का एक और Anthropic-संगत Coding Plan एंडपॉइंट
https://api.z.ai/api/anthropicभी है——वह सीधे Anthropic Messages बोलने वाले क्लाइंट के लिए है; OpenClaw का zai विकल्प उसका उपयोग नहीं करता, वह ऊपर की तालिका के OpenAI Chat Completions एंडपॉइंट का उपयोग करता है। - Coding Plan एंडपॉइंट पर, GLM-5.2 / GLM-5.1 के रिक्वेस्ट Z.AI द्वारा GLM-5.3 पर रूट किए जाते हैं।
💡 「智谱清言」 से खोजकर आए दोस्तों के लिए
「智谱清言」智谱 का सामान्य उपयोगकर्ताओं के लिए बना चैट प्रोडक्ट है; OpenClaw को वह चैट एंट्री नहीं चाहिए, बल्कि GLM मॉडल की API Key चाहिए——Z.AI कंसोल (अंतरराष्ट्रीय साइट) या open.bigmodel.cn (चीन क्षेत्र) से लें। यह पेज केवल API एकीकरण के बारे में बताता है।
यह ट्यूटोरियल OpenClaw v2026.10.9 पर आधारित है।
सीखने के बाद आप क्या कर सकते हैं
- GLM आधिकारिक प्लगइन
@openclaw/zai-providerइंस्टॉल करें,ZAI_API_KEYको OpenClaw में कॉन्फ़िगर करें——ऑटो-डिटेक्ट, एक्सप्लिसिट एंडपॉइंट, मैनुअल कॉन्फ़िगरेशन तीन रास्तों में से कोई भी चुनें - General API और Coding Plan दोहरे एंडपॉइंट × घरेलू / अंतरराष्ट्रीय दो क्षेत्रों के बीच अंतर समझें, और अपनी Key के अनुसार सही auth-choice चुनें
- GLM की इनबिल्ट कैटलॉग समझें:
glm-5.3,glm-5.3-flash,glm-5.2प्रत्येक की जगह, औरglm-5.1को अब और क्यों न इस्तेमाल करें - पीक समय में
429/1302/1305आने पर घबराएं नहीं: 「अस्थायी रेट लिमिट」 और 「गलत एंडपॉइंट」 में अंतर पहचानें - GLM की विशेष क्षमताओं का उपयोग करें:
/thinkरीज़निंग लेवल,cogvideox-3वीडियो जनरेशन,glm-4.6vइमेज समझ
🎒 शुरू करने से पहले की तैयारी
- मॉडल कनेक्शन ओवरव्यू: provider सिस्टम और मॉडल स्विचिंग पूरा कर लिया है: 「प्लगइन इंस्टॉल → क्रेडेंशियल कॉन्फ़िगर → मॉडल चुनें」 तीन चरण और
provider/modelरेफरेंस नियम समझ में हैं - OpenClaw इंस्टॉल है, Gateway चल रहा है:
openclaw gateway statusका आउटपुट आ रहा है (प्लगइन चलते हुए Gateway पर ऑटोमैटिक लागू होता है; नहीं चल रहा हो तो अगली बार स्टार्ट पर लागू होगा) - पता है कि आपकी Key Coding Plan की है या पेज-अस-यू-गो, घरेलू साइट से जारी है या अंतरराष्ट्रीय साइट से
- सर्वर / डेमन डिप्लॉयमेंट पर जाने पर, पता है कि
~/.openclaw/.envकहाँ है——Key आखिरकार वहीं रहेगी
मेरे साथ करें
चरण 1: Z.AI कंसोल में API Key बनाएं
क्यों: OpenClaw केवल कॉल करने के लिए ज़िम्मेदार है, Key पहले Z.AI से लेनी होगी——और आपका अकाउंट प्रकार (सब्सक्रिप्शन / पेज-अस-यू-गो) तय करता है कि चरण 2 में कौन सा एंडपॉइंट चुनें।
- ब्राउज़र में Z.AI कंसोल
https://z.ai/manage-apikey/apikey-listखोलें, रजिस्टर / लॉगिन करें - एक API Key बनाएं, कॉपी करके सुरक्षित जगह पर पेस्ट करें
- घरेलू उपयोगकर्ता: चीन क्षेत्र का प्लेटफ़ॉर्म
open.bigmodel.cnहै, घरेलू अकाउंट अपने ही कंसोल में Key मैनेज करता है (OpenClaw डॉक्युमेंट केवल अंतरराष्ट्रीय साइट कंसोल का डायरेक्ट लिंक देता है, घरेलू साइट के लिएopen.bigmodel.cnकी आधिकारिक वेबसाइट पर जाकर API Key मैनेजमेंट पेज खोजें)
आपको यह दिखना चाहिए: एक कॉपी की जा सकने वाली API Key। अकाउंट प्रकार का पक्का नहीं? सब्सक्रिप्शन पेज https://z.ai/subscribe पर जाकर मौजूदा प्लान देख लें।
चरण 2: OpenClaw में GLM जोड़ें——पहले प्लगइन इंस्टॉल करें, फिर ZAI_API_KEY कॉन्फ़िगर करें
क्यों: zai, DeepSeek और Qwen की तरह बाहरी आधिकारिक प्लगइन है (कोर में इनबिल्ट नहीं), इनबिल्ट प्लगइन से एक चरण अधिक「इंस्टॉल」; इंस्टॉल के बाद, auth-choice तय करता है कि कौन सा एंडपॉइंट इस्तेमाल हो।
पहले प्लगइन इंस्टॉल करें (दोनों तरीकों का पहला साझा चरण):
openclaw plugins install @openclaw/zai-providerआपको यह दिखना चाहिए: इंस्टॉल सफल। चलते हुए Gateway पर ऑटोमैटिक लागू होता है; Gateway नहीं चल रहा हो तो अगली बार स्टार्ट पर लागू होगा।
तरीका A (अनुशंसित): onboarding गाइड
सबसे आसान है ऑटो-डिटेक्ट——OpenClaw आपकी Key लेकर एक-एक एंडपॉइंट आज़माता है:
openclaw onboard --auth-choice zai-api-keyडिटेक्शन क्रम (आधिकारिक डॉक्युमेंट जैसा ही): पहले General एंडपॉइंट (zai-global → zai-cn), फिर Coding Plan एंडपॉइंट (zai-coding-global → zai-coding-cn), पहला जो रिक्वेस्ट स्वीकार करे वही इस्तेमाल होता है।
एंडपॉइंट को ज़बरदस्ती निर्दिष्ट करने के लिए (Coding Plan उपयोगकर्ताओं के लिए एक्सप्लिसिट चुनाव अनुशंसित, कारण नीचे चेतावनी में):
# Coding Plan · 国际站 / 国内站(Coding Plan 用户推荐)
openclaw onboard --auth-choice zai-coding-global
openclaw onboard --auth-choice zai-coding-cn
# General API · 国际站 / 国内站
openclaw onboard --auth-choice zai-global
openclaw onboard --auth-choice zai-cnआपको यह दिखना चाहिए: पहले API Key इनपुट का प्रॉम्प्ट, सत्यापन पास होने पर क्रेडेंशियल सेव; डिफ़ॉल्ट मॉडल एंडपॉइंट के अनुसार तय होता है——Coding Plan पर zai/glm-5.3, General API पर zai/glm-5.2।
तीन भरोसे की बातें (आधिकारिक डॉक्युमेंट में स्पष्ट लिखा है):
- onboarding आपकी मौजूदा मॉडल एंट्री बनाए रखता है——दोबारा चलाने से दूसरे provider की कॉन्फ़िगरेशन नहीं मिटती
- नया provider क्रेडेंशियल जोड़ना आपका मौजूदा डिफ़ॉल्ट मॉडल नहीं बदलता——डिफ़ॉल्ट बदलने के लिए चरण 3 का
openclaw models setइस्तेमाल करें - पुराना एनवायरनमेंट वेरिएबल
Z_AI_API_KEYअब भी मान्य है: स्टार्ट पर अगरZAI_API_KEYसेट न हो, OpenClaw इसे ऑटोमैटिक कॉपी कर लेता है
तरीका B: कॉन्फ़िगरेशन फ़ाइल मैन्युअल रूप से बदलें
आधिकारिक प्लगइन को मूल रूप से ** ज़रूरत नहीं** models.providers एंट्री लिखने की——प्लगइन इंस्टॉल करें, auth सेट करें, मॉडल चुनें; केवल डिफ़ॉल्ट baseUrl ओवरराइड करने के लिए लिखें (जैसे Coding Plan या घरेलू साइट एंडपॉइंट मैन्युअल रूप से पिन करना)। आधिकारिक कॉन्फ़िगरेशन उदाहरण (जैसा है):
{
env: { vars: { ZAI_API_KEY: "sk-..." } },
models: {
providers: {
zai: {
// GLM-5.3 uses the Coding Plan endpoint.
baseUrl: "https://api.z.ai/api/coding/paas/v4",
},
},
},
agents: { defaults: { model: { primary: "zai/glm-5.3" } } },
}ज़रूरत के अनुसार baseUrl बदलें (ऊपर की चार-एंडपॉइंट तालिका से मिलाएं):
| कौन सा एंडपॉइंट चाहिए | baseUrl में क्या लिखें |
|---|---|
| Coding Plan · अंतरराष्ट्रीय साइट | https://api.z.ai/api/coding/paas/v4 |
| Coding Plan · घरेलू साइट | https://open.bigmodel.cn/api/coding/paas/v4 |
| General API · अंतरराष्ट्रीय साइट | https://api.z.ai/api/paas/v4 |
| General API · घरेलू साइट | https://open.bigmodel.cn/api/paas/v4 |
Key कहाँ रखें: इंटरैक्टिव शेल में export ZAI_API_KEY="<你的 API Key>", या ~/.openclaw/.env में लिखें (डेमन डिप्लॉयमेंट के लिए यही रास्ता अनिवार्य है, नीचे की चेतावनी देखें)।
⚠️ Gateway डेमन के रूप में चल रहा है? Key इंटरैक्टिव शेल में न रखें
Gateway launchd / systemd सर्विस के रूप में चलते समय, आपके टर्मिनल में export किए एनवायरनमेंट वेरिएबल नहीं देख पाता। ZAI_API_KEY को ~/.openclaw/.env में लिखें, या कॉन्फ़िगरेशन के env.shellEnv से उस प्रोसेस को दें।
openclaw models statusके क्रेडेंशियल ओवरव्यू में, zai लाइन परZAI_API_KEYका स्रोत दिखता है
चरण 3: GLM मॉडल चुनें और सत्यापित करें
क्यों: डिफ़ॉल्ट मॉडल एंडपॉइंट के अनुसार तय होता है (Coding Plan → glm-5.3, General → glm-5.2), चलने लायक हो तो पहले वही चलाएं; लेकिन कैटलॉग में छह मॉडलों के काम अलग हैं, देखकर तय करें।
पहले कैटलॉग देखें:
openclaw models list --all --provider zaiआपको यह दिखना चाहिए: प्लगइन मैनिफ़ेस्ट में इनबिल्ट GLM कैटलॉग (आधिकारिक डॉक्युमेंट से जैसा ही; यह कैटलॉग प्लगइन manifest के साथ जाता है, रीड-ओनली लिस्ट के लिए provider रनटाइम लोड करने की ज़रूरत नहीं):
| मॉडल रेफरेंस | कॉन्टेक्स्ट | टिप्पणी |
|---|---|---|
zai/glm-5.3 | 1,048,576 | Coding Plan डिफ़ॉल्ट |
zai/glm-5.3-flash | 1,048,576 | मल्टीमॉडल (टेक्स्ट + इमेज) |
zai/glm-5.2 | 1M | General API डिफ़ॉल्ट |
zai/glm-5-turbo | 200K | OpenClaw ऑप्टिमाइज़्ड टेक्स्ट मॉडल |
zai/glm-5v-turbo | 200K | मल्टीमॉडल coding मॉडल |
zai/glm-5.1 | — | डेप्रिकेटेड; कॉन्फ़िगर न करें तो नहीं दिखता; ऑफ़िशियल सुझाव है कि GLM-5.2 पर स्विच करें |
तीन डायरेक्टरी व्यवहार, ऑफ़िशियल Note में साफ़ लिखा है:
- नए Coding Plan कॉन्फ़िगरेशन का डिफ़ॉल्ट
zai/glm-5.3है; General API कॉन्फ़िगरेशनzai/glm-5.2पर रुका है - Coding Plan एंडपॉइंट पर, जब Key या क्षेत्रीय एंडपॉइंट सीधे GLM-5.3 को एक्सपोज़ नहीं करते, तो ऑटो-डिटेक्शन
glm-5.1,glm-4.7की ओर फ़ॉलबैक करता है - Coding Plan को GLM-5.2 / GLM-5.1 का अनुरोध मिलने पर Z.AI इसे GLM-5.3 पर रूट करता है
कैसे चुनें, तीन वाक्यों में:
| आपकी ज़रूरत | इसे चुनें | आधार |
|---|---|---|
| Coding Plan उपयोगकर्ता, नहीं पता क्या चुनें | zai/glm-5.3 | ऑफ़िशियल डिफ़ॉल्ट, 1M कॉन्टेक्स्ट |
| मॉडल से इमेज देखवानी है | zai/glm-5.3-flash(1M)/ zai/glm-5v-turbo(200K) | डायरेक्टरी में मल्टीमॉडल चिह्नित है |
| पे-ऐज़-यू-गो, थिंकिंग पूरी तरह बंद करनी हो | zai/glm-5.2 | thinking डिफ़ॉल्ट off और off लेवल सपोर्ट करता है(GLM-5.3 बंद नहीं होता, विशेष क्षमताएँ देखें) |
डिफ़ॉल्ट मॉडल बदलें:
openclaw models set zai/glm-5.3चैट में अस्थायी रूप से स्विच करना भी चलता है: /model zai/glm-5.2 केवल मौजूदा सेशन को प्रभावित करता है, कमांड परिवार के लिए चैट कमांड क्रैश कोर्स देखें।
अंत में सत्यापित करें——एक टेस्ट मैसेज भेजें:
openclaw agent --agent main --model zai/glm-5.3 --message "用一句话介绍你自己"(openclaw agent को कम से कम एक सेशन सेलेक्टर चाहिए, --agent main डिफ़ॉल्ट agent की ओर इशारा करता है——onboarding पूरा किए इंस्टॉल में डिफ़ॉल्ट रूप से main मौजूद होता है; या openclaw dashboard से Control UI खोलें और चैट बॉक्स में सीधे भेजें।)
आपको यह दिखना चाहिए: मॉडल सामान्य रूप से जवाब देता है, कोई क्रेडेंशियल मिसिंग या मॉडल मौजूद न होने की एरर नहीं। यहाँ तक, OpenClaw का GLM से कनेक्शन हो गया।
कीमत एक वाक्य में: GLM-5.3 फिलहाल Coding Plan मॉडल है, लोकल डायरेक्टरी में cost शून्य है——सब्सक्रिप्शन पैकेज कोटा इस्तेमाल होता है, token के हिसाब से बिलिंग नहीं; पे-ऐज़-यू-गो डायरेक्टरी Z.AI के मौजूदा API प्राइसिंग का पालन करती है, GLM-5.3 Flash पे-ऐज़-यू-गो डायरेक्टरी कीमत इस्तेमाल करता है(अस्थायी छूट डायरेक्टरी कीमत को प्रभावित नहीं करती)。 पैकेज कीमत और उपलब्धता के लिए Z.AI सब्सक्रिप्शन पेज https://z.ai/subscribe मानक है।
- टेस्ट मैसेज को GLM से जवाब मिला
चेकपॉइंट ✅
openclaw plugins install @openclaw/zai-providerनिष्पादित हुआ, प्लगइन सूची में है- auth-choice(या baseUrl)आपकी Key प्रकार और क्षेत्र से मेल खाता है: Coding Plan Key coding एंडपॉइंट पर जाती है, पे-ऐज़-यू-गो Key general एंडपॉइंट पर
openclaw models statusके क्रेडेंशियल ओवरव्यू में zai कीZAI_API_KEYदिखती हैopenclaw models list --all --provider zaiGLM सीरीज़ के मॉडल लिस्ट करता है- टेस्ट मैसेज भेजने के बाद GLM से जवाब मिला
zai/glm-5.1को डिफ़ॉल्ट नहीं बनाया(डेप्रिकेटेड)
आम गलतियों की चेतावनी
❌ Coding Plan की Key General एंडपॉइंट पर कॉन्फ़िगर हो गई(या इसका उल्टा)
कारण: ऑफ़िशियल ट्रबलशूटिंग गाइड बिल्कुल साफ़ कहता है——Coding Plan Key को Coding Plan एंडपॉइंट(जैसे https://api.z.ai/api/coding/paas/v4)इस्तेमाल करना चाहिए, General API Key को General एंडपॉइंट(जैसे https://api.z.ai/api/paas/v4)。वही Key + वही एंडपॉइंट लगातार फेल हो, तो ज़्यादा संभावना provider की ओर से मना करने या पैकेज सीमा की है, सामान्य पीक-आवर रेट-लिमिटिंग नहीं।
सही तरीका: पहले एंडपॉइंट जाँचें, फिर बाकी:
openclaw models list --all --provider zai
openclaw config get models.providers.zai.baseUrlएंडपॉइंट गलत हो तो onboard दोबारा चलाकर auth-choice स्पष्ट रूप से चुनें, या मैन्युअली models.providers.zai.baseUrl बदलें।
❌ Key दोनों तरफ़ चलती है, पर ऑटो-डिटेक्शन General पर आ गया
कारण: zai-api-key का डिटेक्शन क्रम पहले General(zai-global → zai-cn)फिर Coding Plan(zai-coding-global → zai-coding-cn)है, पहला जो स्वीकार करे वही इस्तेमाल होता है। Key दोनों तरह के एंडपॉइंट पर वैध हो तो General में जाएगी——डिफ़ॉल्ट मॉडल glm-5.3 की जगह glm-5.2 बन जाएगा।
सही तरीका: ऑफ़िशियल वही गाइड——Key दोनों तरफ़ चले, और Coding Plan चाहिए तो स्पष्ट रूप से निर्दिष्ट करें:
openclaw onboard --auth-choice zai-coding-global # 国际站
openclaw onboard --auth-choice zai-coding-cn # 国内站❌ पीक आवर में 429 / 1305 एरर, लगा कॉन्फ़िगरेशन खराब है
कारण: Z.AI ऑफ़िशियली सामान्य agent टूल्स(OpenClaw समेत)को कैपेसिटी-होस्टेड, best-effort सेवा की श्रेणी में रखता है——उच्च इन्फ़रेंस लोड वाले समय(ऑफ़िशियल कथन: लगभग सिंगापुर समय दोपहर 2–6 बजे)में कुछ अनुरोध अस्थायी रूप से थ्रॉटल होते हैं; Coding Plan की रेट और कंकरेंसी कोटा पैकेज टियर से जुड़े हैं, संसाधनों के अनुसार डायनामिक रूप से बदलते हैं, गैर-पीक में कंकरेंसी ज़्यादा हो सकती है।
एरर कोड के अर्थ ऑफ़िशियल API code दस्तावेज़ में देखें: 1302 = अनुरोध रेट लिमिट पर पहुँचा; 1305 = सेवा अस्थायी रूप से ओवरलोडेड, बाद में फिर कोशिश करें।
सही तरीका: पीक आवर के अस्थायी 429 / 1305 पर प्रतीक्षा करके दोबारा कोशिश करना ही काफ़ी है। केवल जब गैर-पीक में भी लगातार फेल हो, या फेल केवल एक ही एंडपॉइंट / मॉडल / अनुरोध पैटर्न पर केंद्रित हो, तभी कॉन्फ़िगरेशन जाँचें(पिछली गड्ढे की दो कमांड)।
❌ /think off GLM-5.3 की थिंकिंग बंद नहीं कर पाता
कारण: GLM-5.3 / GLM-5.3-flash केवल low / high / max तीन लेवल सपोर्ट करते हैं(डिफ़ॉल्ट max), पूरी तरह बंद करना सपोर्टेड नहीं——स्पष्ट /think off को reasoning_effort: "low" में मैप किया जाता है।
सही तरीका: अगर thinking को पूरी तरह बंद करना हो (आउटपुट बजट बचाने के लिए) तो zai/glm-5.2 पर स्विच करें——यह पूरे off / low / high / max को सपोर्ट करता है, और डिफ़ॉल्ट ही off है। विवरण नीचे विशेष क्षमताओं में देखें।
❌ अब भी zai/glm-5.1 इस्तेमाल कर रहे हैं
कारण: glm-5.1 अब deprecated है, डायरेक्टरी में कॉन्फ़िगर न करें तो दिखाई नहीं देता; आधिकारिक सलाह GLM-5.2 पर स्विच करने की है। Coding Plan एंडपॉइंट पर 5.2 / 5.1 के रिक्वेस्ट Z.AI द्वारा GLM-5.3 पर रूट कर दिए जाते हैं——आप जो मॉडल इस्तेमाल कर रहे सोचते हैं और वास्तव में चल रहा मॉडल एक ही नहीं है।
सही तरीका: General API पर zai/glm-5.2 लें; Coding Plan पर सीधे zai/glm-5.3।
❌ Gateway को डेमन के रूप में इंस्टॉल करने के बाद, export किया Key 「लागू नहीं होता」
कारण: launchd / systemd सर्विसेज़ इंटरैक्टिव shell के एनवायरनमेंट वेरिएबल्स नहीं देख पातीं——हर provider डॉक्युमेंटेशन में बार-बार इस बात पर ज़ोर दिया गया है।
सही तरीका: ZAI_API_KEY को ~/.openclaw/.env में लिखें, या कॉन्फ़िगरेशन के env.shellEnv से दें; Key बदलने के बाद Gateway सर्विस रीस्टार्ट करें।
🔧 GLM विशेष क्षमताएँ (वैकल्पिक)
प्लगइन इंस्टॉल होने के बाद, GLM की चार विशेष क्षमताएँ साथ आती हैं।
thinking स्तर: तीन मैपिंग सेट
| मॉडल | सपोर्टेड स्तर | डिफ़ॉल्ट | मैपिंग विवरण |
|---|---|---|---|
| GLM-5.3 / 5.3-flash | low / high / max | max | Z.AI के reasoning_effort फ़ील्ड पर मैप होता है; स्पष्ट off को low पर मैप किया जाता है (पूरी तरह बंद नहीं किया जा सकता) |
| GLM-5.2 | off / low / high / max | off | low / high को Z.AI के high पर मैप किया जाता है, max को max पर, और reasoning_effort के ज़रिए भेजा जाता है |
| अन्य GLM मॉडल | off / low (सिलेक्टर में on दिखता है) | off | off thinking: { type: "disabled" } भेजता है; बाकी स्तर रिक्वेस्ट बॉडी को नहीं छेड़ते, Z.AI के डिफ़ॉल्ट रीज़निंग व्यवहार के अनुसार |
चैट में सीधे इस्तेमाल करें:
/think max # GLM-5.3 का डिफ़ॉल्ट स्तर
/think off # GLM-5.3 पर वास्तव में low है; GLM-5.2 पर ही वास्तव में बंद होता हैआधिकारिक कारण: thinking को off सेट करने से यह टाला जा सकता है कि जवाब आउटपुट बजट पहले reasoning_content पर खर्च कर दे और दिखने वाला मुख्य टेक्स्ट छोटा हो जाए।
वीडियो जनरेशन: zai/cogvideox-3
वही प्लगइन, वही ZAI_API_KEY (या Z_AI_API_KEY) वीडियो जनरेशन टूल को भी चला सकता है, मॉडल zai/cogvideox-3:
- इनपुट: टेक्स्ट प्रॉम्प्ट, या** एक** PNG / JPEG इमेज (लोकल फ़ाइल data URI के रूप में भेजी जाती है, अधिकतम 5 MB); वीडियो रेफ़रेंस सपोर्टेड नहीं
- अवधि: 5 या 10 सेकंड पर नॉर्मलाइज़ की जाती है
- आकार: निकटतम सपोर्टेड आकार पर मैप होता है——
1280x720,720x1280,1024x1024,1920x1080,1080x1920,2048x1080,3840x2160 - डिफ़ॉल्ट 720P लैंडस्केप, ऑडियो नहीं;
audio: trueसे आवाज़ चालू - एडवांस्ड:
providerOptions.quality(speed/quality),providerOptions.fps(30/60)
इसे डिफ़ॉल्ट वीडियो provider के रूप में सेट करें (आधिकारिक कॉन्फ़िगरेशन उदाहरण, जस का तस):
{
agents: {
defaults: {
mediaModels: {
video: { primary: "zai/cogvideox-3" },
},
},
},
}⚠️ वीडियो General एंडपॉइंट से चलता है, Coding Plan सब्सक्रिप्शन सीधे एडजस्ट नहीं होता
वीडियो जनरेशन आपके कॉन्फ़िगर किए क्षेत्र (इंटरनेशनल / डोमेस्टिक) के General /api/paas/v4 एंडपॉइंट का इस्तेमाल करता है; Coding Plan चैट एंडपॉइंट उसी क्षेत्र के General वीडियो एंडपॉइंट पर मैप होता है——वीडियो के लिए उस एंडपॉइंट की API एक्सेस और बिलिंग चाहिए, जो Coding Plan की मासिक कोटा में शामिल नहीं है।
इमेज, वॉयस और वीडियो को व्यवस्थित रूप से इस्तेमाल करना चाहें तो इमेज और वॉयस: कंटेंट के लिए इमेज, लेख को वॉयस में बदलें देखें।
इमेज समझ: glm-4.6v
Z.AI प्लगइन ने इमेज समझने की क्षमता रजिस्टर की है, मॉडल glm-4.6v——अपने आप आपके कॉन्फ़िगर किए Z.AI क्रेडेंशियल से पार्स होता है, अतिरिक्त कॉन्फ़िगरेशन की ज़रूरत नहीं।
एडवांस्ड: tool_stream, preserveThinking और अनजान GLM-5 id
- टूल कॉल स्ट्रीमिंग:
tool_streamडिफ़ॉल्ट रूप से चालू है। बंद करने के लिए नीचे दी कॉन्फ़िगरेशन का पैरामीटरtool_stream: falseसे बदलें और मॉडल कुंजी को संबंधितzai/<模型>से बदलें - thinking सुरक्षित रखें (preserveThinking): डिफ़ॉल्ट रूप से बंद है——Z.AI पूरे
reasoning_contentहिस्ट्री के रीप्ले की मांग करता है, जिससे prompt token बढ़ते हैं। मॉडल के अनुसार चालू करें (आधिकारिक उदाहरण, जस का तस):
{
agents: {
defaults: {
models: {
"zai/glm-5.3": {
params: { preserveThinking: true },
},
},
},
},
}चालू करने पर thinking के समय thinking: { type: "enabled", clear_thinking: false } भेजा जाता है, और उसी OpenAI-कम्पैटिबल transcript का reasoning_content हिस्ट्री रीप्ले होता है (snake_case वाला preserve_thinking एक उपनाम है)। एडवांस्ड यूज़र params.extra_body.thinking से provider payload को सटीक रूप से ओवरराइड कर सकते हैं।
- अनजान GLM-5 id का फॉरवर्ड रेज़ोल्यूशन: डायरेक्टरी में न होने वाले
glm-5*id, अगर मौजूदा GLM-5 फ़ैमिली के पैटर्न से मैच होते हैं, तो providerglm-4.7टेम्पलेट से मेटाडेटा सिंथेसाइज़ कर रेज़ॉल्व कर देता है
अगला कदम
OpenClaw 智谱 GLM कॉन्फ़िगरेशन यहीं पूरा हुआ। डोमेस्टिक मॉडल पेजों पर आगे बढ़ें:
- अगला पाठ Kimi एक्सेस: Moonshot और Kimi Coding दो प्लगइन: Moonshot और Kimi Coding दो प्लगइन और दो Key क्यों हैं
- अन्य मॉडल पेज (MiniMax, 豆包, 混元 / 千帆, रिले और लोकल मॉडल) मॉडल कनेक्शन ओवरव्यू के करिकुलम से एक्सेस करें
- मॉडल कॉन्फ़िगर हो गया? रोज़मर्रा के इस्तेमाल की शुरुआत रोज़मर्रा का इस्तेमाल: अपने Claw से कुशलता से काम करें से करें——Control UI, चैट कमांड, मेमोरी सिस्टम सब उसी अध्याय में हैं