Zalo ClawBot

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

संगतता

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

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

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

OpenClaw ऑनबोर्डिंग विज़ार्ड चलाएँ और चैनल मेनू से Zalo ClawBot चुनें:

openclaw onboard

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

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

पहले से ऑनबोर्ड किए गए gateway में चैनल जोड़ने के लिए, इन चरणों का पालन करें:

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

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

ऊपर दिखाए गए ठीक pinned version का उपयोग करें (यह आधिकारिक catalog entry से मेल खाता है), ताकि OpenClaw इंस्टॉल के दौरान package को catalog integrity hash के विरुद्ध सत्यापित करे।

2. config में plugin सक्षम करें

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

3. QR कोड जनरेट करें और लॉग इन करें

openclaw channels login --channel openclaw-zaloclawbot

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

4. gateway रीस्टार्ट करें

openclaw gateway restart

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

मानक developer Zalo channel के विपरीत, जिसमें आपको अपना Zalo Official Account (OA) रजिस्टर करना और static developer credentials पेस्ट करना पड़ता है, Zalo ClawBot साझा, आधिकारिक infrastructure का उपयोग करते हुए owner-bound personal assistant के रूप में काम करता है:

1. सुरक्षित ऑनबोर्डिंग: QR कोड एक सुरक्षित Zalo Mini App पर resolve होता है, जो साझा आधिकारिक OA के अंतर्गत नए provisioned, private bot को सीधे आपके Zalo User ID से bind करता है।
2. Owner-Bound गोपनीयता: डिज़ाइन के अनुसार, bot को केवल अपने owner के साथ संचार करने तक सीमित रखा गया है। अन्य users के messages platform स्तर पर drop कर दिए जाते हैं, जिससे connection निजी और सुरक्षित रहता है।
3. आधिकारिक API path: plugin browser या web-session automation के बजाय Zalo Bot Platform APIs का उपयोग करता है।

आंतरिक विवरण

Zalo ClawBot plugin persistent long-polling message loop के माध्यम से Zalo APIs से संचार करता है। runtime को साफ और lightweight बनाए रखने के लिए:

• Long-poll connections getUpdates endpoint का उपयोग करते हैं।
• स्थानीय desktop/terminal gateway runs के लिए Webhook डिफ़ॉल्ट रूप से disabled होते हैं।
• Messages client-side processed होते हैं और सीधे आपके local agent runtime से map किए जाते हैं।

बाहरी plugin OpenClaw state directory के अंतर्गत bot credentials manage करता है। उस directory को संवेदनशील मानें और इसे अपने बाकी OpenClaw state जैसी ही access-control और backup policy में शामिल करें।

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

• QR लॉगिन टाइमआउट: login token (zbsk) security कारणों से 5 मिनट बाद expire हो जाता है। यदि QR कोड आपके scan करने से पहले expire हो जाता है, तो नया जनरेट करने के लिए login command फिर से चलाएँ।
• Gateway लोड होने में विफल: सुनिश्चित करें कि आपका OpenClaw host version 2026.4.10 या उच्चतर है। पुराने versions external npm-plugin installation ledger का समर्थन नहीं करते।