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 ने कॉन्फ़िगर किया गया बॉट टोकन अस्वीकार कर दिया। वर्तमान BotFather टोकन से botToken, tokenFile या TELEGRAM_BOT_TOKEN (डिफ़ॉल्ट अकाउंट) अपडेट करें; 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 स्पॉन पुष्टिकरण को विषय में पिन करता है। इसे session.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.entries.*.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