Zalo ClawBot

OpenClaw कैटलॉग में सूचीबद्ध बाहरी @zalo-platforms/openclaw-zaloclawbot plugin के माध्यम से Zalo ClawBot से जुड़ता है। लॉगिन के लिए Zalo Mini App QR कोड का उपयोग होता है; कॉन्फ़िगरेशन में plugin आईडी openclaw-zaloclawbot है।

संगतता

पूर्वापेक्षाएँ

• Node.js >= 22
• OpenClaw इंस्टॉल हो (openclaw CLI उपलब्ध हो)
• लॉगिन QR कोड स्कैन करने के लिए मोबाइल डिवाइस पर एक Zalo खाता

ऑनबोर्ड के साथ इंस्टॉल करें (अनुशंसित)

openclaw onboard

चैनल मेन्यू से Zalo ClawBot चुनें। विज़ार्ड आधिकारिक कैटलॉग से plugin इंस्टॉल करता है (अखंडता सत्यापित करके), टर्मिनल में लॉगिन QR प्रदर्शित करता है और Zalo ऐप से उसे स्कैन करने के बाद चैनल का सेटअप पूरा करता है।

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

पहले से ऑनबोर्ड किए गए Gateway में चैनल जोड़ने के लिए:

1. Plugin इंस्टॉल करें

openclaw plugins install "@zalo-platforms/openclaw-zaloclawbot@0.1.4"

सटीक पिन किया गया संस्करण उपयोग करें, ताकि इंस्टॉल करते समय OpenClaw कैटलॉग के अखंडता हैश के विरुद्ध पैकेज को सत्यापित कर सके।

2. कॉन्फ़िगरेशन में plugin सक्षम करें

openclaw config set plugins.entries.openclaw-zaloclawbot.enabled true

3. QR कोड बनाएँ और लॉगिन करें

openclaw channels login --channel openclaw-zaloclawbot

टर्मिनल में प्रदर्शित QR कोड को Zalo मोबाइल ऐप से स्कैन करें, Zalo Mini App के भीतर उपयोग की शर्तें स्वीकार करें और सत्र को अधिकृत करें।

4. Gateway पुनः आरंभ करें

openclaw gateway restart

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

मानक Zalo चैनल में अपना Zalo Official Account (OA) पंजीकृत करना और स्थिर डेवलपर क्रेडेंशियल कॉन्फ़िगर करना आवश्यक होता है, लेकिन इसके विपरीत Zalo ClawBot साझा आधिकारिक अवसंरचना पर एक स्वामी से संबद्ध निजी सहायक है:

1. ऑनबोर्डिंग: QR कोड एक Zalo Mini App पर ले जाता है, जो साझा आधिकारिक OA के अंतर्गत नए प्रावधान किए गए निजी बॉट को सीधे आपकी Zalo उपयोगकर्ता आईडी से संबद्ध करता है।
2. स्वामी-संबद्ध गोपनीयता: बॉट केवल अपने स्वामी से संवाद करता है। अन्य उपयोगकर्ताओं के संदेश प्लेटफ़ॉर्म स्तर पर हटा दिए जाते हैं।
3. आधिकारिक API मार्ग: plugin ब्राउज़र या वेब-सत्र स्वचालन के बजाय Zalo Bot Platform API का उपयोग करता है।

आंतरिक कार्यप्रणाली

Plugin एक स्थायी लॉन्ग-पोलिंग लूप (getUpdates) के माध्यम से Zalo से संवाद करता है। स्थानीय डेस्कटॉप/टर्मिनल Gateway संचालन के लिए Webhook डिफ़ॉल्ट रूप से अक्षम होते हैं। संदेशों को क्लाइंट की ओर संसाधित करके आपके स्थानीय एजेंट रनटाइम से मैप किया जाता है।

Plugin, OpenClaw स्टेट डायरेक्टरी में बॉट क्रेडेंशियल प्रबंधित करता है। उस डायरेक्टरी को संवेदनशील मानें और उस पर वही अभिगम-नियंत्रण तथा बैकअप नीति लागू करें जो शेष OpenClaw स्टेट पर लागू होती है।

इस plugin का रनटाइम पूरी तरह बाहरी @zalo-platforms/openclaw-zaloclawbot पैकेज में स्थित है; इंस्टॉल/कॉन्फ़िगरेशन से आगे दिए गए व्यवहार संबंधी विवरण plugin के अनुरक्षकों द्वारा बताए गए हैं और OpenClaw के मूल स्रोत से सत्यापित नहीं किए गए हैं।

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

• QR लॉगिन टाइमआउट: सुरक्षा के लिए लॉगिन टोकन (zbsk) 5 मिनट बाद समाप्त हो जाता है। यदि स्कैन करने से पहले QR कोड की समय-सीमा समाप्त हो जाए, तो नया कोड बनाने के लिए लॉगिन कमांड फिर से चलाएँ।
• Gateway लोड होने में विफल: पुष्टि करें कि आपके OpenClaw होस्ट का संस्करण 2026.4.10 या उससे नया है। पुराने संस्करण इस आईडी के लिए आवश्यक बाहरी npm-plugin इंस्टॉलेशन लेजर का समर्थन नहीं करते हैं।

संबंधित

• चैनलों का अवलोकन - सभी समर्थित चैनल
• Zalo - बंडल किया गया Zalo Bot Creator / Marketplace चैनल
• पेयरिंग - DM प्रमाणीकरण और पेयरिंग प्रवाह
• Plugins - plugin इंस्टॉल और प्रबंधित करना