OpenClaw थ्रेड मोड से Telegram की ताक़त अनलॉक करें

OpenClaw एक ओपन सोर्स AI एजेंट फ़्रेमवर्क है जो Slack, Discord, WhatsApp और Telegram जैसे मैसेजिंग प्लेटफ़ॉर्म पर काम ऑटोमेट कर सकता है। OpenClaw के तेज़ी से लोकप्रिय होने की एक मुख्य वजह यह है कि यह बड़े भाषा मॉडल को बदल देता है एजेंट — ऐसे सॉफ़्टवेयर प्रोग्राम जो घंटों या दिनों तक चल सकते हैं, क्रियाओं के जटिल क्रम पूरे कर सकते हैं और कई चैनलों पर कॉन्टेक्स्ट बनाए रख सकते हैं। Telegram, अपने समृद्ध Bot API और थ्रेडेड चर्चाओं के सपोर्ट के साथ, इसके लिए स्वाभाविक रूप से उपयुक्त है। लेकिन Telegram पर OpenClaw सेट करना और थ्रेड मोड का फ़ायदा उठाना कई नए उपयोगकर्ताओं के लिए स्पष्ट नहीं है। यह लेख आपके असिस्टेंट को Telegram से जोड़ने का स्टेप बाय स्टेप ट्यूटोरियल देता है, समझाता है कि थ्रेड मोड पर्दे के पीछे कैसे काम करता है, असली दुनिया में उपयोग के मामले बताता है और सुझावों तथा समस्या-निवारण सलाह के साथ समाप्त होता है। इस गाइड की सारी जानकारी आधिकारिक OpenClaw दस्तावेज़ और समुदाय के अनुभव से आती है।

Telegram क्यों?

Telegram लोकप्रिय है क्योंकि यह बॉट, ग्रुप चैट, निजी चैनल और फ़ोरम-शैली थ्रेड्स का सपोर्ट करता है। प्लेटफ़ॉर्म बड़ी संदेश-लंबाई सीमा (4096 अक्षर), मीडिया अपलोड, रिएक्शन इमोजी और इनलाइन कीबोर्ड देता है। कुछ मैसेजिंग प्लेटफ़ॉर्म के विपरीत, Telegram का Bot API मुफ़्त, स्थिर और अच्छी तरह प्रलेखित है। OpenClaw की गेटवे परत में Telegram के लिए प्रथम-श्रेणी का सपोर्ट है; यह इंटीग्रेशन प्रोडक्शन-रेडी बॉट DM और ग्रुप के लिए है और लॉन्ग पोलिंग या वेबहुक दोनों में से किसी के ज़रिए काम करता है। दूसरे शब्दों में, एक बार ठीक से कॉन्फ़िगर हो जाने पर आपका असिस्टेंट बिना कोई कस्टम कोड लिखे भरोसेमंद तरीक़े से संदेश भेजेगा और प्राप्त करेगा।

Telegram के साथ OpenClaw सेट करना

1. अपना बॉट बनाएँ और API टोकन प्राप्त करें

Telegram खोलें और आधिकारिक @BotFather बॉट से चैट शुरू करें। चलाएँ /newbot, एक नाम और यूज़रनेम चुनें, और जो टोकन मिले उसे कॉपी करें। आप इस टोकन को OpenClaw के कॉन्फ़िगरेशन में पेस्ट करेंगे। Telegram बॉट पूरी तरह BotFather से प्रबंधित होते हैं; आप बाद में ग्रुप व्यवहार बदलने के लिए /setprivacy और /setjoingroups का भी उपयोग कर सकते हैं।

2. OpenClaw कॉन्फ़िगर करें

अपनी openclaw.json कॉन्फ़िगरेशन फ़ाइल खोलें (आमतौर पर यह ~/.openclawमें होती है) और एक telegram सेक्शन channels key के अंतर्गत जोड़ें:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123:abc",
      "dmPolicy": "pairing",
      "groups": { "*": { "requireMention": true } }
    }
  }
}

यह botToken फ़ील्ड में वह टोकन होता है जो आपको BotFather से मिला था। dmPolicy नियंत्रित करता है कि आपका असिस्टेंट सीधे संदेशों का जवाब कैसे देगा: pairing (डिफ़ॉल्ट) का अर्थ है कि बॉट केवल उन उपयोगकर्ताओं के DM का जवाब देगा जिन्हें आप स्वीकृत करते हैं; खुला सभी को अनुमति देता है; allowlist पहुँच को उपयोगकर्ता ID की एक विशिष्ट सूची तक सीमित करता है; और disabled DM सपोर्ट बंद कर देता है। यह requireMention फ़्लैग ग्रुप्स के लिए ज़रूरी है: जब इसे true, पर सेट किया जाए तो बॉट सिर्फ़ तभी जवाब देता है जब उसका username मेंशन हो, जिससे वह व्यस्त ग्रुप चैट के हर मैसेज का जवाब देने से बच जाता है।

3. गेटवे शुरू करें और अपना अकाउंट पेयर करें

कॉन्फ़िगरेशन सहेजने के बाद चलाएँ openclaw gateway ताकि मैसेजिंग गेटवे शुरू हो जाए। इसके बाद आपको पेयरिंग कोड बनाकर उसे अप्रूव करके अपना Telegram अकाउंट अप्रूव करना होगा। अलग टर्मिनल में चलाएँ openclaw pairing list telegram ताकि पेंडिंग रिक्वेस्ट दिख जाएँ, फिर अपनी user ID को इससे अप्रूव करें: openclaw pairing approve telegram <CODE>। कोड एक घंटे बाद एक्सपायर हो जाते हैं, इसलिए यह स्टेप तुरंत पूरा करें। पेयर होने के बाद आपके Telegram अकाउंट के मैसेज आपके OpenClaw एजेंट तक रूट होंगे।

4. बॉट को ग्रुप्स और टॉपिक्स में जोड़ें

अपने असिस्टेंट को ग्रुप चैट या फ़ोरम टॉपिक्स में हिस्सा लेने देना है तो उसे मनचाहे Telegram ग्रुप्स में जोड़ें, फिर इसे अपडेट करें channels.telegram.groups कॉन्फ़िगरेशन। उदाहरण के लिए:

"channels": {
  "telegram": {
    "groups": {
      "-100123456789": { "requireMention": true },
      "*": { "requireMention": false }
    },
    "groupPolicy": "allowlist"
  }
}

यहाँ * एंट्री किसी भी ग्रुप के लिए कैच-ऑल का काम करती है; requireMention: true यह सुनिश्चित करता है कि असिस्टेंट चैनल पर स्पैम न करे। आप इसके अलावा groupPolicy को खुला को सेट करके बॉट को किसी भी ऐसे ग्रुप में अपने आप जुड़ने दे सकते हैं जो उसे इनवाइट करे, या disabled से ग्रुप के इस्तेमाल को पूरी तरह बंद कर सकते हैं। ग्रुप्स कॉन्फ़िगर करने के बाद गेटवे रीस्टार्ट करें और अगर आपने प्राइवेसी सेटिंग बदली है तो बॉट को हर ग्रुप में दोबारा जोड़ें।

थ्रेड मोड को समझें

Telegram ने फ़ोरम टॉपिक्स 2022 में पेश किए, जिससे बड़े ग्रुप बातचीत को अलग-अलग थ्रेड्स में बाँट सकें। OpenClaw इस फ़ीचर का फ़ायदा उठाते हुए :topic:<threadId> को अपनी आंतरिक session keys में जोड़ता है। इसका मतलब है कि हर टॉपिक का अपना बातचीत कॉन्टेक्स्ट होता है; एक थ्रेड में भेजे गए मैसेज दूसरे में नहीं जाते। इस डिज़ाइन से दो ज़रूरी व्यवहार सामने आते हैं:

1. टॉपिक आइसोलेशन: जब असिस्टेंट को कोई ऐसा मैसेज मिलता है जिसमें message_thread_id, तो वह इस तरह की session key इस्तेमाल करता है: telegram:<chatId>:topic:<threadId>। जवाब उसी थ्रेड में भेजे जाते हैं। इसी तरह एजेंट लंबी मल्टी-ब्रांच बातचीत में कॉन्टेक्स्ट बनाए रखता है।
2. सामान्य बनाम विशिष्ट टॉपिक: Telegram थ्रेड ID 1 को डिफ़ॉल्ट “general” टॉपिक मानता है। थ्रेड 1 पर मैसेज भेजते समय आपको message_thread_id को API कॉल में छोड़ देना चाहिए; वरना Telegram उसे रिजेक्ट कर देता है। जवाब भेजते समय OpenClaw इसे अपने आप संभाल लेता है।

थ्रेड मोड सिर्फ़ फ़ोरम सुपरग्रुप्स तक सीमित नहीं है। प्राइवेट चैट (DM) में Telegram कभी-कभी message_thread_id को पुराने मैसेज के जवाबों के साथ जोड़ देता है। OpenClaw इस ID को सुरक्षित रखता है और थ्रेड-अवेयर session keys इस्तेमाल करता है, इसलिए DM में भी आपकी बातचीत का इतिहास व्यवस्थित रहता है।

रिप्लाई मोड कॉन्फ़िगरेशन

डिफ़ॉल्ट रूप से OpenClaw सेट करता है channels.telegram.replyToMode को बंद, जो इम्प्लिसिट रिप्लाई थ्रेडिंग बंद कर देता है। अगर आप चाहते हैं कि असिस्टेंट सीधे ट्रिगर करने वाले मैसेज का जवाब दे, तो सेट करें replyToMode को पहले या आपकी सभी. आप इस तरह के स्पष्ट टैग भी जोड़ सकते हैं, जैसे [[reply_to_current]] या [[reply_to:<messageId>]] अपने एजेंट के रिस्पॉन्स में। ये टैग गेटवे को निर्देश देते हैं कि जवाब उसी थ्रेड में भेजा जाए।

स्ट्रीमिंग और टाइपिंग इंडिकेटर

OpenClaw, Telegram पर आंशिक जवाबों की स्ट्रीमिंग सपोर्ट करता है। जब channels.telegram.streaming को सेट किया जाए partial या progress, तो गेटवे एक अस्थायी मैसेज भेजता है और मॉडल के टेक्स्ट बनाने के साथ उसे एडिट करता जाता है। लंबे जवाबों में इससे बेहतर यूज़र अनुभव मिलता है। आप रीयल-टाइम रीज़निंग आउटपुट भी चालू कर सकते हैं, इसके ज़रिए /reasoning stream कमांड बातचीत के दौरान। टाइपिंग इंडिकेटर अपने आप भेजे जाते हैं, थ्रेड्स में भी; हालाँकि, थ्रेड ID 1 (जनरल टॉपिक) के लिए Telegram टाइपिंग एक्शन में message_thread_id इसे अनदेखा करता है।

रिएक्शन, स्टिकर और इनलाइन कमांड

Telegram का Bot API मैसेज रिएक्शन, स्टिकर और इनलाइन बटन सपोर्ट करता है। OpenClaw इन सुविधाओं को अपने action सिस्टम के ज़रिए उपलब्ध कराता है:

• रिएक्शन: यह react एक्शन एजेंट को इमोजी के साथ किसी मैसेज पर रिएक्ट करने देता है। रिएक्शन नोटिफ़िकेशन इनके ज़रिए कॉन्फ़िगर किए जा सकते हैं channels.telegram.reactionNotifications और reactionLevel, जो बॉट मैसेज, सभी मैसेज या किसी के लिए भी नोटिफ़िकेशन चालू करता है। ध्यान दें कि Telegram रिएक्शन के लिए थ्रेड ID नहीं देता, इसलिए वे हमेशा मुख्य थ्रेड में ही जाते हैं।
• स्टिकर: स्टिकर एक्शन चालू करने के लिए यह सेट करें channels.telegram.actions.sticker: true. स्टिकर लोकल कैश होते हैं; आप कैश में इसके ज़रिए खोज सकते हैं sticker-search एक्शन से, और स्टिकर भेजें sticker.
• इनलाइन बटन: कॉन्फ़िगर करें channels.telegram.capabilities.inlineButtons से तय करें कि इनलाइन कीबोर्ड कब अनुमत हैं (off, dm, group, all या allowlist)। इसके बाद आप बटन वाला मैसेज भेज सकते हैं, जिसमें शामिल करें buttons एक्शन बॉडी में एक ऐरे।

थ्रेड मोड के उपयोग के मामले

थ्रेड मोड ऐसे शक्तिशाली वर्कफ़्लो खोलता है जो एक ही चैट में भ्रमित करने वाले या असंभव होते। यहाँ कुछ व्यावहारिक परिदृश्य हैं:

1. मल्टी-प्रोजेक्ट समन्वय

सोचिए, आप एक साथ कई प्रोजेक्ट संभाल रहे हैं। एक ही Telegram सुपरग्रुप बनाएँ और फ़ोरम टॉपिक चालू करें। हर प्रोजेक्ट के लिए एक अलग टॉपिक बनाएँ (जैसे, वेबसाइट रीडिज़ाइन, मार्केटिंग कैंपेन, बग फ़िक्स)। जब आप किसी टॉपिक के अंदर अपने असिस्टेंट को संदेश भेजते हैं, तो OpenClaw उस थ्रेड के लिए अपने आप एक यूनिक सेशन की इस्तेमाल करता है। इससे बातचीत का कॉन्टेक्स्ट अलग रहता है, इसलिए जब आप “डेडलाइन” के बारे में पूछते हैं, तो असिस्टेंट जानता है कि आप किस प्रोजेक्ट की बात कर रहे हैं।

2. ग्रुप चैट में निजी साइड-थ्रेड

व्यस्त फ़ैमिली या टीम चैट में, आप मुख्य चर्चा को बीच में रोके बिना अपने असिस्टेंट से सवाल पूछना चाह सकते हैं। अपने पिछले संदेश का जवाब दें या किसी जवाब में बॉट का ज़िक्र करें; Telegram एक message_thread_id, जिससे OpenClaw बातचीत को उस संदेश से जुड़े थ्रेड में भेज देता है। अब आप मुख्य चैट को भरे बिना “मेरी टू-डू लिस्ट क्या है?” या “आज के संदेशों का सारांश दें” जैसे फ़ॉलो-अप सवाल पूछ सकते हैं।

3. लंबे समय तक चलने वाले काम

कुछ काम समय लेते हैं: लंबे दस्तावेज़ का सारांश बनाना, रिपोर्ट तैयार करना या स्क्रिप्ट चलाना। इन कामों को थ्रेड में शुरू करने से प्रगति के अपडेट व्यवस्थित रहते हैं। सेट करें channels.telegram.streaming को progress ताकि असिस्टेंट एक प्रीव्यू संदेश भेजे और अंतिम नतीजा तैयार होने तक उसे एडिट करता रहे। अगर आपके पास कई लंबे काम हैं, तो हर थ्रेड अलग रहता है, जिससे आपस में मिलावट नहीं होती।

4. ब्रेनस्टॉर्मिंग सेशन

फ़ोरम टॉपिक ब्रेनस्टॉर्मिंग रूम की तरह काम कर सकते हैं। उदाहरण के लिए, एक टॉपिक खोलें जिसका नाम हो ब्लॉग आइडिया और अपने एजेंट के साथ लेख के आइडिया पर ब्रेनस्टॉर्म करें। असिस्टेंट थ्रेड के अंदर पिछले सुझावों का कॉन्टेक्स्ट बनाए रखेगा, जिससे आइडिया को बेहतर बनाना और बढ़ाना आसान होता है। इस बीच, आपकी सामान्य चैट साफ़ बनी रहती है।

5. कस्टमर सपोर्ट या FAQ

अगर आप एक कम्युनिटी चैट चलाते हैं, तो अलग-अलग सपोर्ट सवालों के लिए टॉपिक बना सकते हैं। यूज़र अपने-अपने थ्रेड में सवाल पूछते हैं, और आपका OpenClaw एजेंट ढाल-तराश कर जानकारी देता है। चूँकि सेशन की हर थ्रेड के लिए अलग होती हैं, एजेंट जवाबों में गड़बड़ नहीं करेगा। आप काम भी सौंप सकते हैं: एजेंट GitHub में इश्यू फ़ाइल कर सकता है या फ़ॉलो-अप के तौर पर कैलेंडर इवेंट बना सकता है।

समस्या-समाधान और टिप्स

प्राइवेसी मोड: Telegram बॉट डिफ़ॉल्ट रूप से प्राइवेसी मोड में रहते हैं, यानी उन्हें सिर्फ़ वे संदेश दिखते हैं जो शुरू होते हैं / कमांड से या जिनमें उनका ज़िक्र हो। अगर आपको ग्रुप में सभी संदेश दिखने चाहिए, तो इसके ज़रिए प्राइवेसी बंद करें /setprivacy या बॉट को एडमिन बना दें। याद रखें, बदलाव लागू होने के लिए बॉट को हटाकर दोबारा जोड़ें।

हिस्ट्री की सीमाएँ: OpenClaw हर चैट या थ्रेड के लिए सीमित हिस्ट्री रखता है (ग्रुप के लिए डिफ़ॉल्ट 50 संदेश, और इसे कॉन्फ़िगर किया जाता है channels.telegram.historyLimit)। अगर आपके एजेंट को ज़्यादा कॉन्टेक्स्ट चाहिए तो यह सीमा बढ़ाएँ, लेकिन मेमोरी के इस्तेमाल का ध्यान रखें।

Webhook बनाम लॉन्ग पोलिंग: डिफ़ॉल्ट रूप से OpenClaw लॉन्ग पोलिंग इस्तेमाल करता है, जिसे सेट करना ज़्यादा आसान है। अगर आप webhooks इस्तेमाल करना चाहते हैं (जैसे लेटेंसी कम करने के लिए), तो सेट करें channels.telegram.webhookUrl और webhookSecret। पोर्ट और होस्ट के विकल्पों के लिए डॉक्युमेंटेशन देखें।

स्पष्ट रिप्लाई टैग: उपयोग [[reply_to_current]] या [[reply_to:<id>]] अपने एजेंट के जवाबों में इस्तेमाल करें जब आपको रिप्लाई के लक्ष्य पर बारीक नियंत्रण चाहिए। यह उन बॉट के लिए ख़ास तौर पर मददगार है जो एक साथ कई थ्रेड पर नज़र रखते हैं।

एक्सेस मैनेज करना: उपयोग channels.telegram.allowFrom और groupPolicy ताकि तय हो सके कि आपके बॉट से कौन बात कर सकता है और वह किन ग्रुप में शामिल हो सकता है। इससे स्पैम और अनधिकृत कमांड रुकते हैं।

निष्कर्ष

Telegram, OpenClaw एजेंट चलाने के लिए सबसे बहुमुखी प्लेटफ़ॉर्म में से एक है। थ्रेड मोड कैसे काम करता है, यह समझकर और ग्रुप तथा DM को ठीक से कॉन्फ़िगर करके आप समृद्ध, मल्टी-कॉन्टेक्स्ट बातचीत बना सकते हैं जो व्यवस्थित बनी रहती है। थ्रेड का उपयोग प्रोजेक्ट अलग करने, लंबे समय तक चलने वाले कार्य चलाने, ब्रेनस्टॉर्मिंग को आसान बनाने या कस्टमर सपोर्ट देने के लिए करें। आकर्षक अनुभव बनाने के लिए स्ट्रीमिंग प्रीव्यू, इनलाइन बटन और रिएक्शन नोटिफ़िकेशन जैसी सुविधाओं का लाभ उठाएँ। सही कॉन्फ़िगरेशन के साथ, आपका OpenClaw असिस्टेंट आपके Telegram कम्युनिटी में एक स्वाभाविक प्रतिभागी जैसा महसूस होगा।