WeChat

OpenClaw, Tencent के बाहरी @tencent-weixin/openclaw-weixin चैनल Plugin के माध्यम से WeChat से जुड़ता है।

स्थिति: बाहरी Plugin, जिसका रखरखाव Tencent Weixin टीम करती है। सीधे चैट और मीडिया समर्थित हैं। समूह चैट का प्रचार Plugin क्षमता मेटाडेटा में नहीं किया गया है (यह केवल सीधे चैट घोषित करता है)।

नामकरण

• WeChat इन दस्तावेज़ों में उपयोगकर्ता को दिखाई देने वाला नाम है।
• Weixin Tencent के पैकेज और Plugin आईडी द्वारा उपयोग किया जाने वाला नाम है।
• openclaw-weixin OpenClaw चैनल आईडी है (weixin और wechat उपनाम के रूप में काम करते हैं)।
• @tencent-weixin/openclaw-weixin npm पैकेज है।

CLI कमांड और कॉन्फ़िगरेशन पथों में openclaw-weixin का उपयोग करें।

यह कैसे काम करता है

WeChat का कोड OpenClaw की कोर रिपॉज़िटरी में नहीं रहता। OpenClaw सामान्य चैनल Plugin अनुबंध प्रदान करता है और बाहरी Plugin WeChat-विशिष्ट रनटाइम प्रदान करता है:

1. openclaw plugins install, @tencent-weixin/openclaw-weixin को इंस्टॉल करता है।
2. Gateway, Plugin मैनिफ़ेस्ट खोजता है और Plugin एंट्रीपॉइंट लोड करता है।
3. Plugin, चैनल आईडी openclaw-weixin पंजीकृत करता है।
4. openclaw channels login --channel openclaw-weixin QR लॉगिन शुरू करता है।
5. Plugin, खाता क्रेडेंशियल OpenClaw स्थिति डायरेक्टरी में संग्रहीत करता है (डिफ़ॉल्ट रूप से ~/.openclaw)।
6. Gateway शुरू होने पर, Plugin प्रत्येक कॉन्फ़िगर किए गए खाते के लिए अपना Weixin मॉनिटर शुरू करता है।
7. आने वाले WeChat संदेशों को चैनल अनुबंध के माध्यम से सामान्यीकृत किया जाता है, चयनित OpenClaw एजेंट को भेजा जाता है और Plugin के आउटबाउंड पथ के माध्यम से वापस भेजा जाता है।

यह पृथक्करण महत्वपूर्ण है: OpenClaw कोर चैनल-अज्ञेय रहता है। WeChat लॉगिन, Tencent iLink API कॉल, मीडिया अपलोड/डाउनलोड, संदर्भ टोकन और खाता निगरानी का स्वामित्व बाहरी Plugin के पास है।

इंस्टॉल करना

त्वरित इंस्टॉल:

npx -y @tencent-weixin/openclaw-weixin-cli install

मैन्युअल इंस्टॉल:

openclaw plugins install "@tencent-weixin/openclaw-weixin"openclaw config set plugins.entries.openclaw-weixin.enabled true

इंस्टॉल करने के बाद Gateway पुनः आरंभ करें:

openclaw gateway restart

लॉगिन

QR लॉगिन उसी मशीन पर चलाएँ जिस पर Gateway चलता है:

openclaw channels login --channel openclaw-weixin

अपने फ़ोन पर WeChat से QR कोड स्कैन करें और लॉगिन की पुष्टि करें। सफल स्कैन के बाद Plugin खाता टोकन को स्थानीय रूप से सहेजता है।

दूसरा WeChat खाता जोड़ने के लिए वही लॉगिन कमांड फिर से चलाएँ। एकाधिक खातों के लिए सीधे-संदेश सत्रों को खाते, चैनल और प्रेषक के अनुसार अलग रखें:

openclaw config set session.dmScope per-account-channel-peer

अभिगम नियंत्रण

सीधे संदेश चैनल Plugins के लिए सामान्य OpenClaw पेयरिंग और अनुमति-सूची मॉडल का उपयोग करते हैं।

नए प्रेषकों को स्वीकृति दें:

openclaw pairing list openclaw-weixinopenclaw pairing approve openclaw-weixin <CODE>

संपूर्ण अभिगम-नियंत्रण मॉडल के लिए पेयरिंग देखें।

संगतता

Plugin स्टार्टअप के समय होस्ट OpenClaw संस्करण की जाँच करता है।

यदि Plugin रिपोर्ट करता है कि आपका OpenClaw संस्करण बहुत पुराना है, तो या तो OpenClaw अपडेट करें या पुरानी Plugin शृंखला इंस्टॉल करें:

openclaw plugins install @tencent-weixin/openclaw-weixin@legacy

साइडकार प्रक्रिया

Tencent iLink API की निगरानी करते समय WeChat Plugin, Gateway के साथ-साथ सहायक कार्य चला सकता है। समस्या #68451 में उस सहायक पथ ने OpenClaw की सामान्य पुराने-Gateway सफ़ाई में एक बग उजागर किया: कोई चाइल्ड प्रक्रिया पैरेंट Gateway प्रक्रिया को साफ़ करने का प्रयास कर सकती थी, जिससे systemd जैसे प्रक्रिया प्रबंधकों के अंतर्गत पुनः आरंभ चक्र उत्पन्न होते थे।

वर्तमान OpenClaw स्टार्टअप सफ़ाई में मौजूदा प्रक्रिया और उसके पूर्वज शामिल नहीं होते, इसलिए कोई चैनल सहायक उसे शुरू करने वाले Gateway को समाप्त नहीं कर सकता। यह सुधार सामान्य है; यह कोर में WeChat-विशिष्ट पथ नहीं है।

समस्या निवारण

इंस्टॉल और स्थिति जाँचें:

openclaw plugins listopenclaw channels status --probeopenclaw --version

यदि चैनल इंस्टॉल दिखता है, लेकिन कनेक्ट नहीं होता, तो पुष्टि करें कि Plugin सक्षम है और पुनः आरंभ करें:

openclaw config set plugins.entries.openclaw-weixin.enabled trueopenclaw gateway restart

यदि WeChat सक्षम करने के बाद Gateway बार-बार पुनः आरंभ होता है, तो OpenClaw और Plugin दोनों अपडेट करें:

npm view @tencent-weixin/openclaw-weixin versionopenclaw plugins install "@tencent-weixin/openclaw-weixin" --forceopenclaw gateway restart

यदि स्टार्टअप रिपोर्ट करता है कि इंस्टॉल किया गया Plugin पैकेज requires compiled runtime output for TypeScript entry, तो npm पैकेज उन संकलित JavaScript रनटाइम फ़ाइलों के बिना प्रकाशित हुआ था जिनकी OpenClaw को आवश्यकता है। Plugin प्रकाशक द्वारा सुधारा गया पैकेज जारी करने के बाद अपडेट/पुनः इंस्टॉल करें, या Plugin को अस्थायी रूप से अक्षम/अनइंस्टॉल करें।

अस्थायी रूप से अक्षम करना:

openclaw config set plugins.entries.openclaw-weixin.enabled falseopenclaw gateway restart

संबंधित दस्तावेज़

• चैनल अवलोकन: चैट चैनल
• पेयरिंग: पेयरिंग
• चैनल रूटिंग: चैनल रूटिंग
• Plugin आर्किटेक्चर: Plugin आर्किटेक्चर
• चैनल Plugin SDK: चैनल Plugin SDK
• बाहरी पैकेज: @tencent-weixin/openclaw-weixin