फ़ीशू इंटीग्रेशन: आधिकारिक प्लगइन, ग्रुप चैट और डॉक्यूमेंट टूल
💡 एक वाक्य में सार: OpenClaw से फ़ीशू में रहने वाला AI सहकर्मी बनाएं —— आधिकारिक प्लगइन विज़ार्ड से इंटीग्रेशन, ग्रुप चैट में स्ट्रीमिंग कार्ड रिप्लाई, फ़ीशू डॉक्यूमेंट और मल्टी-डाइमेंशनल टेबल को सीधे पढ़ना-लिखना।
ऑफ़िस रूट का दूसरा पाठ। आपनेपरिदृश्य व्यवहार में यह रास्ता चुना। पिछले पाठ काएंटरप्राइज़ WeChat टेंसेंट WeCom टीम के बाहरी प्लगइन पर निर्भर था, यह पाठ और भी आसान है——OpenClaw फ़ीशू इंटीग्रेशन आधिकारिक @openclaw/feishu प्लगइन (आधिकारिक चैनल डायरेक्टरी में बिल्ट-इन) पर आधारित है, bot निजी चैट + ग्रुप चैट पहले से production-ready हैं, रिप्लाई स्ट्रीमिंग कार्ड से आती है, और फ़ीशू डॉक्यूमेंट / wiki / क्लाउड ड्राइव / Bitable टूल भी साथ में हैं। सभी उदाहरण OpenClaw v2026.10.9 पर आधारित हैं।
सीखने के बाद आप क्या कर सकेंगे
openclaw channels login --channel feishuविज़ार्ड एक बार चलाएं, 15 मिनट में बॉट को फ़ीशू पर लाइव करें (QR स्कैन से अपने आप बनाएं, या मैन्युअली App ID / App Secret पेस्ट करें)- फ़ीशू एक-पर-एक चैट और ग्रुप में इसे @करें, जनरेट होते ही रिफ्रेश होती स्ट्रीमिंग कार्ड रिप्लाई पाएं
- इससे नया फ़ीशू डॉक्यूमेंट बनवाकर मीटिंग के कार्यवृत्त लिखवाएं, करने के कामों को Bitable मल्टी-डाइमेंशनल टेबल में दर्ज करवाएं
- ग्रुप व्हाइटलिस्ट + ग्रुप के भीतर सेंडर व्हाइटलिस्ट + @मेंशन थ्रेशोल्ड से नियंत्रित करें कि कौन इस्तेमाल कर सकता है, कौन सा ग्रुप एक्सेस कर सकता है
वेब-आधारित AI की जगह OpenClaw क्यों?
| क्षमता | वेब-आधारित AI | OpenClaw + आधिकारिक फ़ीशू प्लगइन |
|---|---|---|
| जहाँ उपलब्ध | ❌ अलग से वेबपेज खोलना पड़ता है, ग्रुप में इस्तेमाल नहीं | ✅ सीधे फ़ीशू एक-पर-एक/ग्रुप चैट में, बस @करें |
| रिप्लाई अनुभव | ❌ केवल पूरा जनरेट होने के बाद दिखता है | ✅ कार्ड स्ट्रीमिंग अपडेट, जनरेट होते देखते जाएं |
| फ़ीशू बिज़नेस संचालन | ❌ डॉक्यूमेंट/मल्टी-डाइमेंशनल टेबल/नॉलेज बेस तक पहुँच नहीं | ✅ बिल्ट-इन doc / wiki / drive / Bitable टूल परिवार |
| इंटीग्रेशन लागत | ❌ इंटीग्रेशन का कोई सवाल ही नहीं | ✅ आधिकारिक प्लगइन + विज़ार्ड, WebSocket डिफ़ॉल्ट रूप से पब्लिक नेटवर्क पर नहीं |
| डेटा और मॉडल | ❌ बातचीत पूरी तरह सेवा प्रदाता के पास | ✅ Gateway आपकी मशीन पर चलता है, मॉडल जबरदस्त बदल सकते हैं (घरेलू मॉडल सहित) |
आपकी मौजूदा दिक्कत
- ज़रूरतें और निष्कर्ष दर्जनों ग्रुप, सैकड़ों फ़ीशू डॉक्यूमेंट में बिखरे हैं, नया सदस्य «पिछली बार का निर्णय» पूछे तो कोई पूरा जवाब नहीं दे पाता
- मीटिंग के बाद कोई कार्यवृत्त बनाना नहीं चाहता, काम मौखिक बातों पर चलते हैं, हफ़्ते भर बाद कोई याद नहीं रहता
- पूरे ग्रुप के लिए AI असिस्टेंट देना चाहते हैं, पर आंतरिक डेटा पब्लिक वेबपेज में पेस्ट करने का साहस नहीं
यह तरीका कब अपनाएं
जब आपको चाहिए:
- AI असिस्टेंट सीधे फ़ीशू में रहे, सहकर्मी चैट विंडो में @करके इस्तेमाल कर सकें, कोई नया टूल इंस्टॉल न करना पड़े
- यह सहज रूप से डॉक्यूमेंट बना सके, कार्यवृत्त लिख सके, मल्टी-डाइमेंशनल टेबल में दर्ज कर सके, नॉलेज बेस खोज सके
- सर्वर पब्लिक नेटवर्क पर न होने पर भी इंटीग्रेशन (WebSocket लॉन्ग कनेक्शन डिफ़ॉल्ट मोड है)
और नहीं चाहते:
- हर बार ब्राउज़र पर जाकर, वेबपेज में कॉपी-पेस्ट करना
- खुद शून्य से फ़ीशू इवेंट कॉलबैक सर्विस लिखना
- आंतरिक बातचीत थर्ड-पार्टी होस्टेड सर्विस को सौंपना
🎒 शुरू करने से पहले की तैयारी
- परिदृश्य व्यवहार: अपना रास्ता चुनें पूरा कर चुके हैं: Gateway चल रहा है, कम से कम एक मॉडल जुड़ा है
openclaw --version2026.5.29 या उससे ऊपर दिखाता है (फ़ीशू चैनल की न्यूनतम संस्करण आवश्यकता; इस ट्यूटोरियल का आधार v2026.10.9 इसे पूरा करता है)- एक ऐसा खाता जो फ़ीशू ओपन प्लेटफ़ॉर्म पर लॉगिन करके सेल्फ़-बिल्ट ऐप बना सके (अंतरराष्ट्रीय संस्करण Lark के लिए Lark Developer)
- एक कप पानी ☕——15 मिनट बाद आपके फ़ीशू में एक AI सहकर्मी जुड़ जाएगा
मेरे साथ करें
चरण 1: OpenClaw फ़ीशू चैनल विज़ार्ड चलाएं, आधिकारिक प्लगइन (@openclaw/feishu) इंस्टॉल करें
क्यों: फ़ीशू चैनल आधिकारिक @openclaw/feishu प्लगइन से मिलता है, raw कॉन्फ़िगरेशन में हाथ से नहीं बनाना पड़ता——विज़ार्ड प्लगइन अपने आप इंस्टॉल करता है, क्रेडेंशियल कॉन्फ़िगर करता है, एक ही बार में पूरा।
openclaw channels login --channel feishuविज़ार्ड आपको दो रास्ते देता है:
- तरीका A: QR स्कैन करके बॉट बनाएं——फ़ीशू ऐप में QR कोड स्कैन करें, बॉट अपने आप बन जाता है; इस रास्ते में निजी चैट सिर्फ़ आपके इस्तेमाल तक सीमित रहती है (
dmPolicy: "allowlist"+ आपका open_id), सबसे आसान - तरीका B: क्रेडेंशियल मैन्युअली पेस्ट करें——पहले फ़ीशू ओपन प्लेटफ़ॉर्म पर जाकर एक सेल्फ-बिल्ट ऐप बनाएं, और App ID और App Secret को विज़ार्ड में पेस्ट करें
विज़ार्ड दो चीज़ें भी पूछेगा: API डोमेन (घरेलू Feishu feishu / अंतर्राष्ट्रीय Lark) और ग्रुप नीति।
आपको यह दिखना चाहिए: विज़ार्ड पूरा चला, कॉन्फ़िगरेशन लिखा गया, कोई त्रुटि नहीं।
💡 घरेलू Feishu ऐप से QR स्कैन में अक्सर कोई प्रतिक्रिया नहीं मिलती
आधिकारिक ट्रबलशूटिंग पेज इसे एक ज्ञात स्थिति के रूप में सूचीबद्ध करता है: घरेलू Feishu मोबाइल क्लाइंट QR स्कैन से bot बनाने पर हमेशा प्रतिक्रिया नहीं देता। ऐसा हो तो openclaw channels login --channel feishu दोबारा चलाएं और मैन्युअल मोड चुनें, App ID / App Secret पेस्ट करने से भी काम बन जाएगा।
- विज़ार्ड बिना किसी त्रुटि के पूरा चला
चरण 2: सत्यापित करें कि Feishu चैनल ऑनलाइन है
क्यों: कॉन्फ़िगरेशन बदलाव हॉट-रीलोड से लागू होते हैं, लेकिन आपको bot से बात करने से पहले यह पुष्टि करनी चाहिए कि चैनल वास्तव में तैयार है।
openclaw channels status --probeआपको यह दिखना चाहिए: feishu चैनल तैयार दिखाई दे रहा है। यदि Gateway ऑफ़लाइन है तो पहले उसे शुरू करें, फिर एक बार प्रोब करें।
openclaw channels status --probeमें feishu तैयार दिखाई देता है
चरण 3: प्राइवेट चैट में पहला संदेश भेजें, पेयरिंग कोड से मंज़ूरी दें
क्यों: डिफ़ॉल्ट dmPolicy: "pairing"——अजनबी उपयोगकर्ता को पहली बार प्राइवेट चैट में सिर्फ एक पेयरिंग कोड मिलेगा, और आपके CLI में मंज़ूरी देने के बाद ही पहुंच मिलेगी। यह bot को कंपनी के बाहरी लोगों द्वारा मुफ़्त में इस्तेमाल होने से रोकने की पहली दीवार है।
करने के लिए: Feishu में bot ढूंढें, प्राइवेट चैट में एक "नमस्ते" भेजें।
यदि आपने क्रेडेंशियल मैन्युअली पेस्ट करके bot बनाया है, तो पहली बातचीत में आपको पेयरिंग कोड मिलेगा, टर्मिनल पर लौटकर मंज़ूरी दें:
openclaw pairing list feishu
openclaw pairing approve feishu <配对码>आपको यह दिखना चाहिए: bot जवाब देना शुरू करता है, और जवाब एक कार्ड में स्ट्रीमिंग अपडेट के साथ आता है——जनरेट होते ही रिफ्रेश होता रहता है, यह Feishu Card Kit का स्ट्रीमिंग कार्ड है (streaming.mode डिफ़ॉल्ट partial)। QR स्कैन से बने bot की प्राइवेट चैट पहले से ही सिर्फ आप तक सीमित है, पेयरिंग ट्रिगर नहीं होगी।
💡 Feishu में स्लैश कमांड मेनू नहीं होता
/status(स्थिति देखें), /reset(सेशन रीसेट करें), /model(मॉडल देखें/बदलें), /followup <消息>(क़तार में एक संदेश जोड़ें)——इन सबको सामान्य टेक्स्ट की तरह सीधे भेजना होगा। कंट्रोल कमांड सामान्य संदेश क़तार में नहीं जाते——जब वह काम में लगा हो तब भी /status से प्रगति देख सकते हैं।
चरण 4: ग्रुप में जोड़ें, ग्रुप व्हाइटलिस्ट और @मेंशन कॉन्फ़िगर करें
क्यों: डिफ़ॉल्ट groupPolicy: "allowlist"(जो ग्रुप सूचीबद्ध नहीं हैं उन्हें नज़रअंदाज़ किया जाता है) और ग्रुप में @bot करने पर ही जवाब मिलता है——पहले ID लें, फिर अपने ग्रुप को व्हाइटलिस्ट में जोड़ें।
पहले दो ID लें:
- ग्रुप ID(
chat_id,oc_से शुरू): ग्रुप खोलें → दाएं ऊपर का मेनू → सेटिंग्स, सेटिंग्स पेज पर ही लिखा होगा - उपयोगकर्ता open_id(
ou_से शुरू): bot को एक प्राइवेट संदेश भेजें,openclaw logs --followमेंopen_idढूंढें; याopenclaw pairing list feishuदेखें
openclaw.json में अपने ग्रुप को मंज़ूरी दें (उदाहरण: दो ग्रुप मंज़ूर करें, जिनमें से एक @-मुक्त है):
{
"channels": {
"feishu": {
"groupPolicy": "allowlist",
"groupAllowFrom": ["oc_xxx", "oc_yyy"],
"groups": {
"oc_xxx": { "requireMention": false }
}
}
}
}बदलने के बाद हॉट-रीलोड लागू होने दें (Gateway रीस्टार्ट करने की ज़रूरत नहीं), bot को ग्रुप में खींचकर कुछ कहें।
आपको यह दिखना चाहिए: व्हाइटलिस्ट ग्रुप के संदेशों का जवाब मिलता है; requireMention: false वाले ग्रुप में @ किए बिना भी जवाब मिलता है; जो ग्रुप सूचीबद्ध नहीं हैं वहां कही बात पानी में जाती है।
तीन परतों का नियंत्रण अलग-अलग हिस्सा संभालता है:
| परत | फ़ील्ड | क्या संभालता है |
|---|---|---|
| ग्रुप | groupAllowFrom / groups.<群ID> | कौन से ग्रुप आ सकते हैं |
| मेंशन | requireMention | ग्रुप में @ करना ज़रूरी है या नहीं (डिफ़ॉल्ट ज़रूरी; groupPolicy: "open" होने पर डिफ़ॉल्ट @-मुक्त) |
| व्यक्ति | groups.<群ID>.allowFrom | ग्रुप में किन सदस्यों की बात मानी जाती है (groupSenderAllowFrom से ग्लोबली एक साथ सेट किया जा सकता है) |
⚠️ @सबको करना @bot करने के बराबर नहीं है
@all / @_all जैसे ब्रॉडकास्ट मेंशन को bot के प्रति मेंशन नहीं माना जाता; जवाब ट्रिगर करने के लिए सीधे उसे @ करना होगा।
चरण 5: इसे Feishu डॉक्यूमेंट और Bitable संचालित करने दें
क्यों: यह Feishu चैनल का सबसे कीमती हिस्सा है——प्लगइन के साथ Feishu के काम के टूल्स का पूरा सेट आता है, डिफ़ॉल्ट में ही चालू, आप बस मांग करें।
करने के लिए: इससे कहें "《11 माह की साप्ताहिक बैठक के कार्यवृत्त》 शीर्षक वाला एक Feishu डॉक्यूमेंट बनाओ"।
आपको यह दिखना चाहिए: वह डॉक्यूमेंट बना देता है और लिंक बातचीत में भेज देता है।
दो टूल्स के व्यवहार की स्पष्ट समझ रखें:
feishu_docडॉक्यूमेंट बनानासिर्फ शीर्षक के साथ——मुख्य सामग्री के लिए उसे लौटाए गएdocument_idसे दोबारा लिखवाना होगा। इसलिए सीधे कहें "डॉक्यूमेंट बनाओ और नीचे दी सामग्री उसमें लिखो", ताकि वह खुद दो चरणों में करे, सिर्फ "एक डॉक्यूमेंट बनाओ" मत कहें- Bitable
/base/लिंक में मौजूद application token (या वह जोapp_tokenलौटाता है) पहचानता है, पहचानता नहीं/wiki/लिंक का नोड token——बहुआयामी तालिका देते समय/base/लिंक पेस्ट करना सबसे भरोसेमंद है
टूल-परिवार के स्विच (सभी channels.feishu.tools.* के अंतर्गत):
| टूल परिवार | क्या करता है | डिफ़ॉल्ट |
|---|---|---|
tools.doc | Feishu डॉक्यूमेंट पढ़ना-लिखना | ✅ चालू |
tools.wiki | नॉलेज बेस (doc पर निर्भर) | ✅ चालू |
tools.drive | क्लाउड ड्राइव | ✅ चालू |
tools.bitable | बहुआयामी तालिका | ✅ चालू |
tools.chat | ग्रुप/सदस्य जानकारी क्वेरी | ✅ चालू |
tools.scopes | ऐप अनुमति scope डायग्नोसिस | ✅ चालू |
tools.perm | अनुमति प्रबंधन | ⚠️ बंद (संवेदनशील, ज़रूरत पर चालू करें) |
💡 यही OpenClaw का अनन्य मूल्य है
वेब-आधारित AI आपके Feishu तक भी नहीं पहुंच सकता; यह Claw मूल रूप से डॉक्यूमेंट, नॉलेज बेस, क्लाउड ड्राइव, बहुआयामी तालिका टूल्स लेकर आता है——"अभी चर्चा किए गए कामों को बहुआयामी तालिका में लिख दो" जैसे काम एक वाक्य का बात है, निर्यात-आयात की ज़रूरत नहीं।
चरण 6: लॉन्च से पहले प्राइवेट चैट भी कसें
क्यों: मैन्युअली बनाए ऐप का डिफ़ॉल्ट dmPolicy: "pairing"(पेयरिंग कोड की एक-एक मंज़ूरी), टीम के अंदर उपयोग के लिए व्हाइटलिस्ट पर स्विच करना ज़्यादा आसान है; QR स्कैन से बना bot पहले से ही सिर्फ आप तक सीमित है, यह चरण छोड़ सकते हैं।
{
"channels": {
"feishu": {
"dmPolicy": "allowlist",
"allowFrom": ["ou_user1", "ou_user2"]
}
}
}आपको यह दिखना चाहिए: व्हाइटलिस्ट से बाहर के उपयोगकर्ताओं की प्राइवेट चैट पर अब कोई प्रतिक्रिया नहीं। एक्सेस नियंत्रण और सुरक्षा मज़बूती की पूरी व्यवस्था के लिए 安全加固(一):访问控制与身份 देखें।
📋 मैजिक Prompt
नीचे दिए Prompt सीधे Feishu चैट विंडो में पेस्ट करके bot को भेजें। ये सभी चरण 5 में अनलॉक किए गए Feishu टूल-परिवारों का उपयोग करेंगे।
📝 मीटिंग की कार्यवाही एक क्लिक में डॉक्यूमेंट में
अपेक्षित परिणाम: बॉट feishu_doc टूल को कॉल करता है, पहले शीर्षक वाला डॉक्यूमेंट बनाता है, फिर मुख्य सामग्री लिखता है, और डॉक्यूमेंट का लिंक ग्रुप में भेजता है।
## भूमिका
आप मीटिंग सचिव हैं, लंबी चर्चाओं को क्रियान्वयन योग्य कार्यवाही में समेटने में माहिर।
## कार्य
नीचे दी गई मीटिंग का रिकॉर्ड कार्यवाही में समेटें: पहले फ़ीशू में 【文档标题】 शीर्षक वाला एक डॉक्यूमेंट बनाएं, फिर कार्यवाही की मुख्य सामग्री उस डॉक्यूमेंट में लिखें, और अंत में डॉक्यूमेंट का लिंक इस ग्रुप में भेजें।
## इनपुट जानकारी
### अनिवार्य फ़ील्ड
- डॉक्यूमेंट शीर्षक:【मीटिंग का नाम + दिनांक】
- मीटिंग रिकॉर्ड:【ट्रांसक्रिप्ट मूल पाठ या आपके त्वरित नोट्स पेस्ट करें】
### वैकल्पिक फ़ील्ड
- मुख्य विषय:【किन विषयों पर विस्तार से चर्चा चाहिए?】
## आउटपुट विनिर्देश
कार्यवाही तीन खंडों में हो: 「निष्कर्ष / करने के लिए कार्य / अपूर्ण मुद्दे」; करने के लिए कार्य तालिका में: बात | ज़िम्मेदार व्यक्ति | समय-सीमा। ग्रुप में केवल डॉक्यूमेंट लिंक और एक पंक्ति का सारांश भेजें।
## बंधन शर्तें
- ✅ प्रत्येक करने के लिए कार्य किसी विशिष्ट व्यक्ति से जुड़ा हो
- ✅ जिन कार्यों का ज़िम्मेदार तय नहीं हुआ, उन्हें अलग से दावे के लिए सूचीबद्ध करें
- ❌ ग्रुप में कार्यवाही का पूरा पाठ स्क्रीन भरते हुए पेस्ट न करें📋 ग्रुप चर्चा के करने के लिए कार्य Bitable में दर्ज करें
अपेक्षित परिणाम: बॉट feishu_bitable_* टूल को कॉल करता है, और ग्रुप चैट के करने के लिए कार्यों को एक-एक करके बहुआयामी तालिका में लिखता है।
## भूमिका
आप प्रोजेक्ट सहायक हैं, ग्रुप चैट के निष्कर्षों को ट्रैक करने योग्य रिकॉर्ड में बदलने के लिए ज़िम्मेदार।
## कार्य
आज इस ग्रुप की चर्चा में आए सभी करने के लिए कार्यों को एक-एक करके बहुआयामी तालिका 【/base/ से शुरू होने वाला तालिका लिंक पेस्ट करें】 में लिखें।
## इनपुट जानकारी
### अनिवार्य फ़ील्ड
- लक्ष्य तालिका:【/base/ से शुरू होने वाला बहुआयामी तालिका लिंक】
### वैकल्पिक फ़ील्ड
- समय-सीमा का डिफ़ॉल्ट मान:【जिन कार्यों की समय-सीमा स्पष्ट नहीं है, उनके लिए कौन-सी तारीख़ एक समान भरें?】
## आउटपुट विनिर्देश
प्रत्येक करने के लिए कार्य एक पंक्ति में: बात | ज़िम्मेदार व्यक्ति | समय-सीमा। सब लिखने के बाद ग्रुप में एक सारांश भेजें: कुल कितने कार्य, किसे सौंपे गए।
## बंधन शर्तें
- ✅ केवल वही कार्य दर्ज करें जो ग्रुप में वास्तव में आए हों
- ❌ स्वयं करने के लिए कार्य गढ़ें नहीं
- ❌ अगर तालिका लिंक /base/ से शुरू नहीं होता तो पहले मुझसे पूछें, ज़बरदस्ती लिखें नहीं📚 नॉलेज बेस प्रश्न-उत्तर स्रोत सहित
अपेक्षित परिणाम: बॉट feishu_wiki टूल से नॉलेज बेस खोजने के बाद उत्तर देता है, साथ में संदर्भित नोड के लिंक जोड़ता है।
## भूमिका
आप टीम के नॉलेज प्रबंधक हैं, प्रश्नों के उत्तर देते समय स्रोत देना अनिवार्य है।
## कार्य
फ़ीशू नॉलेज बेस में 【问题主题】 से संबंधित सामग्री खोजें, मेरे प्रश्न का उत्तर दें, और आपने जिन नॉलेज बेस नोड्स का संदर्भ लिया उनके लिंक जोड़ें।
## इनपुट जानकारी
### अनिवार्य फ़ील्ड
- प्रश्न:【आपका प्रश्न】
### वैकल्पिक फ़ील्ड
- दायरा सीमा:【केवल किसी एक स्पेस या नोड के अंतर्गत खोजें?】
## आउटपुट विनिर्देश
पहले एक पंक्ति में उत्तर दें, फिर 3 तक आधार दें, प्रत्येक के साथ नॉलेज बेस लिंक।
## बंधन शर्तें
- ✅ न मिले तो स्पष्ट कहें, और जहाँ आपने खोज की उन स्थानों की सूची दें
- ❌ हवा में उत्तर गढ़ें नहींचेकपॉइंट ✅
openclaw channels status --probefeishu चैनल तैयार दिखाता है- निजी चैट में संदेश भेजें, उत्तर कार्ड में स्ट्रीमिंग अपडेट के साथ आता है
- ग्रुप में @बॉट करने पर जवाब देता है;
requireMention: falseवाले ग्रुप में @ किए बिना भी जवाब देता है - इसे एक फ़ीशू डॉक्यूमेंट बनाने को कहें, लिंक खुलने योग्य हो, शीर्षक सही हो
dmPolicy/groupPolicyदोनों आपकी ज़रूरत के अनुसार कस दिए गए हैं (या आपने स्पष्ट रूप से डिफ़ॉल्ट रखने का निर्णय लिया है)
आम ग़लतियों की चेतावनी
❌ बॉट ग्रुप में शामिल हुआ, पर बात करने पर अनदेखा करता है
कारण: ग्रुप में डिफ़ॉल्ट रूप से @बॉट करना पड़ता है; या ग्रुप श्वेतसूची में नहीं है (groupPolicy डिफ़ॉल्ट रूप से allowlist), या उसे disabled सेट किया गया है।
सही तरीक़ा: चरण 4 के अनुसार ग्रुप ID (oc_ से शुरू) को groupAllowFrom में जोड़ें, बात करते समय उसे @ करें; फिर भी न हो तो openclaw logs --follow से लॉग देखें।
❌ निजी चैट में भी कोई प्रतिक्रिया नहीं, कोई भी संदेश प्राप्त नहीं होता
कारण: फ़ीशू ओपन प्लेटफ़ॉर्म पक्ष पर कॉन्फ़िगरेशन सही नहीं है — ऐप प्रकाशित/अनुमोदित नहीं, इवेंट सब्सक्रिप्शन में im.message.receive_v1 नहीं है, इवेंट रिसेप्शन में लंबा कनेक्शन (WebSocket) चयनित नहीं, या अनुमति scope पूरी नहीं दी गईं।
सही तरीक़ा: एक-एक करके जाँचें: ऐप प्रकाशित और अनुमोदित → इवेंट सब्सक्रिप्शन में im.message.receive_v1 शामिल → रिसेप्शन विधि में लंबा कनेक्शन चुनें → आवश्यक scope पूरे करें → openclaw gateway status से पुष्टि करें कि Gateway चल रहा है।
❌ चीनी फ़ीशू App से QR स्कैन कर bot बनाने पर कोई प्रतिक्रिया नहीं
कारण: चीनी संस्करण फ़ीशू मोबाइल क्लाइंट QR स्कैन प्रक्रिया पर हमेशा प्रतिक्रिया नहीं देता (आधिकारिक ट्रबलशूटिंग पेज पर ज्ञात स्थिति)।
सही तरीक़ा: openclaw channels login --channel feishu दोबारा चलाएं और मैनुअल मोड चुनें — ओपन प्लेटफ़ॉर्म पर जाकर स्व-निर्मित ऐप बनाएं, App ID / App Secret कॉपी करके विज़ार्ड में पेस्ट करें।
❌ App Secret लीक हो गया
सही तरीक़ा: तुरंत फ़ीशू ओपन प्लेटफ़ॉर्म पर जाकर Secret रीसेट करें → कॉन्फ़िगरेशन में मान अपडेट करें → openclaw channels status --probe से पुष्टि करें कि हॉट रीलोड लागू हो गया। कॉन्फ़िगरेशन हॉट रीलोड से चलता है, Gateway पुनरारंभ करने की ज़रूरत नहीं।
उन्नत तकनीकें (वैकल्पिक)
बहु-खाता: एक Gateway पर कई फ़ीशू बॉट
accounts में कई bot कॉन्फ़िगर करें (जैसे main / backup), defaultAccount से आउटबाउंड डिफ़ॉल्ट खाता निर्दिष्ट करें। खाता-स्तरीय फ़ील्ड शीर्ष-स्तर को ओवरराइड करते हैं, TTS खाते के अनुसार गहरे मर्ज होता है — एक ही वॉइस क्रेडेंशियल साझा, प्रत्येक bot की अलग आवाज़।
ग्रुप सत्र ग्रैन्युलैरिटी और टॉपिक थ्रेड
groupSessionScope नियंत्रित करता है कि ग्रुप संदेश सत्र से कैसे मैप होते हैं: group (डिफ़ॉल्ट, एक ग्रुप एक सत्र), group_sender (व्यक्ति के अनुसार विभाजित), group_topic (टॉपिक के अनुसार विभाजित), group_topic_sender (टॉपिक + व्यक्ति)। चाहें कि बॉट के उत्तर अपने आप टॉपिक थ्रेड में खुलें, तो replyInThread: "enabled" कॉन्फ़िगर करें।
डायनामिक Agent: सार्वजनिक बॉट उपयोगकर्ता के अनुसार अलग-थलग
बाहरी उपयोगकर्ताओं के लिए खोलने (dmPolicy: "open" + allowFrom: ["*"]) पर dynamicAgentCreation.enabled: true चालू करें — प्रत्येक निजी चैट उपयोगकर्ता के लिए अपने आप अलग agent बनता है (ID का रूप feishu-<open_id>), वर्कस्पेस, मेमोरी, सत्र इतिहास सब अलग-थलग। दो बातें ध्यान रखें: यह संदेश संदर्भ का अलगाव है, दुर्भावनापूर्ण सह-किरायेदारी से बचाव की सुरक्षा सीमा नहीं; इसके लिए configWrites चालू रहना ज़रूरी है (डिफ़ॉल्ट रूप से चालू)।
स्टिकर उत्तर
actions.sticker: true के बाद, बॉट जिन्हें प्राप्त कर चुका है स्टिकर वैसे ही वापस भेज सकता है; stickerSets भी कॉन्फ़िगर करने पर कीवर्ड से स्टिकर खोज सकता है (जैसे 「赞」→ 👍)। सीमा: 32 bot सेट, प्रति सेट 256 स्टिकर, प्रति स्टिकर 1–8 कीवर्ड। ध्यान रखें कि यह केवल वही स्टिकर भेज सकता है जो उसे प्राप्त हुए हैं; नए स्टिकर अपलोड करना, स्टिकर स्टोर खोजना समर्थित नहीं।
webhook मोड (आमतौर पर ज़रूरत नहीं)
WebSocket डिफ़ॉल्ट है, सार्वजनिक नेटवर्क खोले बिना काम करता है। वास्तव में कॉलबैक की ज़रूरत हो तभी connectionMode: "webhook" पर स्विच करें: साझा Gateway HTTP पोर्ट (डिफ़ॉल्ट 18789) का /feishu/events पाथ, जिसके लिए verificationToken + encryptKey चाहिए, और Gateway होस्ट की घड़ी फ़ीशू से 1 घंटे से कम अंतर पर होनी चाहिए (NTP सिंक बनाए रखें), वरना हस्ताक्षर सत्यापन 401।
सीमाएँ और कोटा बचाने के दो स्विच
मीडिया भेजने की सीमा 30 MB (mediaMaxMb), लंबे पाठ 4000 अक्षरों के खंडों में (textChunkLimit)। फ़ीशू API कोटा बचाने के लिए: typingIndicator: false से 「टाइप कर रहा है」 reaction बंद करें, resolveSenderNames: false से भेजने वाले के नाम की क्वेरी बंद करें।
बहु-Agent रूटिंग (उपयोगकर्ता/ग्रुप के अनुसार संदेश अलग agent में भेजना) देखें C3 बहु-Agent सहयोग।
इस पाठ का सारांश
✅ अब आप कर सकते हैं:
- OpenClaw फ़ीशू एकीकरण पूरा करना: निजी चैट/ग्रुप चैट में स्ट्रीमिंग कार्ड उत्तर वाला AI सहायक (विज़ार्ड से प्लगइन इंस्टॉल → पेयर कर ग्रुप में शामिल → डॉक्यूमेंट टूल अनलॉक)
/status,/modelजैसे नियंत्रण कमांड सामान्य पाठ की तरह भेजना, और काम के दौरान भी कभी भी प्रगति देखना- इसे फ़ीशू डॉक्यूमेंट बनाने, कार्यवाही लिखने, Bitable में दर्ज करने, नॉलेज बेस खोजने के लिए कहना
- श्वेतसूची (निजी चैट / ग्रुप / ग्रुप में भेजने वाला) + @उल्लेख थ्रेशोल्ड से एक्सेस नियंत्रित करना
मुख्य कॉन्फ़िगरेशन फ़ील्ड की समीक्षा:
| फ़ील्ड | अनुशंसित मान | विवरण |
|---|---|---|
channels.feishu.connectionMode | websocket (डिफ़ॉल्ट) | इवेंट ट्रांसपोर्ट, सार्वजनिक URL की ज़रूरत नहीं |
channels.feishu.dmPolicy | pairing (डिफ़ॉल्ट) / allowlist | DM नीति; QR कोड से बनाया गया bot स्वतः ही उस व्यक्ति पर लॉक हो जाता है |
channels.feishu.groupPolicy | allowlist (डिफ़ॉल्ट) | ग्रुप नीति, groupAllowFrom के साथ मिलकर उपयोग करें |
channels.feishu.requireMention | true (डिफ़ॉल्ट) | ग्रुप में @ करने पर ही जवाब देता है; open नीति के तहत डिफ़ॉल्ट रूप से मुक्त |
channels.feishu.groups.<群ID>.allowFrom | प्रत्येक ग्रुप के लिए open_id भरें | ग्रुप के भेजने वालों की व्हाइटलिस्ट |
channels.feishu.tools.perm | false (डिफ़ॉल्ट) | अनुमति प्रबंधन टूल, संवेदनशील है, आवश्यकतानुसार चालू करें |
अगले पाठ का पूर्वावलोकन
अगला पाठ A3 WeChat, QQ और Yuanbao: Tencent-पारिवारिक चैनलों का एकीकरण, आप सीखेंगे:
- व्यक्तिगत WeChat एकीकरण की क्षमता सीमाएँ (केवल DM, ग्रुप चैट समर्थित नहीं)
- QQ आधिकारिक bot: q.qq.com ओपन प्लेटफ़ॉर्म पर bot बनाएँ, एक ही कमांड से एकीकृत करें
- Tencent Yuanbao चैनल: WebSocket मोड को कैसे कॉन्फ़िगर करें
- Tencent-पारिवारिक चैनलों और Feishu/WeCom के बीच कॉन्फ़िगरेशन का अंतर
कंपनी अभी भी WeChat/QQ से संवाद कर रही है? अगले पाठ में इन्हें भी जोड़ दें — चैनल एक-दूसरे में हस्तक्षेप नहीं करते, एक Gateway सब कुछ साथ ले जाता है।