Telegram

Telegram बॉट में डिफ़ॉल्ट रूप से Privacy Mode होता है, जो उन्हें मिलने वाले समूह संदेशों को सीमित करता है।

सभी समूह संदेश देखने के लिए, इनमें से कोई एक कार्य करें:

• /setprivacy के माध्यम से गोपनीयता मोड अक्षम करें, या
• बॉट को समूह एडमिन बनाएँ।

गोपनीयता मोड बदलने के बाद, प्रत्येक समूह से बॉट हटाकर फिर से जोड़ें, ताकि Telegram परिवर्तन लागू करे।

एडमिन स्थिति Telegram समूह सेटिंग्स में नियंत्रित होती है। एडमिन बॉट सभी समूह संदेश प्राप्त करते हैं, जो हमेशा सक्रिय रहने वाले समूह व्यवहार के लिए उपयोगी है।

• /setjoingroups — समूह में जोड़े जाने की अनुमति दें/अस्वीकार करें
• /setprivacy — समूह दृश्यता व्यवहार

यदि आप चैट कमांड के बजाय UI पसंद करते हैं, तो यही सेटिंग्स BotFather के वेब ऐप में उपलब्ध हैं।

OpenClaw सीधे चैट, समूहों और विषयों में आंशिक उत्तरों को रीयल टाइम में स्ट्रीम करता है: एक पूर्वावलोकन संदेश भेजता है, फिर बार-बार editMessageText करता है और अंत में उसी स्थान पर उसे अंतिम रूप देता है।

• channels.telegram.streaming का मान off | partial | block | progress है (डिफ़ॉल्ट: partial)
• छोटे आरंभिक उत्तर पूर्वावलोकनों पर डिबाउंस लागू होता है, फिर यदि रन अब भी सक्रिय हो तो सीमित विलंब के बाद उन्हें वास्तविक रूप दिया जाता है
• progress टूल की प्रगति के लिए एक संपादन-योग्य स्थिति ड्राफ़्ट बनाए रखता है, टूल प्रगति से पहले उत्तर गतिविधि आने पर स्थिर स्थिति लेबल दिखाता है, पूर्ण होने पर इसे साफ़ करता है और अंतिम उत्तर को सामान्य संदेश के रूप में भेजता है
• streaming.preview.toolProgress नियंत्रित करता है कि टूल/प्रगति अपडेट उसी संपादित पूर्वावलोकन संदेश का दोबारा उपयोग करें या नहीं (डिफ़ॉल्ट: पूर्वावलोकन स्ट्रीमिंग सक्रिय होने पर true)
• streaming.preview.commandText उन पंक्तियों के भीतर कमांड/निष्पादन विवरण नियंत्रित करता है: raw (डिफ़ॉल्ट) या status (केवल टूल लेबल)
• streaming.progress.commentary (डिफ़ॉल्ट: false) अस्थायी प्रगति ड्राफ़्ट में सहायक की टिप्पणी/प्रस्तावना टेक्स्ट को शामिल करने का विकल्प देता है
• पुराने channels.telegram.streamMode, बूलियन streaming मान और हटाई गई मूल ड्राफ़्ट पूर्वावलोकन कुंजियों का पता लगाया जाता है; उन्हें माइग्रेट करने के लिए openclaw doctor --fix चलाएँ

टूल-प्रगति पंक्तियाँ वे छोटे स्थिति अपडेट हैं जो टूल चलते समय दिखाए जाते हैं (कमांड निष्पादन, फ़ाइल पढ़ना, योजना अपडेट, पैच सारांश, ऐप-सर्वर मोड में Codex प्रस्तावना/टिप्पणी)। Telegram इन्हें डिफ़ॉल्ट रूप से चालू रखता है (v2026.4.22+ से जारी व्यवहार के अनुरूप)।

उत्तर-पूर्वावलोकन संपादन बनाए रखें, लेकिन टूल-प्रगति पंक्तियाँ छिपाएँ:

{  "channels": {    "telegram": {      "streaming": {        "mode": "partial",        "preview": { "toolProgress": false }      }    }  }}

टूल-प्रगति दृश्यमान रखें, लेकिन कमांड/निष्पादन टेक्स्ट छिपाएँ:

{  "channels": {    "telegram": {      "streaming": {        "mode": "partial",        "preview": { "commandText": "status" }      }    }  }}

progress मोड अंतिम उत्तर को उस संदेश में संपादित किए बिना टूल की प्रगति दिखाता है। कमांड-टेक्स्ट नीति को streaming.progress के अंतर्गत रखें:

{  "channels": {    "telegram": {      "streaming": {        "mode": "progress",        "progress": {          "toolProgress": true,          "commandText": "status"        }      }    }  }}

streaming.mode: "off" पूर्वावलोकन संपादन अक्षम करता है और सामान्य टूल/प्रगति संदेशों को स्वतंत्र स्थिति संदेशों के रूप में भेजने के बजाय दबा देता है; अनुमोदन संकेत, मीडिया और त्रुटियाँ अब भी सामान्य अंतिम डिलीवरी से भेजे जाते हैं। streaming.preview.toolProgress: false केवल उत्तर-पूर्वावलोकन संपादन बनाए रखता है।

केवल-टेक्स्ट उत्तरों के लिए: छोटे पूर्वावलोकनों में अंतिम संपादन उसी स्थान पर होता है; कई संदेशों में विभाजित होने वाले लंबे अंतिम उत्तर पूर्वावलोकन को पहले खंड के रूप में दोबारा उपयोग करते हैं और फिर केवल शेष भाग भेजते हैं; प्रगति-मोड के अंतिम उत्तर स्थिति ड्राफ़्ट साफ़ करके सामान्य अंतिम डिलीवरी का उपयोग करते हैं; यदि पूर्णता की पुष्टि होने से पहले अंतिम संपादन विफल हो जाए, तो OpenClaw सामान्य अंतिम डिलीवरी का सहारा लेता है और पुराने पूर्वावलोकन को साफ़ करता है। जटिल उत्तरों (मीडिया पेलोड) के लिए OpenClaw हमेशा सामान्य अंतिम डिलीवरी का सहारा लेता है और पूर्वावलोकन को साफ़ करता है।

पूर्वावलोकन स्ट्रीमिंग और ब्लॉक स्ट्रीमिंग परस्पर अनन्य हैं — ब्लॉक स्ट्रीमिंग स्पष्ट रूप से सक्षम होने पर OpenClaw दोहरी स्ट्रीमिंग से बचने के लिए पूर्वावलोकन स्ट्रीम छोड़ देता है।

तर्क-विचार: /reasoning stream जनरेट करते समय तर्क-विचार को लाइव पूर्वावलोकन में स्ट्रीम करता है, फिर अंतिम डिलीवरी के बाद तर्क-विचार पूर्वावलोकन हटा देता है (इसे दृश्यमान रखने के लिए /reasoning on का उपयोग करें)। अंतिम उत्तर तर्क-विचार टेक्स्ट के बिना भेजा जाता है।

आउटबाउंड टेक्स्ट डिफ़ॉल्ट रूप से मानक Telegram HTML संदेशों का उपयोग करता है, जो मौजूदा क्लाइंटों में पठनीय हैं: बोल्ड, इटैलिक, लिंक, कोड, स्पॉइलर, उद्धरण — Bot API 10.2 के केवल-समृद्ध ब्लॉक (मूल तालिकाएँ, विवरण, समृद्ध मीडिया, सूत्र) नहीं।

Bot API 10.2 समृद्ध संदेशों को सक्रिय करें:

{channels: {telegram: {  richMessages: true,},},}

सक्षम होने पर: एजेंट को बताया जाता है कि इस बॉट/अकाउंट के लिए समृद्ध संदेश उपलब्ध हैं (समर्थित Markdown + HTML-आइलैंड लेखन अनुबंध के साथ); Markdown टेक्स्ट OpenClaw के Markdown IR के माध्यम से टाइप किए गए Bot API 10.2 समृद्ध ब्लॉक के रूप में रेंडर होता है (शीर्षक, तालिकाएँ, विवरण, चेकलिस्ट, समृद्ध मीडिया, सूत्र, मानचित्र, कोलाज); मीडिया कैप्शन अब भी Telegram HTML कैप्शन का उपयोग करते हैं (समृद्ध संदेश कैप्शन को प्रतिस्थापित नहीं करते और कैप्शन की सीमा 1024 वर्ण है)।

इससे मॉडल टेक्स्ट Telegram के समृद्ध-Markdown संकेत-चिह्नों से दूर रहता है, इसलिए $400-600K जैसी मुद्रा को गणित के रूप में पार्स नहीं किया जाता। लंबा समृद्ध टेक्स्ट Telegram की सीमाओं के अनुसार स्वतः विभाजित हो जाता है। 20-स्तंभ सीमा से अधिक चौड़ी तालिकाएँ कोड ब्लॉक का सहारा लेती हैं।

डिफ़ॉल्ट: क्लाइंट संगतता के लिए बंद — कुछ मौजूदा Desktop, Web, Android और तृतीय-पक्ष क्लाइंट स्वीकृत समृद्ध संदेशों को असमर्थित रूप में रेंडर करते हैं। इसे तब तक बंद रखें, जब तक बॉट के साथ उपयोग किया जाने वाला प्रत्येक क्लाइंट उन्हें रेंडर न कर सके। /status दिखाता है कि मौजूदा सत्र में समृद्ध संदेश चालू हैं या बंद।

लिंक पूर्वावलोकन डिफ़ॉल्ट रूप से चालू रहते हैं। channels.telegram.linkPreview: false समृद्ध टेक्स्ट के लिए स्वचालित एंटिटी पहचान अक्षम करता है।

Telegram का कमांड मेनू स्टार्टअप पर setMyCommands के साथ पंजीकृत होता है। commands.native: "auto" Telegram के लिए मूल कमांड सक्षम करता है।

कस्टम कमांड मेनू प्रविष्टियाँ जोड़ें:

{channels: {telegram: {  customCommands: [    { command: "backup", description: "Git बैकअप" },    { command: "generate", description: "एक छवि बनाएँ" },  ],},},}

नियम: नाम सामान्यीकृत किए जाते हैं (आरंभिक / हटाया जाता है, लोअरकेस किया जाता है); मान्य पैटर्न a-z, 0-9, _, लंबाई 1-32; कस्टम कमांड मूल कमांड को ओवरराइड नहीं कर सकते; विरोध/डुप्लिकेट छोड़ दिए जाते हैं और लॉग किए जाते हैं।

कस्टम कमांड केवल मेनू प्रविष्टियाँ हैं — वे व्यवहार को स्वतः लागू नहीं करते। Plugin/स्किल कमांड Telegram मेनू में न दिखने पर भी टाइप किए जाने पर काम कर सकते हैं। यदि मूल कमांड अक्षम हैं, तो बिल्ट-इन कमांड हटा दिए जाते हैं; कॉन्फ़िगर होने पर कस्टम/Plugin कमांड अब भी पंजीकृत हो सकते हैं।

सामान्य सेटअप विफलताएँ:

• ट्रिम पुनःप्रयास के बाद BOT_COMMANDS_TOO_MUCH सहित setMyCommands failed का अर्थ है कि मेनू अब भी सीमा से अधिक है; Plugin/स्किल/कस्टम कमांड की संख्या घटाएँ या channels.telegram.commands.native अक्षम करें।
• सीधे Bot API curl कमांड काम करने के बावजूद deleteWebhook, deleteMyCommands या setMyCommands का 404: Not Found के साथ विफल होना आमतौर पर दर्शाता है कि channels.telegram.apiRoot को पूर्ण /bot<TOKEN> एंडपॉइंट पर सेट किया गया था। apiRoot में केवल Bot API रूट होना चाहिए; openclaw doctor --fix गलती से अंत में जुड़े /bot<TOKEN> को हटाता है।
• getMe returned 401 का अर्थ है कि Telegram ने कॉन्फ़िगर किया गया बॉट टोकन अस्वीकार कर दिया। botToken, tokenFile या TELEGRAM_BOT_TOKEN (डिफ़ॉल्ट अकाउंट) को मौजूदा BotFather टोकन से अपडेट करें; OpenClaw पोलिंग से पहले रुक जाता है, इसलिए इसे Webhook क्लीनअप विफलता के रूप में रिपोर्ट नहीं किया जाता।
• नेटवर्क/फ़ेच त्रुटियों के साथ setMyCommands failed का आमतौर पर अर्थ है कि api.telegram.org के लिए आउटबाउंड DNS/HTTPS अवरुद्ध है।

डिवाइस पेयरिंग कमांड (device-pair Plugin)

इंस्टॉल होने पर:

1. /pair एक सेटअप कोड जनरेट करता है
2. कोड को iOS ऐप में पेस्ट करें
3. /pair pending लंबित अनुरोध सूचीबद्ध करता है (भूमिका/स्कोप सहित)
4. स्वीकृत करें: /pair approve <requestId>, /pair approve (केवल लंबित अनुरोध), या /pair approve latest

यदि कोई डिवाइस बदले हुए प्रमाणीकरण विवरण (भूमिका, स्कोप, सार्वजनिक कुंजी) के साथ पुनः प्रयास करता है, तो पिछले लंबित अनुरोध को नए requestId से प्रतिस्थापित कर दिया जाता है; स्वीकृति देने से पहले /pair pending फिर से चलाएँ।

अधिक विवरण: पेयरिंग।

इनलाइन कीबोर्ड स्कोप कॉन्फ़िगर करें:

{channels: {telegram: {  capabilities: {    inlineButtons: "allowlist",  },},},}

प्रति-अकाउंट ओवरराइड:

{channels: {telegram: {  accounts: {    main: {      capabilities: {        inlineButtons: "allowlist",      },    },  },},},}

स्कोप: off, dm, group, all, allowlist (डिफ़ॉल्ट)। पुराना capabilities: ["inlineButtons"], "all" से मैप होता है।

संदेश कार्रवाई का उदाहरण:

{action: "send",channel: "telegram",to: "123456789",message: "एक विकल्प चुनें:",buttons: [[  { text: "हाँ", callback_data: "yes" },  { text: "नहीं", callback_data: "no" },],[{ text: "रद्द करें", callback_data: "cancel" }],],}

Mini App बटन का उदाहरण:

{action: "send",channel: "telegram",to: "123456789",message: "ऐप खोलें:",presentation: {blocks: [  {    type: "buttons",    buttons: [{ label: "लॉन्च करें", web_app: { url: "https://example.com/app" } }],  },],},}

web_app बटन केवल उपयोगकर्ता और बॉट के बीच निजी चैट में काम करते हैं।

किसी पंजीकृत Plugin इंटरैक्टिव हैंडलर द्वारा स्वीकार न किए गए कॉलबैक क्लिक एजेंट को टेक्स्ट के रूप में दिए जाते हैं: callback_data: <value>।

कार्रवाइयाँ:

• sendMessage (to, content, वैकल्पिक mediaUrl, replyToMessageId, messageThreadId)
• react (chatId, messageId, emoji)
• deleteMessage (chatId, messageId)
• editMessage (chatId, messageId, content या caption, वैकल्पिक presentation इनलाइन बटन; केवल-बटन संपादन उत्तर मार्कअप को अपडेट करते हैं)
• createForumTopic (chatId, name, वैकल्पिक iconColor, iconCustomEmojiId)

सुविधाजनक उपनाम: send, react, delete, edit, sticker, sticker-search, topic-create.

गेटिंग: channels.telegram.actions.sendMessage, deleteMessage, reactions, sticker (डिफ़ॉल्ट: अक्षम)। edit, createForumTopic, और editForumTopic बिना किसी समर्पित टॉगल के डिफ़ॉल्ट रूप से सक्षम होते हैं। रनटाइम प्रेषण स्टार्टअप/रीलोड से सक्रिय कॉन्फ़िगरेशन/सीक्रेट स्नैपशॉट का उपयोग करते हैं, इसलिए कार्रवाई पथ प्रत्येक प्रेषण के लिए SecretRef मानों को दोबारा रिज़ॉल्व नहीं करते।

प्रतिक्रिया हटाने का अर्थ-विज्ञान: /tools/reactions.

जनरेट किए गए आउटपुट में स्पष्ट उत्तर थ्रेडिंग टैग:

• [[reply_to_current]] — ट्रिगर करने वाले संदेश का उत्तर देता है
• [[reply_to:<id>]] — किसी विशिष्ट संदेश ID का उत्तर देता है

channels.telegram.replyToMode: off (डिफ़ॉल्ट), first, all.

जब उत्तर थ्रेडिंग सक्षम हो और मूल टेक्स्ट/कैप्शन उपलब्ध हो, तो OpenClaw स्वचालित रूप से एक नेटिव उद्धरण अंश जोड़ता है। Telegram नेटिव उद्धरण टेक्स्ट को 1024 UTF-16 कोड इकाइयों तक सीमित करता है; लंबे संदेशों को शुरुआत से उद्धृत किया जाता है और यदि Telegram उद्धरण अस्वीकार कर देता है, तो साधारण उत्तर का उपयोग किया जाता है।

off केवल अंतर्निहित उत्तर थ्रेडिंग को अक्षम करता है; स्पष्ट [[reply_to_*]] टैग का फिर भी पालन किया जाता है।

फ़ोरम सुपरग्रुप: विषय सत्र कुंजियों के अंत में :topic:<threadId> जुड़ता है; उत्तर और टाइपिंग विषय थ्रेड को लक्षित करते हैं; विषय कॉन्फ़िगरेशन पथ channels.telegram.groups.<chatId>.topics.<threadId> है।

सामान्य विषय (threadId=1) एक विशेष मामला है: संदेश प्रेषण message_thread_id को छोड़ देते हैं (Telegram sendMessage(...thread_id=1) को "thread not found" के साथ अस्वीकार करता है), लेकिन टाइपिंग कार्रवाइयों में फिर भी message_thread_id शामिल होता है (टाइपिंग संकेतक दिखाने के लिए अनुभवजन्य रूप से आवश्यक)।

विषय प्रविष्टियाँ ओवरराइड न होने पर समूह सेटिंग प्राप्त करती हैं (requireMention, allowFrom, skills, systemPrompt, enabled, groupPolicy)। agentId केवल विषय के लिए है और समूह डिफ़ॉल्ट से प्राप्त नहीं होता। topics."*" उस समूह के प्रत्येक विषय के लिए डिफ़ॉल्ट सेट करता है; सटीक विषय ID फिर भी "*" पर प्राथमिकता पाते हैं।

प्रति-विषय एजेंट रूटिंग: प्रत्येक विषय अपने विषय कॉन्फ़िगरेशन में agentId के माध्यम से किसी अलग एजेंट को रूट कर सकता है, जिससे उसे अपना कार्यक्षेत्र, मेमोरी और सत्र मिलता है:

{  channels: {    telegram: {      groups: {        "-1001234567890": {          topics: {            "1": { agentId: "main" },      // सामान्य विषय -> मुख्य एजेंट            "3": { agentId: "zu" },        // विकास विषय -> zu एजेंट            "5": { agentId: "coder" }      // कोड समीक्षा -> coder एजेंट          }        }      }    }  }}

इसके बाद प्रत्येक विषय की अपनी सत्र कुंजी होती है, उदाहरण के लिए agent:zu:telegram:group:-1001234567890:topic:3।

स्थायी ACP विषय बाइंडिंग: फ़ोरम विषय शीर्ष-स्तरीय टाइप की गई बाइंडिंग (bindings[] के साथ type: "acp", match.channel: "telegram", peer.kind: "group", और -1001234567890:topic:42 जैसी विषय-योग्य ID) के माध्यम से ACP हार्नेस सत्रों को पिन कर सकते हैं। वर्तमान में समूहों/सुपरग्रुपों के फ़ोरम विषयों तक सीमित है। ACP एजेंट देखें।

चैट से थ्रेड-बाउंड ACP स्पॉन: /acp spawn <agent> --thread here|auto वर्तमान विषय को एक नए ACP सत्र से बाँधता है; अनुवर्ती संदेश सीधे वहाँ रूट होते हैं, और OpenClaw स्पॉन पुष्टिकरण को विषय में पिन करता है। इसके लिए channels.telegram.threadBindings.spawnSessions आवश्यक है (डिफ़ॉल्ट: true)।

टेम्पलेट संदर्भ MessageThreadId और IsForum को उपलब्ध कराता है। message_thread_id वाली DM चैट उत्तर मेटाडेटा बनाए रखती हैं, लेकिन थ्रेड-जागरूक सत्र कुंजियों का उपयोग केवल तभी करती हैं जब Telegram getMe, has_topics_enabled: true रिपोर्ट करता है। सेवानिवृत्त dm.threadReplies और direct.*.threadReplies ओवरराइड हटा दिए गए हैं; BotFather थ्रेडेड मोड सत्य का एकमात्र स्रोत है। पुराने कॉन्फ़िगरेशन कुंजियाँ हटाने के लिए openclaw doctor --fix चलाएँ।

ऑडियो संदेश

Telegram वॉइस नोट और ऑडियो फ़ाइलों में अंतर करता है। डिफ़ॉल्ट: ऑडियो-फ़ाइल व्यवहार; वॉइस-नोट प्रेषण बाध्य करने के लिए एजेंट के उत्तर में [[audio_as_voice]] टैग लगाएँ। इनबाउंड वॉइस-नोट ट्रांसक्रिप्ट को एजेंट संदर्भ में मशीन-जनित, अविश्वसनीय टेक्स्ट के रूप में फ़्रेम किया जाता है, लेकिन उल्लेख पहचान फिर भी कच्चे ट्रांसक्रिप्ट का उपयोग करती है ताकि उल्लेख-गेटेड वॉइस संदेश काम करते रहें।

{action: "send",channel: "telegram",to: "123456789",media: "https://example.com/voice.ogg",asVoice: true,}

वीडियो संदेश

Telegram वीडियो फ़ाइलों और वीडियो नोट में अंतर करता है। वीडियो नोट कैप्शन का समर्थन नहीं करते; दिया गया संदेश टेक्स्ट अलग से भेजा जाता है।

{action: "send",channel: "telegram",to: "123456789",media: "https://example.com/video.mp4",asVideoNote: true,}

स्थान और स्थल

एक स्वतंत्र location ऑब्जेक्ट के साथ मौजूदा send कार्रवाई का उपयोग करें। निर्देशांक एक नेटिव पिन भेजते हैं; name और address दोनों जोड़ने पर एक नेटिव स्थल कार्ड भेजा जाता है। स्थान प्रेषण को संदेश टेक्स्ट या मीडिया के साथ संयोजित नहीं किया जा सकता।

{action: "send",channel: "telegram",to: "123456789",location: {latitude: 48.858844,longitude: 2.294351,accuracy: 12,name: "Eiffel Tower",address: "Champ de Mars, Paris",},}

स्टिकर

इनबाउंड: स्थिर WEBP डाउनलोड और संसाधित किया जाता है (प्लेसहोल्डर <media:sticker>); एनिमेटेड TGS और वीडियो WEBM छोड़ दिए जाते हैं।

स्टिकर संदर्भ फ़ील्ड: Sticker.emoji, Sticker.setName, Sticker.fileId, Sticker.fileUniqueId, Sticker.cachedDescription। बार-बार होने वाली विज़न कॉल कम करने के लिए विवरण OpenClaw SQLite Plugin स्थिति में कैश किए जाते हैं।

स्टिकर कार्रवाइयाँ सक्षम करें:

{channels: {telegram: {  actions: {    sticker: true,  },},},}

भेजें:

{action: "sticker",channel: "telegram",to: "123456789",fileId: "CAACAgIAAxkBAAI...",}

कैश किए गए स्टिकर खोजें:

{action: "sticker-search",channel: "telegram",query: "cat waving",limit: 5,}

Telegram प्रतिक्रियाएँ संदेश पेलोड से अलग message_reaction अपडेट के रूप में आती हैं। सक्षम होने पर, OpenClaw Telegram reaction added: 👍 by Alice (@alice) on msg 42 जैसे सिस्टम इवेंट कतार में लगाता है।

• channels.telegram.reactionNotifications: off | own | all (डिफ़ॉल्ट: own)
• channels.telegram.reactionLevel: off | ack | minimal | extensive (डिफ़ॉल्ट: minimal)

own का अर्थ केवल बॉट द्वारा भेजे गए संदेशों पर उपयोगकर्ता प्रतिक्रियाएँ है (भेजे गए संदेशों के कैश के माध्यम से सर्वोत्तम प्रयास)। प्रतिक्रिया इवेंट फिर भी Telegram अभिगम नियंत्रणों (dmPolicy, allowFrom, groupPolicy, groupAllowFrom) का पालन करते हैं; अनधिकृत प्रेषकों को छोड़ दिया जाता है।

Telegram प्रतिक्रिया अपडेट में थ्रेड ID प्रदान नहीं करता: गैर-फ़ोरम समूह समूह चैट सत्र को रूट होते हैं; फ़ोरम समूह सटीक मूल विषय के बजाय सामान्य-विषय सत्र (:topic:1) को रूट होते हैं।

पोलिंग/Webhook के लिए allowed_updates में message_reaction स्वचालित रूप से शामिल होता है।

जब OpenClaw किसी इनबाउंड संदेश को संसाधित करता है, तब ackReaction एक पावती इमोजी भेजता है। messages.ackReactionScope तय करता है कि इसे कब भेजा जाए।

इमोजी रिज़ॉल्यूशन क्रम:

• channels.telegram.accounts.<accountId>.ackReaction
• channels.telegram.ackReaction
• messages.ackReaction
• एजेंट पहचान इमोजी फ़ॉलबैक (agents.list[].identity.emoji, अन्यथा "👀")

Telegram एक यूनिकोड इमोजी की अपेक्षा करता है (उदाहरण के लिए "👀"); किसी चैनल या खाते के लिए प्रतिक्रिया अक्षम करने हेतु "" का उपयोग करें।

दायरा (messages.ackReactionScope, डिफ़ॉल्ट "group-mentions"; वर्तमान में कोई Telegram-खाता या Telegram-चैनल ओवरराइड नहीं):

all (DM + समूह, परिवेशी कक्ष इवेंट सहित), direct (केवल DM), group-all (परिवेशी कक्ष इवेंट को छोड़कर प्रत्येक समूह संदेश, कोई DM नहीं), group-mentions (वे समूह जहाँ बॉट का उल्लेख किया गया हो; कोई DM नहीं — डिफ़ॉल्ट), off / none (अक्षम)।

चैनल कॉन्फ़िगरेशन लेखन डिफ़ॉल्ट रूप से सक्षम है (configWrites !== false)। Telegram द्वारा ट्रिगर किए गए लेखन में समूह माइग्रेशन इवेंट (migrate_to_chat_id, channels.telegram.groups को अपडेट करता है) और /config set / /config unset शामिल हैं (कमांड सक्षम होना आवश्यक है)।

अक्षम करें:

{channels: {telegram: {  configWrites: false,},},}

डिफ़ॉल्ट लॉन्ग पोलिंग है। Webhook मोड के लिए channels.telegram.webhookUrl और channels.telegram.webhookSecret सेट करें; वैकल्पिक webhookPath (डिफ़ॉल्ट /telegram-webhook), webhookHost (डिफ़ॉल्ट 127.0.0.1), webhookPort (डिफ़ॉल्ट 8787), webhookCertPath (प्रत्यक्ष-IP या बिना-डोमेन सेटअप के लिए स्व-हस्ताक्षरित प्रमाणपत्र PEM)।

लॉन्ग-पोलिंग मोड में, OpenClaw अपना पुनरारंभ वॉटरमार्क केवल किसी अपडेट के सफलतापूर्वक डिस्पैच होने के बाद स्थायी करता है; विफल हैंडलर उस अपडेट को पूर्ण चिह्नित करने के बजाय उसी प्रक्रिया में पुनः प्रयास योग्य बनाए रखता है।

स्थानीय लिसनर डिफ़ॉल्ट रूप से 127.0.0.1:8787 से बाइंड होता है। सार्वजनिक इनग्रेस के लिए स्थानीय पोर्ट के सामने एक रिवर्स प्रॉक्सी रखें, या जानबूझकर webhookHost: "0.0.0.0" सेट करें।

Webhook मोड अनुरोध गार्ड, Telegram सीक्रेट टोकन और JSON बॉडी को सत्यापित करता है, फिर खाली 200 लौटाने से पहले अपडेट को अपनी टिकाऊ इनग्रेस कतार में कमिट करता है। सफल टिकाऊ अंगीकरण में x-openclaw-delivery-accepted: durable शामिल होता है; स्वास्थ्य, रूटिंग, प्रमाणीकरण, सत्यापन और संग्रहण-त्रुटि प्रतिक्रियाएँ इस हेडर को छोड़ देती हैं। रिवर्स प्रॉक्सी और होस्ट नियंत्रक प्रतिक्रिया समय से स्वीकृति का अनुमान लगाए बिना OpenClaw अंगीकरण को सामान्य खाली 200 से अलग करने के लिए हेडर आवश्यक कर सकते हैं।

टिकाऊ लेखन के बाद, OpenClaw कोर चैनल-इनग्रेस ड्रेन के माध्यम से अपडेट क्लेम और संसाधित करता है (प्रति-चैट/प्रति-विषय लेन, टर्न अंगीकरण पर पूर्ण, पूर्व-अंगीकरण स्टॉल टाइमआउट)। धीमे एजेंट टर्न Telegram की डिलीवरी ACK को रोके नहीं रखते।

• channels.telegram.textChunkLimit डिफ़ॉल्ट रूप से 4000; streaming.chunkMode="newline" लंबाई के आधार पर विभाजन से पहले अनुच्छेद सीमाओं (रिक्त पंक्तियों) को प्राथमिकता देता है।
• channels.telegram.mediaMaxMb (डिफ़ॉल्ट 100) इनबाउंड और आउटबाउंड मीडिया आकार को सीमित करता है।
• समूह संदर्भ इतिहास channels.telegram.historyLimit या messages.groupChat.historyLimit (डिफ़ॉल्ट 50) का उपयोग करता है; 0 इसे अक्षम करता है।
• जब Gateway ने मूल संदेशों को देखा हो, तब उत्तर/उद्धरण/अग्रेषण का पूरक संदर्भ एक चयनित वार्तालाप संदर्भ विंडो में सामान्यीकृत होता है; देखे गए संदेशों का कैश OpenClaw SQLite Plugin स्थिति में रहता है, और openclaw doctor --fix पुराने साइडकार आयात करता है। Telegram प्रत्येक अपडेट में केवल एक उथला reply_to_message शामिल करता है, इसलिए कैश से पुरानी शृंखलाएँ उस पेलोड तक सीमित होती हैं।
• Telegram की अनुमति-सूचियाँ मुख्य रूप से यह नियंत्रित करती हैं कि एजेंट को कौन ट्रिगर कर सकता है, वे पूरक संदर्भ को पूर्णतः संपादित करने की सीमा नहीं हैं।
• DM इतिहास: channels.telegram.dmHistoryLimit, channels.telegram.dms["<user_id>"].historyLimit।

CLI और संदेश-टूल के प्रेषण लक्ष्य संख्यात्मक चैट ID, उपयोगकर्ता नाम या फ़ोरम विषय लक्ष्य स्वीकार करते हैं:

openclaw message send --channel telegram --target 123456789 --message "hi"openclaw message send --channel telegram --target @name --message "hi"openclaw message send --channel telegram --target -1001234567890:topic:42 --message "hi topic"

पोल openclaw message poll का उपयोग करते हैं और फ़ोरम विषयों का समर्थन करते हैं:

openclaw message poll --channel telegram --target 123456789 \--poll-question "Ship it?" --poll-option "Yes" --poll-option "No"openclaw message poll --channel telegram --target -1001234567890:topic:42 \--poll-question "Pick a time" --poll-option "10am" --poll-option "2pm" \--poll-duration-seconds 300 --poll-public

केवल Telegram के पोल फ़्लैग: --poll-duration-seconds (5-600), --poll-anonymous, --poll-public, --thread-id (या एक :topic: लक्ष्य)। --poll-option 2-12 बार दोहराता है (Telegram की विकल्प सीमा)।

Telegram प्रेषण इनलाइन कीबोर्ड के लिए buttons ब्लॉक के साथ --presentation का भी समर्थन करता है (जब channels.telegram.capabilities.inlineButtons इसकी अनुमति देता है), उस चैट में बॉट के पास पिन करने की अनुमति होने पर पिन की गई डिलीवरी का अनुरोध करने के लिए --pin या --delivery '{"pin":true}', और आउटबाउंड छवियों, GIF तथा वीडियो को संपीड़ित/एनिमेटेड/वीडियो अपलोड के बजाय दस्तावेज़ों के रूप में भेजने के लिए --force-document।

कार्रवाई नियंत्रण: channels.telegram.actions.sendMessage=false पोल सहित सभी आउटबाउंड संदेशों को अक्षम करता है; channels.telegram.actions.poll=false नियमित प्रेषण सक्षम रखते हुए पोल निर्माण को अक्षम करता है।

Telegram अनुमोदक के DM में निष्पादन अनुमोदन का समर्थन करता है और वैकल्पिक रूप से मूल चैट या विषय में प्रॉम्प्ट पोस्ट कर सकता है। अनुमोदक संख्यात्मक Telegram उपयोगकर्ता ID होने चाहिए।

• channels.telegram.execApprovals.enabled ("auto" कम-से-कम एक अनुमोदक के समाधान योग्य होने पर सक्षम करता है)
• channels.telegram.execApprovals.approvers (commands.ownerAllowFrom से संख्यात्मक स्वामी ID पर वापस जाता है)
• channels.telegram.execApprovals.target: dm (डिफ़ॉल्ट) | channel | both
• agentFilter, sessionFilter

channels.telegram.allowFrom, groupAllowFrom, और defaultTo यह नियंत्रित करते हैं कि बॉट से कौन बात कर सकता है और वह सामान्य उत्तर कहाँ भेजता है — वे किसी व्यक्ति को निष्पादन अनुमोदक नहीं बनाते। जब अभी तक कोई कमांड स्वामी मौजूद न हो, तो पहला अनुमोदित DM युग्मन commands.ownerAllowFrom को प्रारंभ करता है, जिससे एक-स्वामी वाले सेटअप में execApprovals.approvers के अंतर्गत ID दोहराने की आवश्यकता नहीं होती।

चैनल डिलीवरी चैट में कमांड टेक्स्ट दिखाती है; channel या both को केवल विश्वसनीय समूहों/विषयों में सक्षम करें। जब प्रॉम्प्ट किसी फ़ोरम विषय में पहुँचता है, तो OpenClaw अनुमोदन प्रॉम्प्ट और अनुवर्ती कार्रवाई के लिए विषय बनाए रखता है। निष्पादन अनुमोदन डिफ़ॉल्ट रूप से 30 मिनट बाद समाप्त हो जाते हैं।

इनलाइन अनुमोदन बटनों के लिए यह भी आवश्यक है कि channels.telegram.capabilities.inlineButtons लक्षित सतह (dm, group, या all) की अनुमति दे। plugin: से आरंभ होने वाली अनुमोदन ID Plugin अनुमोदनों के माध्यम से हल होती हैं; अन्य पहले निष्पादन अनुमोदनों के माध्यम से हल होती हैं।

निष्पादन अनुमोदन देखें।

• यदि requireMention=false, तो Telegram गोपनीयता मोड को पूर्ण दृश्यता की अनुमति देनी चाहिए: BotFather /setprivacy -> Disable, फिर बॉट को समूह से हटाकर दोबारा जोड़ें।
• जब कॉन्फ़िगरेशन उल्लेख के बिना समूह संदेशों की अपेक्षा करता है, तो openclaw channels status चेतावनी देता है।
• openclaw channels status --probe स्पष्ट संख्यात्मक समूह ID की जाँच करता है; वाइल्डकार्ड "*" की सदस्यता जाँची नहीं जा सकती।
• त्वरित सत्र परीक्षण: /activation always।

• जब channels.telegram.groups मौजूद हो, तो समूह सूचीबद्ध होना चाहिए (या "*" शामिल करें)।
• समूह में बॉट की सदस्यता सत्यापित करें।
• छोड़े जाने के कारणों के लिए openclaw logs --follow की समीक्षा करें।

• अपनी प्रेषक पहचान को अधिकृत करें (युग्मन और/या संख्यात्मक allowFrom); समूह नीति open होने पर भी कमांड प्राधिकरण लागू होता है।
• BOT_COMMANDS_TOO_MUCH के साथ setMyCommands failed का अर्थ है कि मूल मेन्यू में बहुत अधिक प्रविष्टियाँ हैं; Plugin/Skill/कस्टम कमांड कम करें या मूल मेन्यू अक्षम करें।
• deleteMyCommands / setMyCommands स्टार्टअप कॉल और sendChatAction टाइपिंग कॉल सीमित हैं तथा अनुरोध टाइमआउट पर Telegram के ट्रांसपोर्ट फ़ॉलबैक के माध्यम से एक बार पुनः प्रयास करते हैं। लगातार नेटवर्क/फ़ेच त्रुटियों का सामान्यतः अर्थ है कि api.telegram.org तक DNS/HTTPS पहुँच योग्य नहीं है।

• getMe returned 401 कॉन्फ़िगर किए गए बॉट टोकन के लिए Telegram प्रमाणीकरण विफलता है। BotFather में टोकन को दोबारा कॉपी या पुनः उत्पन्न करें, फिर channels.telegram.botToken, tokenFile, accounts.<id>.botToken, या TELEGRAM_BOT_TOKEN (डिफ़ॉल्ट खाता) अपडेट करें।
• स्टार्टअप के दौरान deleteWebhook 401 Unauthorized भी प्रमाणीकरण विफलता है; इसे "कोई Webhook मौजूद नहीं है" मानने से उसी अमान्य टोकन की विफलता केवल बाद की API कॉल तक टलेगी।

• यदि AbortSignal प्रकार मेल नहीं खाते, तो कस्टम फ़ेच/प्रॉक्सी के साथ Node 22+ तत्काल निरस्तीकरण व्यवहार ट्रिगर कर सकता है।
• कुछ होस्ट api.telegram.org को पहले IPv6 में रिज़ॉल्व करते हैं; खराब IPv6 इग्रेस रुक-रुककर API विफलताएँ उत्पन्न करता है।
• TypeError: fetch failed या Network request for 'getUpdates' failed! वाले लॉग पर पुनर्प्राप्ति योग्य नेटवर्क त्रुटियों के रूप में पुनः प्रयास किया जाता है।
• पोलिंग स्टार्टअप के दौरान OpenClaw grammY के लिए सफल स्टार्टअप getMe प्रोब का पुनः उपयोग करता है, ताकि रनर को पहले getUpdates से पहले दूसरे getMe की आवश्यकता न हो।
• यदि पोलिंग स्टार्टअप के दौरान deleteWebhook क्षणिक नेटवर्क त्रुटि के कारण विफल होता है, तो OpenClaw एक और प्री-पोल कंट्रोल-प्लेन कॉल करने के बजाय लॉन्ग पोलिंग में आगे बढ़ता है। तब भी सक्रिय Webhook getUpdates टकराव के रूप में सामने आता है; OpenClaw ट्रांसपोर्ट को पुनर्निर्मित करता है और Webhook सफ़ाई का पुनः प्रयास करता है।
• लॉग में Polling stall detected का अर्थ है कि डिफ़ॉल्ट रूप से 120 सेकंड तक लॉन्ग-पोल सक्रियता पूरी न होने के बाद OpenClaw पोलिंग पुनः आरंभ करता है और ट्रांसपोर्ट को पुनर्निर्मित करता है।
• openclaw channels status --probe और openclaw doctor तब चेतावनी देते हैं जब कोई चालू पोलिंग खाता स्टार्टअप ग्रेस के बाद getUpdates पूरा नहीं कर पाया हो, कोई चालू Webhook खाता स्टार्टअप ग्रेस के बाद setWebhook पूरा नहीं कर पाया हो, या अंतिम सफल पोलिंग ट्रांसपोर्ट गतिविधि पुरानी हो।
• Telegram Bot API ट्रांसपोर्ट के लिए प्रक्रिया के प्रॉक्सी परिवेश का सम्मान करता है: HTTP_PROXY, HTTPS_PROXY, ALL_PROXY, और छोटे अक्षरों वाले संस्करण। NO_PROXY / no_proxy फिर भी api.telegram.org को बायपास कर सकते हैं।
• यदि किसी सेवा परिवेश के लिए OPENCLAW_PROXY_URL सेट है और कोई मानक प्रॉक्सी परिवेश मौजूद नहीं है, तो Telegram Bot API ट्रांसपोर्ट के लिए भी उस URL का उपयोग करता है।
• अस्थिर सीधे इग्रेस/TLS वाले VPS होस्ट पर Telegram API कॉल को प्रॉक्सी के माध्यम से रूट करें:

channels:telegram:proxy: socks5://<user>:<password>@proxy-host:1080

• Node 22+ डिफ़ॉल्ट रूप से autoSelectFamily=true का उपयोग करता है (WSL2 को छोड़कर)। Telegram DNS परिणाम क्रम पहले OPENCLAW_TELEGRAM_DNS_RESULT_ORDER, फिर channels.telegram.network.dnsResultOrder, फिर प्रक्रिया के डिफ़ॉल्ट (उदाहरण के लिए NODE_OPTIONS=--dns-result-order=ipv4first) का सम्मान करता है; यदि इनमें से कोई लागू न हो, तो Node 22+ पर ipv4first पर वापस जाता है।
• WSL2 पर, या जब केवल-IPv4 व्यवहार बेहतर काम करता हो, तो फ़ैमिली चयन बाध्य करें:

channels:telegram:network:  autoSelectFamily: false

• RFC 2544 बेंचमार्क-रेंज उत्तर (198.18.0.0/15) Telegram मीडिया डाउनलोड के लिए डिफ़ॉल्ट रूप से पहले से अनुमत हैं। यदि कोई विश्वसनीय नकली-IP या पारदर्शी प्रॉक्सी मीडिया डाउनलोड के दौरान api.telegram.org को किसी अन्य निजी/आंतरिक/विशेष-उपयोग पते में पुनर्लेखित करता है, तो केवल Telegram वाले बायपास को स्वीकार करें:

channels:telegram:network:  dangerouslyAllowPrivateNetwork: true

• यही वैकल्पिक स्वीकृति प्रति खाते channels.telegram.accounts.<accountId>.network.dangerouslyAllowPrivateNetwork पर उपलब्ध है।
• यदि आपका प्रॉक्सी Telegram मीडिया होस्ट को 198.18.x.x में रिज़ॉल्व करता है, तो पहले खतरनाक फ़्लैग बंद रखें — वह रेंज डिफ़ॉल्ट रूप से पहले से अनुमत है।

• अस्थायी परिवेश ओवरराइड: OPENCLAW_TELEGRAM_DISABLE_AUTO_SELECT_FAMILY=1, OPENCLAW_TELEGRAM_ENABLE_AUTO_SELECT_FAMILY=1, OPENCLAW_TELEGRAM_DNS_RESULT_ORDER=ipv4first।
• DNS उत्तर सत्यापित करें:

dig +short api.telegram.org Adig +short api.telegram.org AAAA