Tencent Hunyuan और Baidu Qianfan से कनेक्ट करना: बड़ी कंपनियों के MaaS का व्यावहारिक अभ्यास
OpenClaw Hunyuan और Baidu Qianfan से कनेक्ट करना, घरेलू मॉडल पेज की सातवीं पड़ाव है, और इस पेज पर एक साथ दो कंपनियाँ: Tencent Hunyuan (TokenHub / TokenPlan दो एंडपॉइंट) और Baidu Qianfan (Qianfan MaaS)। दोनों के अपने-अपने प्लगइन और अपनी-अपनी Key हैं, लेकिन कनेक्शन का तरीका पिछले पाठों जैसा ही है।
DeepSeek, Qwen, GLM, Kimi, MiniMax, Doubao का तीन-चरणीय «प्लगइन इंस्टॉल करें → क्रेडेंशियल कॉन्फ़िगर करें → मॉडल चुनें» इस पाठ में भी हूबहू लागू होता है। पूरी प्रक्रिया में लगभग 10 मिनट लगते हैं (Tencent Cloud / Baidu AI Cloud खाता पंजीकरण अलग से)।
पहले आपको एक सारांश तालिका देते हैं, इस पाठ की सारी कॉन्फ़िगरेशन इसी से शुरू होती है (गुण और मान आधिकारिक दस्तावेज़ से जस के तस लिए गए हैं):
| Tencent Hunyuan | Baidu Qianfan | |
|---|---|---|
| प्लगइन | @openclaw/tencent-provider | @openclaw/qianfan-provider |
| Provider id | tencent-tokenhub, tencent-tokenplan | qianfan |
| प्रमाणीकरण | TOKENHUB_API_KEY / TOKENPLAN_API_KEY | QIANFAN_API_KEY (bce-v3/ALTAK-... फ़ॉर्मेट) |
| एंडपॉइंट | https://tokenhub.tencentmaas.com/v1 (TokenHub)https://api.lkeap.cloud.tencent.com/plan/v3 (TokenPlan) | https://qianfan.baidubce.com/v2 |
| API | OpenAI-संगत (openai-completions) | बाएँ जैसा ही |
| onboarding डिफ़ॉल्ट | tencent-tokenhub/hy4-preview (TokenPlan एंड पर भी hy4-preview ही चुना जाता है) | qianfan/deepseek-v4-pro |
दोनों की पोज़िशनिंग, दो वाक्यों में स्पष्ट:
- Tencent Hunyuan: मॉडल Hunyuan hy सीरीज़ है (
hy4-preview,hy3), एंट्री Tencent Cloud के TokenHub और TokenPlan दो एंडपॉइंट हैं, दोनों provider की अपनी-अपनी Key कॉन्फ़िगर होती है - Baidu Qianfan: MaaS एग्रीगेशन प्लेटफ़ॉर्म, एक ही Key एकीकृत API के ज़रिए Wenxin ERNIE और Qianfan-होस्टेड DeepSeek जैसे कई मॉडलों तक रूट होती है
💡 «OpenClaw Wenxin से कनेक्ट करें» से खोजकर आए पाठकों के लिए
Wenxin (ERNIE) Baidu की मॉडल सीरीज़ है, OpenClaw इसे Baidu Qianfan (Qianfan) MaaS प्लेटफ़ॉर्म के ज़रिए जोड़ा जाता है——Qianfan के एकीकृत API के पीछे सिर्फ़ Wenxin नहीं, Qianfan-होस्टेड DeepSeek भी है। ध्यान दें: OpenClaw Baidu Qianfan की डायरेक्टरी में सिर्फ़ ernie-5.1 और ernie-5.0 शामिल हैं, ERNIE 4.5, X1 जैसे और पुराने मॉडल इसमें नहीं हैं (पेज के अंत में जाल-चेतावनी में विकल्प दिया गया है)।
यह ट्यूटोरियल OpenClaw v2026.10.9 पर आधारित है।
सीखने के बाद आप क्या कर सकते हैं
@openclaw/tencent-providerऔर@openclaw/qianfan-providerदो आधिकारिक प्लगइन इंस्टॉल करें,tencent-tokenhub,tencent-tokenplan,qianfanतीन provider रजिस्टर करें- Tencent के दो एंडपॉइंट पहचानें: TokenHub और TokenPlan के अपने-अपने Key वेरिएबल हैं, onboarding अलग-अलग चलाएँ
- OpenClaw Baidu Qianfan की एक ही
QIANFAN_API_KEYसे Wenxin ERNIE और Qianfan-होस्टेड DeepSeek रूट करें - दोनों की डायरेक्टरी समझें: Hunyuan
hy4-preview(1M कॉन्टेक्स्ट), Wenxinernie-5.1(टेक्स्ट फ़्लैगशिप) /ernie-5.0(मल्टीमॉडल) के अपने-अपने कॉन्टेक्स्ट और अधिकतम आउटपुट - बड़ी कंपनियों के MaaS के खास जालों से बचें: Key की सीमित स्कोप से मॉडल छूटना, पुराने Hunyuan मॉडल नाम अनुपलब्ध, Baidu Key फ़ॉर्मेट, अप्रचलित ID
- OpenClaw की मेमोरी सिस्टम में Qianfan का चीनी वेक्टर मॉडल (
bge-large-zh) कॉन्फ़िगर करें
🎒 शुरू करने से पहले की तैयारी
- पूरा किया मॉडल कनेक्शन ओवरव्यू: provider व्यवस्था और मॉडल स्विचिंग: «provider → प्रमाणीकरण → मॉडल चुनें» तीन चरण और
provider/modelरेफ़रेंस नियम जे़न में हों - OpenClaw इंस्टॉल है, Gateway चल रहा है:
openclaw gateway statusका आउटपुट आता है - Tencent Cloud खाता (Hunyuan के साथ) या Baidu AI Cloud खाता (Qianfan के साथ) में से कम से कम एक है — दोनों एक-दूसरे से स्वतंत्र हैं, केवल एक को कॉन्फ़िगर करना बिल्कुल ठीक है
- सर्वर / डेमन डिप्लॉयमेंट पर जाने पर, पता हो कि
~/.openclaw/.envकहाँ है — Key अंततः वहीं रहेगी
मेरे साथ करें
चरण 1: टेंसेंट हुनयुआन और बाइडू कियानफैन provider प्लगइन इंस्टॉल करें
क्यों: DeepSeek और डौबाओ की तरह, tencent और qianfan दोनों बाहरी आधिकारिक प्लगइन हैं, OpenClaw में पहले से शामिल नहीं होते — प्लगइन इंस्टॉल करने पर ही provider मॉडल सिस्टम में रजिस्टर होता है। दोनों एक-दूसरे से स्वतंत्र हैं, केवल अपनी ज़रूरत वाले को इंस्टॉल करना भी ठीक है।
# 1. 安装腾讯混元 provider 插件(TokenHub + TokenPlan 两个 provider 一起注册)
openclaw plugins install @openclaw/tencent-provider
# 2. 安装百度千帆 provider 插件
openclaw plugins install @openclaw/qianfan-provider
# 3. 重启 Gateway(Gateway 正在跑的话,安装会自动生效;重启最稳妥)
openclaw gateway restartआपको यह दिखना चाहिए: प्लगइन सफलतापूर्वक इंस्टॉल होने का संदेश, और Gateway पुनः आरंभ होने के बाद कोई त्रुटि नहीं।
एक व्यवहार पहले जान लें (आधिकारिक प्लगइन दस्तावेज़ में स्पष्ट रूप से लिखा है): इंस्टॉलेशन चल रहे Gateway पर स्वतः प्रभावी होता है; यदि Gateway नहीं चल रहा है तो अगली बार शुरू होने पर प्रभावी होगा।
openclaw plugins installसफलतापूर्वक निष्पादित (दोनों इंस्टॉल, या केवल अपनी ज़रूरत वाला), Gateway पुनः आरंभ हो चुका है
चरण 2: OpenClaw में हुनयुआन जोड़ें — TokenHub / TokenPlan दोनों एंडपॉइंट कॉन्फ़िगर करें
क्यों: टेंसेंट हुनयुआन के OpenClaw में दो प्रवेश बिंदु हैं — TokenHub (tencent-tokenhub) और TokenPlan (tencent-tokenplan), जो टेंसेंट क्लाउड MaaS के दो उत्पाद एंडपॉइंट से मेल खाते हैं। दोनों provider की अपनी-अपनी Key वेरिएबल और onboarding प्रवेश बिंदु हैं, इन्हें अलग-अलग एक बार चलाना होगा।
पहले टेंसेंट क्लाउड कंसोल पर जाकर API Key बनाएं। आधिकारिक दस्तावेज़ स्पष्ट रूप से मांगता है: यदि Key बनाते समय सीमित एक्सेस स्कोप (access scope) चुना है, तो अनुमत मॉडल की सूची में hy4 preview शामिल होना चाहिए — यदि TokenHub पर hy3 सीरीज़ का उपयोग करने की योजना है, तो hy3 / hy3 preview भी जोड़ना होगा।
फिर onboarding चलाएं (दोनों एंडपॉइंट पर एक-एक बार, आधिकारिक दस्तावेज़ के अनुसार):
# TokenHub 端点
openclaw onboard --auth-choice tokenhub-api-key
# TokenPlan 端点
openclaw onboard --auth-choice tokenplan-api-keyआपको यह दिखना चाहिए: Key सत्यापित होकर सहेज ली गई। आधिकारिक दस्तावेज़ में स्पष्ट रूप से लिखा है: बिल्कुल नए onboarding में दोनों एंडपॉइंट पर hy4-preview को डिफ़ॉल्ट मॉडल चुनें; आपकी मौजूदा मॉडल प्रविष्टियाँ बनी रहेंगी, अधिलेखित नहीं होंगी।
CI / स्क्रिप्ट जैसे गैर-इंटरैक्टिव परिदृश्यों में, आधिकारिक दस्तावेज़ में Key सीधे पास करने का तरीका दिया गया है (जस का तस):
# TokenHub
openclaw onboard --non-interactive \
--mode local \
--auth-choice tokenhub-api-key \
--tokenhub-api-key "$TOKENHUB_API_KEY" \
--skip-health \
--accept-risk
# TokenPlan
openclaw onboard --non-interactive \
--mode local \
--auth-choice tokenplan-api-key \
--tokenplan-api-key "$TOKENPLAN_API_KEY" \
--skip-health \
--accept-riskयदि onboarding नहीं चलाना चाहते, तो केवल एनवायरनमेंट वेरिएबल सेट करने पर भी मान्य है (आधिकारिक दस्तावेज़ के अनुसार):
export TOKENHUB_API_KEY="<你的 TokenHub Key>"
export TOKENPLAN_API_KEY="<你的 TokenPlan Key>"⚠️ Gateway डेमन के रूप में चल रहा है? Key को इंटरैक्टिव shell में मत रखें
जब Gateway launchd / systemd सेवा के रूप में चलता है, तो वह आपके टर्मिनल के export एनवायरनमेंट वेरिएबल नहीं देख सकता। TOKENHUB_API_KEY और TOKENPLAN_API_KEY को ~/.openclaw/.env में लिखें, या कॉन्फ़िगरेशन के env.shellEnv के माध्यम से उस प्रोसेस को दें — tencent के आधिकारिक दस्तावेज़ ने इस बात पर विशेष ज़ोर दिया है।
साथ ही सत्यापित करें कि दोनों provider रजिस्टर हो गए हैं:
openclaw models list --provider tencent-tokenhub
openclaw models list --provider tencent-tokenplanआपको यह दिखना चाहिए: tencent-tokenhub/ और tencent-tokenplan/ दोनों परिवार के मॉडल सूची में हैं (पूरी सूची के लिए चरण 4 देखें)।
मौजूदा उपयोगकर्ताओं के लिए एक और आधिकारिक माइग्रेशन नियम है, पहले याद रखें: मौजूदा TokenHub कॉन्फ़िगरेशन स्वतः Hy4 पर अपग्रेड नहीं होता। जब मॉडल allowlist कॉन्फ़िगर किया गया हो, तो openclaw doctor --fix केवल अप्रचलित tencent-tokenhub/hy3-preview मुख्य मॉडल को tencent-tokenhub/hy3 में बदलता है।
सूची (catalog) की hy3-preview के लिए सिफ़ारिश hy4-preview है, लेकिन Doctor यह माइग्रेशन नहीं करता — Hy4 पर अपग्रेड एक स्पष्ट क्रिया है, चुने गए एंडपॉइंट की मॉडल एक्सेस अनुमति और कीमत के अंतर की पुष्टि स्वयं करें।
openclaw models statusमें tencent के क्रेडेंशियल स्रोत दिखते हैं
चरण 3: OpenClaw में बाइडू कियानफैन जोड़ें — QIANFAN_API_KEY कॉन्फ़िगर करें
क्यों: कियानफैन (Qianfan) बाइडू का MaaS प्लेटफ़ॉर्म है — एक OpenAI-संगत एकीकृत API, एक ही Key अनुरोधों को एंडपॉइंट के पीछे के कई मॉडलों तक रूट करती है। इसका केवल एक provider है: qianfan, एक बार कॉन्फ़िगर करने पर सब कुछ चालू हो जाता है।
पहले कियानफैन कंसोल पर जाकर Key बनाएं (आधिकारिक दस्तावेज़ का सीधा लिंक):
- बाइडू AI क्लाउड पर रजिस्टर / लॉगिन करें, कियानफैन कंसोल में जाएं, कियानफैन API एक्सेस सक्रिय करें
- नया एप्लिकेशन बनाएं (या मौजूदा चुनें), API Key जनरेट करें — बाइडू क्लाउड की Key ऐसी दिखती है:
bce-v3/ALTAK-...
फिर onboarding चलाएं:
openclaw onboard --auth-choice qianfan-api-keyआपको यह दिखना चाहिए: Key सत्यापित होकर सहेज ली गई। आधिकारिक दस्तावेज़ में स्पष्ट रूप से लिखा है कि onboarding तीन काम करता है: provider कॉन्फ़िगरेशन लिखना, डिफ़ॉल्ट मॉडल में QIANFAN उपनाम जोड़ना, और जब आपने डिफ़ॉल्ट मॉडल कॉन्फ़िगर नहीं किया हो तो qianfan/deepseek-v4-pro को डिफ़ॉल्ट सेट करना। कनेक्शन सेटिंग और उपनाम सहेजे जाते हैं, लेकिन जनरेट की गई सूची की पंक्तियाँ आपके कॉन्फ़िगरेशन में कॉपी नहीं की जातीं।
गैर-इंटरैक्टिव परिदृश्यों में --qianfan-api-key <key> या एनवायरनमेंट वेरिएबल QIANFAN_API_KEY पढ़ें (आधिकारिक दस्तावेज़ के अनुसार):
export QIANFAN_API_KEY="bce-v3/ALTAK-<你的 Key>"साथ ही सत्यापित करें:
openclaw models list --provider qianfanआपको यह दिखना चाहिए: qianfan/ प्रीफ़िक्स वाले मॉडल सूची में हैं (विवरण के लिए चरण 4 देखें)। यदि सूची खाली है, तो पहले आधिकारिक ट्रबलशूटिंग सूची के पहले दो बिंदु जाँचें: Key bce-v3/ALTAK- से शुरू होती है या नहीं, और बाइडू क्लाउड कंसोल में कियानफैन सेवा सक्रिय है या नहीं।
openclaw models list --provider qianfanसूची दिखा सकता है
चरण 4: हुनयुआन / वेनशिन मॉडल चुनें और सत्यापित करें
क्यों: दोनों की सूची लंबी नहीं है, लेकिन अपनी-अपनी बारीकियाँ हैं — हुनयुआन में केवल hy सीरीज़ के तीन ID हैं, और कियानफैन की सूची स्टैटिक है (ऑनलाइन डिस्कवरी नहीं), जिसमें अप्रचलित पुराने ID भी पड़े हैं, गलत चुनने पर दिक्कत होगी।
पहले टेंसेंट हुनयुआन की सूची देखें (आधिकारिक दस्तावेज़ से व्यवस्थित):
| मॉडल संदर्भ | नाम | इनपुट | संदर्भ | अधिकतम आउटपुट | टिप्पणी |
|---|---|---|---|---|---|
tencent-tokenhub/hy4-preview | hy4 preview (TokenHub) | टेक्स्ट | 1,024,000 | 64,000 | reasoning; डिफ़ॉल्ट |
tencent-tokenhub/hy3 | hy3 (TokenHub) | टेक्स्ट | 256,000 | 128,000 | reasoning; पिछली पीढ़ी का GA |
tencent-tokenhub/hy3-preview | hy3 preview (TokenHub) | टेक्स्ट | 256,000 | 128,000 | अप्रचलित; hy4-preview का उपयोग करें |
tencent-tokenplan/hy4-preview | hy4 preview (TokenPlan) | टेक्स्ट | 1,024,000 | 64,000 | reasoning; डिफ़ॉल्ट |
tencent-tokenplan/hy3 | hy3 (TokenPlan) | टेक्स्ट | 256,000 | 128,000 | reasoning; पिछली पीढ़ी GA |
hy4-preview Hunyuan का बड़ा MoE भाषा मॉडल है, जो reasoning, लंबे context instruction-following, कोड और agent workflows के लिए है; Tencent का OpenAI-compatible उदाहरण इसे model id के रूप में उपयोग करता है, और यह standard chat-completions tool calls के साथ reasoning_effort को सपोर्ट करता है।
अब Baidu Qianfan की कैटलॉग देखें (आधिकारिक दस्तावेज़ से जस-का-तस):
| मॉडल रेफ़रेंस | इनपुट | context | अधिकतम आउटपुट | Reasoning | टिप्पणी |
|---|---|---|---|---|---|
qianfan/deepseek-v4-pro | टेक्स्ट | 1,000,000 | 393,216 | है | वर्तमान DeepSeek फ़्लैगशिप |
qianfan/ernie-5.1 | टेक्स्ट | 128,000 | 65,536 | नहीं | नवीनतम ERNIE टेक्स्ट फ़्लैगशिप |
qianfan/ernie-5.0 | टेक्स्ट, इमेज | 128,000 | 65,536 | है | मल्टीमॉडल + thinking |
qianfan/deepseek-v3.2 | टेक्स्ट | 128,000 | 32,768 | नहीं | डेप्रिकेटेड compat डिफ़ॉल्ट; deepseek-v4-pro द्वारा बदला गया |
qianfan/ernie-5.0-thinking-preview | टेक्स्ट, इमेज | 128,000 | 65,536 | है | डेप्रिकेटेड उपनाम; ernie-5.0 द्वारा बदला गया |
Qianfan कैटलॉग स्टैटिक और बिल्ट-इन है — आधिकारिक दस्तावेज़ के मूल शब्द "catalog is static; there is no live model discovery", नए मॉडलों के लिए OpenClaw प्लगइन के कैटलॉग अपडेट का इंतज़ार करना होगा।
कैसे चुनें, पाँच वाक्य:
| आपकी ज़रूरत | यह चुनें |
|---|---|
| Hunyuan का नवीनतम फ़्लैगशिप चाहिए, 1M context reasoning | tencent-tokenhub/hy4-preview (onboarding डिफ़ॉल्ट) |
| Key TokenPlan एंडपॉइंट पर है | tencent-tokenplan/hy4-preview |
| ERNIE का नवीनतम टेक्स्ट फ़्लैगशिप चाहिए | qianfan/ernie-5.1 |
| मल्टीमॉडल इनपुट + thinking वाला ERNIE चाहिए | qianfan/ernie-5.0 |
| Key Qianfan पर है, बस DeepSeek उपयोग करना चाहते हैं | qianfan/deepseek-v4-pro (onboarding डिफ़ॉल्ट) |
डिफ़ॉल्ट मॉडल बदलें:
# 混元(注意前缀跟端点走)
openclaw models set tencent-tokenhub/hy4-preview
# 文心
openclaw models set qianfan/ernie-5.1चैट में अस्थायी रूप से स्विच करना भी चलेगा: /model qianfan/ernie-5.0 केवल वर्तमान सेशन को प्रभावित करता है, कमांड परिवार का विवरण देखें चैट कमांड्स क्रैश कोर्स।
अंत में सत्यापन। एक टेस्ट संदेश भेजें:
openclaw dashboardControl UI खोलें और चैट बॉक्स में "एक वाक्य में अपना परिचय दें" भेजें।
आपको यह दिखना चाहिए: मॉडल सामान्य रूप से उत्तर देता है, कोई missing credentials या model-not-found एरर नहीं। यहाँ तक, OpenClaw के साथ Hunyuan और Baidu Qianfan दोनों जुड़ गए हैं।
कीमत एक वाक्य में: TokenHub के आधिकारिक दस्तावेज़ में कीमत नहीं दी गई; Qianfan कॉन्फ़िगरेशन उदाहरण में deepseek-v4-pro की कैटलॉग अनुमानित कीमत प्रति मिलियन token इनपुट 1.771957 / आउटपुट 3.543915 / कैश रीड 0.147663 (OpenClaw कैटलॉग संख्याएँ)। वास्तविक कीमत और करेंसी हमेशा Tencent Cloud और Baidu AI Cloud की आधिकारिक वेबसाइट के अनुसार मान्य होंगी।
- टेस्ट संदेश का उत्तर मिला, provider और मॉडल मेल खाते हैं (
tencent-tokenhub/...,tencent-tokenplan/...याqianfan/...)
चेकपॉइंट ✅
@openclaw/tencent-provider,@openclaw/qianfan-providerमें से कम से कम वह इंस्टॉल करें जिसे आप उपयोग करेंगे (इंस्टॉल करते ही प्रभावी)- Hunyuan के दोनों एंडपॉइंट के अपने-अपने Key:
TOKENHUB_API_KEY(TokenHub) +TOKENPLAN_API_KEY(TokenPlan) - Qianfan Key
bce-v3/ALTAK-से शुरू होता है, और Baidu AI Cloud कंसोल पर Qianfan सेवा सक्रिय है openclaw models list --provider tencent-tokenhub/--provider tencent-tokenplan/--provider qianfanसभी कैटलॉग सूचीबद्ध कर सकते हैं- डिफ़ॉल्ट मॉडल प्रीफ़िक्स एंडपॉइंट से मेल खाता है: Hunyuan के लिए
tencent-tokenhub/याtencent-tokenplan/लिखें, Qianfan के लिएqianfan/ - टेस्ट संदेश का उत्तर मिला
सामान्य गलतियों की चेतावनी
❌ Hunyuan Key के restricted scope में hy4 preview शामिल नहीं
लक्षण: onboarding सत्यापन पास नहीं होता, या Hunyuan मॉडल सूची गायब है, कॉल अस्वीकृत।
कारण: Tencent Cloud पर Key बनाते समय यदि restricted access scope चुना, तो allowed models की सूची में hy4 preview नहीं है — आधिकारिक दस्तावेज़ स्पष्ट रूप से इसे (साथ ही TokenHub पर उपयोग के लिए योजना किए गए hy3 / hy3 preview) allowed सूची में जोड़ने की आवश्यकता बताता है।
सही तरीका: कंसोल पर लौटकर Key के allowed model scope बदलें, या पूर्ण scope वाला दूसरा Key लें।
❌ पुराने Hunyuan मॉडल नाम उपयोग करना (hunyuan-turbo / hunyuan-larges आदि)
लक्षण: unknown model एरर।
कारण: OpenClaw का Hunyuan provider केवल hy सीरीज़ (hy4-preview, hy3, hy3-preview) रखता है — hunyuan-turbo, hunyuan-larges जैसे पुराने नाम TokenHub / TokenPlan में मौजूद नहीं हैं (सभी सूचना स्रोतों की पूर्ण जाँच में शून्य हिट)।
सही तरीका: tencent-tokenhub/hy4-preview (डिफ़ॉल्ट) या hy3 उपयोग करें; पुराने मॉडलों की ज़रूरत के लिए अगले पाठ का custom compat एंडपॉइंट उपयोग करें।
❌ Baidu Key का फ़ॉर्मैट गलत / Qianfan सेवा सक्रिय नहीं
लक्षण: openclaw models list --provider qianfan की सूची खाली है, या कॉल पर credentials एरर।
कारण: आधिकारिक ट्रबलशूटिंग सूची के पहले दो बिंदु — Key अवश्य bce-v3/ALTAK- से शुरू हो; खाते पर Baidu Cloud कंसोल से Qianfan API एक्सेस सक्रिय होना चाहिए।
सही तरीका: Qianfan कंसोल पर लौटकर Key फ़ॉर्मैट और सेवा सक्रियण स्थिति जाँचें।
❌ Qianfan कैटलॉग में ERNIE 4.5 / X1 जैसे पुराने मॉडल खोजना
कारण: Qianfan का OpenClaw कैटलॉग केवल ernie-5.1 और ernie-5.0 रखता है (स्टैटिक कैटलॉग, कोई live discovery नहीं)।
सही तरीका: पुराने ERNIE मॉडलों का कोई आधिकारिक provider नहीं है — अगले पाठ का "custom OpenAI-compatible endpoint" प्रक्रिया अपनाएँ, या OpenRouter / NovitaAI जैसे एग्रीगेटर पर hosted route खोजें।
❌ डेप्रिकेटेड पुराना ID उपयोग किया
| अप्रचलित ID | उत्तराधिकारी |
|---|---|
tencent-tokenhub/hy3-preview | निर्देशिका अनुशंसित hy4-preview; doctor --fix केवल hy3 में माइग्रेट करता है |
qianfan/deepseek-v3.2 | qianfan/deepseek-v4-pro |
qianfan/ernie-5.0-thinking-preview | qianfan/ernie-5.0 |
सही तरीका: नई कॉन्फ़िगरेशन हमेशा उत्तराधिकारी से करें; मौजूदा कॉन्फ़िगरेशन पर openclaw doctor चलाकर संकेत देखें, फिर माइग्रेट करें।
❌ Gateway को डेमन के रूप में इंस्टॉल करने के बाद, export किया गया Key "लागू नहीं होता"
कारण: launchd / systemd सेवाएँ इंटरैक्टिव shell के environment variables नहीं देख सकतीं — tencent की आधिकारिक डॉक्युमेंटेशन इस बिंदु पर विशेष ज़ोर देती है (TokenHub और TokenPlan दोनों variables सेवा प्रोसेस को देने होते हैं)।
सही तरीका: TOKENHUB_API_KEY, TOKENPLAN_API_KEY, QIANFAN_API_KEY को ~/.openclaw/.env में लिखें, या env.shellEnv के ज़रिए प्रदान करें; Key बदलने के बाद Gateway सेवा रीस्टार्ट करें।
❌ सोचना कि doctor --fix आपको Hy4 तक अपग्रेड कर देगा
कारण: आधिकारिक माइग्रेशन नियम — allowlist के साथ कॉन्फ़िगर किए गए मौजूदा TokenHub कॉन्फ़िगरेशन में, openclaw doctor --fix केवल अप्रचलित hy3-preview को hy3 में बदलता है, Hy4 में नहीं बदलता।
सही तरीका: Hy4 में अपग्रेड स्वयं स्पष्ट रूप से करें (openclaw models set tencent-tokenhub/hy4-preview), और पहले चुने गए एंडपॉइंट के मॉडल एक्सेस अनुमतियों और कीमत के अंतर की पुष्टि करें।
❌ विदेशी खाते से घरेलू एंडपॉइंट से जुड़ना (या इसका उल्टा)
कारण: TokenHub का बिल्ट-इन एंडपॉइंट https://tokenhub.tencentmaas.com/v1 है; अंतरराष्ट्रीय संस्करण के एंडपॉइंट https://tokenhub-intl.tencentmaas.com/v1 के लिए baseUrl को स्पष्ट रूप से ओवरराइड करना ज़रूरी है।
सही तरीका: विदेशी TokenHub खाते के लिए अगले सेक्शन के अनुसार baseUrl ओवरराइड करें; Qianfan के साथ भी यही बात है — केवल कस्टम एंडपॉइंट / प्रॉक्सी उपयोग करते समय ही base URL बदलें।
🔧 एडवांस्ड: एंडपॉइंट ओवरराइड और Qianfan मेमोरी एम्बेडिंग (वैकल्पिक)
TokenHub एंडपॉइंट ओवरराइड करना (अंतरराष्ट्रीय संस्करण / विशेष क्षेत्र)
बिल्ट-इन निर्देशिका https://tokenhub.tencentmaas.com/v1 का उपयोग करती है। केवल तब ओवरराइड करें जब आपका TokenHub खाता या क्षेत्र अलग एंडपॉइंट मांगता हो (आधिकारिक उदाहरण जस का तस, यहाँ अंतरराष्ट्रीय संस्करण के एंडपॉइंट का उदाहरण है):
openclaw config set models.providers.tencent-tokenhub.baseUrl "https://tokenhub-intl.tencentmaas.com/v1"मेमोरी सिस्टम के लिए Qianfan का चीनी वेक्टर मॉडल कॉन्फ़िगर करना
OpenClaw की मेमोरी रिट्रीवल को embedding मॉडल चाहिए, और Qianfan प्लगइन सीधे embedding provider की तरह काम कर सकता है — चीनी सामग्री के लिए यह विशेष रूप से उपयुक्त है (आधिकारिक उदाहरण जस का तस):
{
memory: {
search: {
provider: "qianfan",
model: "bge-large-zh",
},
},
}तीन बारीकियाँ (आधिकारिक डॉक्युमेंटेशन में स्पष्ट रूप से लिखी हैं):
- प्लगइन आपकी कॉन्फ़िगर की गई Qianfan कनेक्शन का पुनः उपयोग करता है, क्रेडेंशियल सहेजे गए profile या
QIANFAN_API_KEYसे निकाले जाते हैं; स्पष्ट रूप से दिया गया रिमोट API Key / Authorization header प्राथमिकता पाता है bge-large-zh,bge-large-en,Embedding-V1तीन मॉडलहर अनुरोध में अधिकतम 16 इनपुट (Baidu की आधिकारिक बैच सीमा का पालन), अन्य मॉडल संगत ट्रांसपोर्ट के मौजूदा व्यवहार का पालन करते हैं- मौजूदा कॉन्फ़िगरेशन यदि
openai-compatibleके ज़रिए Qianfan की ओर इशारा करता है, तोmemory.search.providerकोqianfanमें बदलना ही काफ़ी है — एंडपॉइंट और Key वैसे ही रहते हैं
मेमोरी सिस्टम के बारे में विस्तार से देखें मेमोरी सिस्टम: Claw को आपको याद रखने दें।
केवल कस्टम मेटाडेटा की ज़रूरत होने पर ही models.providers लिखें
आधिकारिक नियम: प्लगइन इंस्टॉल होना + auth कॉन्फ़िगर होना ही काफ़ी है, की ज़रूरत नहीं models.providers एंट्री लिखने की; केवल baseUrl या मॉडल मेटाडेटा ओवरराइड करते समय लिखें। Qianfan की पूर्ण स्पष्ट कॉन्फ़िगरेशन ऐसी दिखती है (आधिकारिक उदाहरण से जस का तस अंश):
{
env: { vars: { QIANFAN_API_KEY: "bce-v3/ALTAK-..." } },
agents: {
defaults: {
model: { primary: "qianfan/deepseek-v4-pro" },
models: {
"qianfan/deepseek-v4-pro": { alias: "QIANFAN" },
},
},
},
models: {
providers: {
qianfan: {
baseUrl: "https://qianfan.baidubce.com/v2",
api: "openai-completions",
models: [
{
id: "deepseek-v4-pro",
name: "DeepSeek V4 Pro",
reasoning: true,
input: ["text"],
cost: {
input: 1.771957,
output: 3.543915,
cacheRead: 0.147663,
cacheWrite: 0,
},
contextWindow: 1000000,
maxTokens: 393216,
},
],
},
},
},
}एक और संगतता नोट है (आधिकारिक डॉक्युमेंटेशन का मूल आशय): Qianfan OpenAI-संगत ट्रांसपोर्ट पथ से चलता है, न कि नेटिव OpenAI अनुरोध shaping से — मानक OpenAI SDK विशेषताएँ उपलब्ध हैं, लेकिन provider-विशिष्ट पैरामीटर फॉरवर्ड नहीं हो सकते। Qianfan API की आधिकारिक डॉक्युमेंटेशन देखें cloud.baidu.com/doc/qianfan-api।
अगला कदम
OpenClaw के साथ Hunyuan और Baidu Qianfan जोड़ना इस तरह पूरा हुआ। घरेलू मॉडल पेज पर आगे बढ़ें:
- अगला पाठ और घरेलू मॉडल तथा कस्टम रिले एंडपॉइंट: Xinghuo, Baichuan जैसे मॉडल जिनका आधिकारिक provider नहीं है, और OpenRouter / LiteLLM / कस्टम रिले के तरीके
- अन्य मॉडल पेज (लोकल मॉडल) मॉडल कनेक्शन की समग्र जानकारी के पाठ्यक्रम तालिका से शुरू करें
- मॉडल कॉन्फ़िगर हो गए? रोज़मर्रा के उपयोग की शुरुआत रोज़मर्रा का उपयोग: अपने Claw के साथ कुशलता से काम करें से करें — Control UI, चैट कमांड, मेमोरी सिस्टम सब उसी अध्याय में हैं
संबंधित ट्यूटोरियल
- लोकल मॉडल: Ollama, vLLM और ds4
- WeChat, QQ और Yuanbao: Tencent-पारिवारिक चैनल जोड़ना — मॉडल के लिए Tencent Hunyuan का उपयोग करें, और चैट चैनल के लिए भी Tencent-पारिवारिक IM चुन सकते हैं
- मेमोरी सिस्टम: Claw को आपको याद रखने दें