Telegram

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

यदि बॉट को सभी समूह संदेश देखने चाहिए, तो इनमें से कोई एक करें:

• /setprivacy के माध्यम से privacy mode अक्षम करें, या
• बॉट को समूह admin बनाएँ।

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

Admin स्थिति Telegram समूह सेटिंग्स में नियंत्रित होती है।

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

• /setjoingroups समूह में जोड़ने की अनुमति/मनाही के लिए
• /setprivacy समूह visibility व्यवहार के लिए

OpenClaw partial replies को real time में stream कर सकता है:

• direct chats: preview message + editMessageText
• groups/topics: preview message + editMessageText

आवश्यकता:

• channels.telegram.streaming off | partial | block | progress है (default: partial)
• छोटे initial answer previews debounce किए जाते हैं, फिर run अभी भी active होने पर bounded delay के बाद materialize होते हैं
• progress tool progress के लिए एक editable status draft रखता है, tool progress से पहले answer activity आने पर stable status label दिखाता है, completion पर उसे clear करता है, और final answer को normal message के रूप में भेजता है
• streaming.preview.toolProgress नियंत्रित करता है कि tool/progress updates वही edited preview message reuse करें या नहीं (default: preview streaming active होने पर true)
• streaming.preview.commandText उन tool-progress lines के अंदर command/exec detail नियंत्रित करता है: raw (default, released behavior सुरक्षित रखता है) या status (केवल tool label)
• streaming.progress.commentary (default: false) temporary progress draft में assistant commentary/preamble text को opt in करता है
• legacy channels.telegram.streamMode, boolean streaming values, और retired native draft preview keys detect की जाती हैं; उन्हें current streaming config में migrate करने के लिए openclaw doctor --fix चलाएँ

Tool-progress preview updates वे छोटे status lines हैं जो tools चलने के दौरान दिखते हैं, जैसे command execution, file reads, planning updates, patch summaries, या Codex app-server mode में Codex preamble/commentary text। Telegram इन्हें default रूप से enabled रखता है ताकि v2026.4.22 और बाद के released OpenClaw behavior से मेल बना रहे।

Answer text के लिए edited preview रखना लेकिन tool-progress lines छिपाना हो, तो set करें:

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

Tool-progress visible रखना लेकिन command/exec text छिपाना हो, तो set करें:

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

जब आप final answer को उसी message में edit किए बिना visible tool progress चाहते हों, तब progress mode का उपयोग करें। Command-text policy को streaming.progress के नीचे रखें:

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

streaming.mode: "off" केवल तब उपयोग करें जब आप final-only delivery चाहते हों: Telegram preview edits disabled होते हैं और generic tool/progress chatter को standalone status messages के रूप में भेजने के बजाय suppress किया जाता है। Approval prompts, media payloads, और errors फिर भी normal final delivery के माध्यम से route होते हैं। streaming.preview.toolProgress: false तब उपयोग करें जब आप tool-progress status lines छिपाते हुए केवल answer preview edits रखना चाहते हों।

Text-only replies के लिए:

• छोटे DM/group/topic previews: OpenClaw वही preview message रखता है और final edit in place करता है
• कई Telegram messages में split होने वाले long text finals, संभव होने पर existing preview को first final chunk के रूप में reuse करते हैं, फिर केवल remaining chunks भेजते हैं
• progress-mode finals status draft clear करते हैं और draft को answer में edit करने के बजाय normal final delivery उपयोग करते हैं
• अगर completed text confirm होने से पहले final edit fail हो जाता है, तो OpenClaw normal final delivery उपयोग करता है और stale preview साफ करता है

Complex replies (जैसे media payloads) के लिए, OpenClaw normal final delivery पर fall back करता है और फिर preview message साफ करता है।

Preview streaming, block streaming से अलग है। जब Telegram के लिए block streaming explicitly enabled हो, तो OpenClaw double-streaming से बचने के लिए preview stream skip करता है।

Reasoning stream behavior:

• /reasoning stream supported channel के reasoning-preview path का उपयोग करता है; Telegram पर, यह generate करते समय reasoning को live preview में stream करता है
• final delivery के बाद reasoning preview delete हो जाता है; reasoning visible रखना हो तो /reasoning on उपयोग करें
• final answer reasoning text के बिना भेजा जाता है

Outbound text default रूप से standard Telegram HTML messages का उपयोग करता है, ताकि replies current Telegram clients में readable रहें। यह compatibility mode normal bold, italic, links, code, spoilers, और quotes को support करता है, लेकिन Bot API 10.1 rich-only blocks जैसे native tables, details, rich media, और formulas को नहीं।

Bot API 10.1 rich messages में opt in करने के लिए channels.telegram.richMessages: true set करें:

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

Enabled होने पर:

• Agent को बताया जाता है कि इस bot/account के लिए Telegram rich messages available हैं।
• Markdown text OpenClaw के Markdown IR से render होकर Telegram rich HTML के रूप में भेजा जाता है।
• Explicit rich HTML payloads supported Bot API 10.1 tags जैसे headings, tables, details, rich media, और formulas को preserve करते हैं।
• Media captions अभी भी Telegram HTML captions का उपयोग करते हैं क्योंकि rich messages captions को replace नहीं करते।

इससे model text Telegram Rich Markdown sigils से दूर रहता है, इसलिए $400-600K जैसी currency math के रूप में parse नहीं होती। Long rich text automatically Telegram की rich text और rich block limits के पार split होता है। Telegram की column limit से अधिक tables code blocks के रूप में भेजे जाते हैं।

Default: client compatibility के लिए off। Rich messages के लिए compatible Telegram clients आवश्यक हैं; कुछ current Desktop, Web, Android, और third-party clients accepted rich messages को unsupported के रूप में display करते हैं। इस option को disabled रखें, जब तक bot के साथ उपयोग होने वाला हर client इन्हें render न कर सके। /status दिखाता है कि current Telegram session में rich messages on हैं या off।

Link previews default रूप से enabled हैं। channels.telegram.linkPreview: false rich text के लिए automatic entity detection skip करता है।

Telegram command menu registration startup पर setMyCommands के साथ handle किया जाता है।

Native command defaults:

• commands.native: "auto" Telegram के लिए native commands enable करता है

Custom command menu entries जोड़ें:

{channels: {telegram: {  customCommands: [    { command: "backup", description: "Git backup" },    { command: "generate", description: "Create an image" },  ],},},}

नियम:

• names normalized होते हैं (leading / हटाएँ, lowercase)
• valid pattern: a-z, 0-9, _, length 1..32
• custom commands native commands को override नहीं कर सकते
• conflicts/duplicates skip किए जाते हैं और log होते हैं

Notes:

• custom commands केवल menu entries हैं; वे behavior को auto-implement नहीं करते
• plugin/skill commands typed होने पर अभी भी काम कर सकते हैं, भले ही Telegram menu में न दिखें

अगर native commands disabled हैं, तो built-ins हटाए जाते हैं। Custom/plugin commands configured होने पर अभी भी register हो सकते हैं।

Common setup failures:

• setMyCommands failed के साथ BOT_COMMANDS_TOO_MUCH का मतलब है कि trimming के बाद भी Telegram menu overflow हुआ; plugin/skill/custom commands कम करें या channels.telegram.commands.native disable करें।
• Direct Bot API curl commands काम करते समय deleteWebhook, deleteMyCommands, या setMyCommands का 404: Not Found के साथ fail होना यह संकेत दे सकता है कि channels.telegram.apiRoot को full /bot<TOKEN> endpoint पर set किया गया था। apiRoot केवल Bot API root होना चाहिए, और openclaw doctor --fix accidental trailing /bot<TOKEN> को हटाता है।
• getMe returned 401 का मतलब है कि Telegram ने configured bot token reject कर दिया। Current BotFather token के साथ botToken, tokenFile, या TELEGRAM_BOT_TOKEN update करें; OpenClaw polling से पहले रुक जाता है, इसलिए इसे webhook cleanup failure के रूप में report नहीं किया जाता।
• Network/fetch errors के साथ setMyCommands failed का आमतौर पर मतलब है कि api.telegram.org तक outbound DNS/HTTPS blocked है।

Device pairing commands (device-pair plugin)

जब device-pair plugin installed हो:

1. /pair setup code generate करता है
2. iOS app में code paste करें
3. /pair pending pending requests list करता है (role/scopes सहित)
4. request approve करें:
   • explicit approval के लिए /pair approve <requestId>
   • जब केवल एक pending request हो, तो /pair approve
   • most recent के लिए /pair approve latest

Setup code एक short-lived bootstrap token carry करता है। Built-in setup-code bootstrap scopes: [] के साथ durable node token और trusted mobile onboarding के लिए bounded operator handoff token लौटाता है। वह operator token setup-time native configuration पढ़ सकता है, लेकिन pairing mutation scopes या operator.admin grant नहीं करता।

अगर device बदली हुई auth details (जैसे role/scopes/public key) के साथ retry करता है, तो पिछली pending request supersede हो जाती है और नई request अलग requestId उपयोग करती है। Approve करने से पहले /pair pending फिर से चलाएँ।

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

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

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

प्रति-अकाउंट override:

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

Scopes:

• off
• dm
• group
• all
• allowlist (डिफ़ॉल्ट)

Legacy capabilities: ["inlineButtons"] inlineButtons: "all" पर मैप होता है।

संदेश action उदाहरण:

{action: "send",channel: "telegram",to: "123456789",message: "Choose an option:",buttons: [[  { text: "Yes", callback_data: "yes" },  { text: "No", callback_data: "no" },],[{ text: "Cancel", callback_data: "cancel" }],],}

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

{action: "send",channel: "telegram",to: "123456789",message: "Open app:",presentation: {blocks: [  {    type: "buttons",    buttons: [{ label: "Launch", web_app: { url: "https://example.com/app" } }],  },],},}

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

Callback क्लिक जिन्हें किसी रजिस्टर्ड plugin interactive handler ने claim नहीं किया है, agent को टेक्स्ट के रूप में पास किए जाते हैं: callback_data: <value>

Telegram tool actions में शामिल हैं:

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

Channel message actions ergonomic aliases (send, react, delete, edit, sticker, sticker-search, topic-create) expose करते हैं।

Gating controls:

• channels.telegram.actions.sendMessage
• channels.telegram.actions.deleteMessage
• channels.telegram.actions.reactions
• channels.telegram.actions.sticker (डिफ़ॉल्ट: disabled)

नोट: edit और topic-create फ़िलहाल डिफ़ॉल्ट रूप से enabled हैं और इनके लिए अलग channels.telegram.actions.* toggles नहीं हैं। Runtime sends सक्रिय config/secrets snapshot (startup/reload) का उपयोग करते हैं, इसलिए action paths प्रत्येक send पर ad-hoc SecretRef re-resolution नहीं करते।

Reaction removal semantics: /tools/reactions

Telegram generated output में explicit reply threading tags का समर्थन करता है:

• [[reply_to_current]] triggering message का reply देता है
• [[reply_to:<id>]] किसी विशिष्ट Telegram message ID का reply देता है

channels.telegram.replyToMode handling नियंत्रित करता है:

• off (डिफ़ॉल्ट)
• first
• all

जब reply threading enabled हो और मूल Telegram text या caption उपलब्ध हो, OpenClaw अपने-आप native Telegram quote excerpt शामिल करता है। Telegram native quote text को 1024 UTF-16 code units तक सीमित करता है, इसलिए लंबे messages की quote शुरुआत से ली जाती है और अगर Telegram quote अस्वीकार कर दे तो plain reply पर fallback होता है।

नोट: off implicit reply threading को disabled करता है। Explicit [[reply_to_*]] tags फिर भी सम्मानित किए जाते हैं।

Forum supergroups:

• topic session keys में :topic:<threadId> जुड़ता है
• replies और typing topic thread को target करते हैं
• topic config path: channels.telegram.groups.<chatId>.topics.<threadId>

General topic (threadId=1) special-case:

• message sends message_thread_id छोड़ देते हैं (Telegram sendMessage(...thread_id=1) को reject करता है)
• typing actions फिर भी message_thread_id शामिल करते हैं

Topic inheritance: topic entries group settings को inherit करती हैं जब तक override न किया जाए (requireMention, allowFrom, skills, systemPrompt, enabled, groupPolicy)। agentId केवल topic के लिए है और group defaults से inherit नहीं करता। topics."*" उस group के हर topic के लिए defaults सेट करता है; exact topic IDs फिर भी "*" से अधिक प्राथमिकता रखते हैं।

प्रति-topic agent routing: हर topic, topic config में agentId सेट करके अलग agent को route कर सकता है। इससे हर topic को अपना isolated workspace, memory, और session मिलता है। उदाहरण:

{  channels: {    telegram: {      groups: {        "-1001234567890": {          topics: {            "1": { agentId: "main" },      // General topic → main agent            "3": { agentId: "zu" },        // Dev topic → zu agent            "5": { agentId: "coder" }      // Code review → coder agent          }        }      }    }  }}

फिर हर topic की अपनी session key होती है: agent:zu:telegram:group:-1001234567890:topic:3

Persistent ACP topic binding: Forum topics top-level typed ACP bindings (bindings[] जिसमें type: "acp" और match.channel: "telegram", peer.kind: "group", और -1001234567890:topic:42 जैसी topic-qualified id हो) के माध्यम से ACP harness sessions pin कर सकते हैं। फ़िलहाल groups/supergroups में forum topics तक scoped है। देखें ACP Agents।

Chat से thread-bound ACP spawn: /acp spawn <agent> --thread here|auto current topic को नए ACP session से bind करता है; follow-ups सीधे वहीं route होते हैं। OpenClaw spawn confirmation को in-topic pin करता है। channels.telegram.threadBindings.spawnSessions enabled रहना आवश्यक है (डिफ़ॉल्ट: true)।

Template context MessageThreadId और IsForum expose करता है। message_thread_id वाली DM chats reply metadata रखती हैं; वे thread-aware session keys केवल तब उपयोग करती हैं जब Telegram getMe bot के लिए has_topics_enabled: true report करता है। पुराने dm.threadReplies और direct.*.threadReplies overrides जानबूझकर retired हैं; BotFather threaded mode को single source of truth के रूप में उपयोग करें और stale config keys हटाने के लिए openclaw doctor --fix चलाएं।

Audio messages

Telegram voice notes और audio files में अंतर करता है।

• डिफ़ॉल्ट: audio file behavior
• voice-note send force करने के लिए agent reply में tag [[audio_as_voice]]
• inbound voice-note transcripts को agent context में machine-generated, untrusted text के रूप में frame किया जाता है; mention detection फिर भी raw transcript का उपयोग करता है ताकि mention-gated voice messages काम करते रहें।

Message action उदाहरण:

{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,}

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

स्टिकर

आने वाले स्टिकर का प्रबंधन:

• static WEBP: डाउनलोड और प्रोसेस किया गया (placeholder <media:sticker>)
• animated TGS: छोड़ा गया
• video WEBM: छोड़ा गया

स्टिकर संदर्भ फ़ील्ड:

• Sticker.emoji
• Sticker.setName
• Sticker.fileId
• Sticker.fileUniqueId
• Sticker.cachedDescription

बार-बार vision कॉल कम करने के लिए स्टिकर विवरण 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 अपडेट के रूप में आती हैं (संदेश payloads से अलग)।

सक्षम होने पर, 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 का अर्थ है केवल bot द्वारा भेजे गए संदेशों पर उपयोगकर्ता प्रतिक्रियाएं (भेजे गए संदेश कैश के माध्यम से best-effort)।
• प्रतिक्रिया इवेंट फिर भी Telegram एक्सेस नियंत्रणों (dmPolicy, allowFrom, groupPolicy, groupAllowFrom) का पालन करते हैं; अनधिकृत प्रेषक हटा दिए जाते हैं।
• Telegram प्रतिक्रिया अपडेट में thread IDs प्रदान नहीं करता।
  • non-forum groups समूह चैट सत्र पर रूट होते हैं
  • forum groups समूह के general-topic सत्र (:topic:1) पर रूट होते हैं, सटीक मूल topic पर नहीं

polling/Webhook के लिए allowed_updates में message_reaction अपने आप शामिल होता है।

जब OpenClaw किसी आने वाले संदेश को प्रोसेस कर रहा होता है, तो ackReaction एक acknowledgement emoji भेजता है। ackReactionScope तय करता है कि वह emoji वास्तव में कब भेजा जाता है।

Emoji (ackReaction) समाधान क्रम:

• channels.telegram.accounts.<accountId>.ackReaction
• channels.telegram.ackReaction
• messages.ackReaction
• agent identity emoji fallback (agents.list[].identity.emoji, अन्यथा "👀")

नोट्स:

• Telegram unicode emoji की अपेक्षा करता है (उदाहरण के लिए "👀")।
• किसी channel या account के लिए प्रतिक्रिया अक्षम करने हेतु "" का उपयोग करें।

Scope (messages.ackReactionScope):

Telegram provider scope को messages.ackReactionScope से पढ़ता है (डिफ़ॉल्ट "group-mentions")। आज कोई Telegram-account या Telegram-channel-level override नहीं है।

मान: "all" (DMs + groups), "direct" (केवल DMs), "group-all" (हर group message, DMs नहीं), "group-mentions" (groups जब bot का उल्लेख हो; DMs नहीं — यह डिफ़ॉल्ट है), "off" / "none" (अक्षम)।

Channel config writes डिफ़ॉल्ट रूप से सक्षम होते हैं (configWrites !== false)।

Telegram-triggered writes में शामिल हैं:

• channels.telegram.groups अपडेट करने के लिए group migration events (migrate_to_chat_id)
• /config set और /config unset (command enablement आवश्यक)

अक्षम करें:

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

डिफ़ॉल्ट long polling है। Webhook मोड के लिए channels.telegram.webhookUrl और channels.telegram.webhookSecret सेट करें; वैकल्पिक webhookPath, webhookHost, webhookPort (डिफ़ॉल्ट /telegram-webhook, 127.0.0.1, 8787)।

long-polling मोड में OpenClaw अपना restart watermark केवल किसी update के सफलतापूर्वक dispatch होने के बाद persist करता है। यदि कोई handler विफल होता है, तो वह update उसी process में retryable रहता है और restart dedupe के लिए completed के रूप में नहीं लिखा जाता।

local listener 127.0.0.1:8787 से bind होता है। public ingress के लिए, या तो local port के सामने reverse proxy लगाएं या जानबूझकर webhookHost: "0.0.0.0" सेट करें।

Webhook मोड Telegram को 200 लौटाने से पहले request guards, Telegram secret token, और JSON body को validate करता है। फिर OpenClaw update को long polling द्वारा उपयोग की जाने वाली उसी per-chat/per-topic bot lanes के माध्यम से asynchronously प्रोसेस करता है, इसलिए धीमे agent turns Telegram के delivery ACK को रोकते नहीं हैं।

• channels.telegram.textChunkLimit का डिफ़ॉल्ट 4000 है.
• channels.telegram.chunkMode="newline" लंबाई के आधार पर विभाजन से पहले अनुच्छेद सीमाओं (खाली पंक्तियों) को प्राथमिकता देता है.
• channels.telegram.mediaMaxMb (डिफ़ॉल्ट 100) आने वाले और जाने वाले Telegram मीडिया आकार को सीमित करता है.
• channels.telegram.mediaGroupFlushMs (डिफ़ॉल्ट 500) नियंत्रित करता है कि OpenClaw द्वारा Telegram एल्बम/मीडिया समूहों को एक इनबाउंड संदेश के रूप में भेजने से पहले उन्हें कितनी देर बफ़र किया जाता है. यदि एल्बम के हिस्से देर से आते हैं तो इसे बढ़ाएं; एल्बम जवाब विलंबता घटाने के लिए इसे घटाएं.
• channels.telegram.timeoutSeconds Telegram API क्लाइंट टाइमआउट को ओवरराइड करता है (यदि सेट नहीं है, तो grammY डिफ़ॉल्ट लागू होता है). Bot क्लाइंट कॉन्फ़िगर किए गए मानों को 60-सेकंड आउटबाउंड टेक्स्ट/टाइपिंग अनुरोध गार्ड से नीचे सीमित करते हैं ताकि grammY, OpenClaw के ट्रांसपोर्ट गार्ड और fallback के चलने से पहले दृश्य जवाब डिलीवरी को रोक न दे. Long polling अब भी 45-सेकंड getUpdates अनुरोध गार्ड का उपयोग करता है ताकि निष्क्रिय polls को अनिश्चितकाल तक छोड़ा न जाए.
• channels.telegram.pollingStallThresholdMs का डिफ़ॉल्ट 120000 है; केवल false-positive polling-stall restart के लिए 30000 और 600000 के बीच ट्यून करें.
• समूह संदर्भ इतिहास channels.telegram.historyLimit या messages.groupChat.historyLimit (डिफ़ॉल्ट 50) का उपयोग करता है; 0 अक्षम करता है.
• reply/quote/forward पूरक संदर्भ को एक चुनी हुई बातचीत संदर्भ विंडो में सामान्यीकृत किया जाता है जब Gateway ने parent संदेश देखे हों; observed-message cache OpenClaw SQLite plugin state में रहता है, और openclaw doctor --fix legacy sidecars को आयात करता है. Telegram updates में केवल एक shallow reply_to_message शामिल करता है, इसलिए cache से पुरानी chains Telegram के मौजूदा update payload तक सीमित होती हैं.
• Telegram allowlists मुख्य रूप से यह नियंत्रित करती हैं कि agent को कौन trigger कर सकता है, वे पूर्ण supplemental-context redaction boundary नहीं हैं.
• DM इतिहास नियंत्रण:
  • channels.telegram.dmHistoryLimit
  • channels.telegram.dms["<user_id>"].historyLimit
• channels.telegram.retry config recoverable outbound API errors के लिए Telegram send helpers (CLI/tools/actions) पर लागू होता है. Inbound final-reply delivery भी Telegram pre-connect failures के लिए bounded safe-send retry का उपयोग करती है, लेकिन यह ambiguous post-send network envelopes पर retry नहीं करती, जिनसे visible messages duplicate हो सकते हैं.

CLI और message-tool send targets numeric chat ID, username, या forum topic target हो सकते हैं:

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"

Telegram polls openclaw message poll का उपयोग करते हैं और forum topics को support करते हैं:

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 flags:

• --poll-duration-seconds (5-600)
• --poll-anonymous
• --poll-public
• --thread-id forum topics के लिए (या :topic: target का उपयोग करें)

Telegram send यह भी support करता है:

• --presentation के साथ buttons blocks inline keyboards के लिए, जब channels.telegram.capabilities.inlineButtons इसकी अनुमति देता है
• --pin या --delivery '{"pin":true}' pinned delivery का अनुरोध करने के लिए, जब bot उस chat में pin कर सकता है
• --force-document आउटबाउंड images, GIFs, और videos को compressed photo, animated-media, या video uploads के बजाय documents के रूप में भेजने के लिए

Action gating:

• channels.telegram.actions.sendMessage=false polls सहित outbound Telegram messages को अक्षम करता है
• channels.telegram.actions.poll=false regular sends को enabled रखते हुए Telegram poll creation को अक्षम करता है

Telegram approver DMs में exec approvals को support करता है और वैकल्पिक रूप से originating chat या topic में prompts post कर सकता है. Approvers numeric Telegram user IDs होने चाहिए.

Config path:

• channels.telegram.execApprovals.enabled (जब कम से कम एक approver resolvable हो तो auto-enable होता है)
• channels.telegram.execApprovals.approvers (commands.ownerAllowFrom से numeric owner IDs पर fallback करता है)
• channels.telegram.execApprovals.target: dm (डिफ़ॉल्ट) | channel | both
• agentFilter, sessionFilter

channels.telegram.allowFrom, groupAllowFrom, और defaultTo नियंत्रित करते हैं कि bot से कौन बात कर सकता है और वह सामान्य replies कहां भेजता है. वे किसी को exec approver नहीं बनाते. पहला approved DM pairing commands.ownerAllowFrom को bootstrap करता है जब अभी तक कोई command owner मौजूद नहीं होता, इसलिए one-owner setup अब भी execApprovals.approvers के तहत IDs duplicate किए बिना काम करता है.

Channel delivery chat में command text दिखाती है; channel या both को केवल trusted groups/topics में enable करें. जब prompt किसी forum topic में आता है, OpenClaw approval prompt और follow-up के लिए topic को सुरक्षित रखता है. Exec approvals डिफ़ॉल्ट रूप से 30 मिनट बाद expire हो जाते हैं.

Inline approval buttons के लिए भी channels.telegram.capabilities.inlineButtons का target surface (dm, group, या all) allow करना आवश्यक है. plugin: prefix वाले Approval IDs plugin approvals के माध्यम से resolve होते हैं; अन्य पहले exec approvals के माध्यम से resolve होते हैं.

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

• यदि requireMention=false, तो Telegram privacy mode को full visibility allow करनी चाहिए.
  • BotFather: /setprivacy -> Disable
  • फिर bot को group से हटाकर दोबारा जोड़ें
• जब config unmentioned group messages की अपेक्षा करता है, तो openclaw channels status चेतावनी देता है.
• openclaw channels status --probe explicit numeric group IDs जांच सकता है; wildcard "*" को membership-probe नहीं किया जा सकता.
• quick session test: /activation always.

• जब channels.telegram.groups मौजूद हो, group listed होना चाहिए (या "*" शामिल करें)
• group में bot membership verify करें
• skip reasons के लिए logs देखें: openclaw logs --follow

• अपनी sender identity authorize करें (pairing और/या numeric allowFrom)
• command authorization अब भी लागू होता है, भले ही group policy open हो
• setMyCommands failed के साथ BOT_COMMANDS_TOO_MUCH का मतलब है कि native menu में बहुत अधिक entries हैं; plugin/skill/custom commands घटाएं या native menus disable करें
• deleteMyCommands / setMyCommands startup calls और sendChatAction typing calls bounded हैं और request timeout पर Telegram के transport fallback के माध्यम से एक बार retry करते हैं. Persistent network/fetch errors आमतौर पर api.telegram.org तक DNS/HTTPS reachability issues दिखाते हैं

• getMe returned 401 configured bot token के लिए Telegram authentication failure है.
• BotFather में bot token दोबारा copy या regenerate करें, फिर default account के लिए channels.telegram.botToken, channels.telegram.tokenFile, channels.telegram.accounts.<id>.botToken, या TELEGRAM_BOT_TOKEN update करें.
• Startup के दौरान deleteWebhook 401 Unauthorized भी auth failure है; इसे "no webhook exists" मानना उसी bad-token failure को बाद के API calls तक टाल देगा.

• Node 22+ + custom fetch/proxy immediate abort behavior trigger कर सकता है यदि AbortSignal types mismatch हों.
• कुछ hosts api.telegram.org को पहले IPv6 में resolve करते हैं; broken IPv6 egress intermittent Telegram API failures पैदा कर सकता है.
• यदि logs में TypeError: fetch failed या Network request for 'getUpdates' failed! शामिल हो, तो OpenClaw अब इन्हें recoverable network errors के रूप में retry करता है.
• Polling startup के दौरान, OpenClaw grammY के लिए successful startup getMe probe reuse करता है ताकि runner को पहले getUpdates से पहले दूसरे getMe की जरूरत न पड़े.
• यदि polling startup के दौरान deleteWebhook transient network error के साथ fail होता है, तो OpenClaw दूसरा pre-poll control-plane call करने के बजाय long polling में continue करता है. अब भी active webhook getUpdates conflict के रूप में सामने आता है; फिर OpenClaw Telegram transport rebuild करता है और webhook cleanup retry करता है.
• यदि Telegram sockets छोटे fixed cadence पर recycle होते हैं, तो low channels.telegram.timeoutSeconds जांचें; bot clients configured values को outbound और getUpdates request guards से नीचे clamp करते हैं, लेकिन पुराने releases हर poll या reply abort कर सकते थे जब इसे उन guards से नीचे set किया गया था.
• यदि logs में Polling stall detected शामिल हो, तो OpenClaw डिफ़ॉल्ट रूप से completed long-poll liveness के बिना 120 seconds के बाद polling restart करता है और Telegram transport rebuild करता है.
• openclaw channels status --probe और openclaw doctor चेतावनी देते हैं जब कोई running polling account startup grace के बाद getUpdates complete नहीं कर पाया हो, जब कोई running webhook account startup grace के बाद setWebhook complete नहीं कर पाया हो, या जब last successful polling transport activity stale हो.
• channels.telegram.pollingStallThresholdMs केवल तब बढ़ाएं जब long-running getUpdates calls healthy हों लेकिन आपका host फिर भी false polling-stall restarts report करता हो. Persistent stalls आमतौर पर host और api.telegram.org के बीच proxy, DNS, IPv6, या TLS egress issues की ओर इशारा करते हैं.
• Telegram Bot API transport के लिए process proxy env का भी सम्मान करता है, जिसमें HTTP_PROXY, HTTPS_PROXY, ALL_PROXY, और उनके lowercase variants शामिल हैं. NO_PROXY / no_proxy अब भी api.telegram.org को bypass कर सकते हैं.
• यदि OpenClaw managed proxy service environment के लिए OPENCLAW_PROXY_URL के माध्यम से configured है और कोई standard proxy env मौजूद नहीं है, तो Telegram भी Bot API transport के लिए उस URL का उपयोग करता है.
• unstable direct egress/TLS वाले VPS hosts पर, Telegram API calls को channels.telegram.proxy के माध्यम से route करें:

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 व्यवहार के साथ बेहतर काम करता है, तो family चयन बाध्य करें:

channels:telegram:network:  autoSelectFamily: false

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

channels:telegram:network:  dangerouslyAllowPrivateNetwork: true

• यही opt-in प्रति खाते पर channels.telegram.accounts.<accountId>.network.dangerouslyAllowPrivateNetwork में उपलब्ध है।
• यदि आपका proxy Telegram मीडिया hosts को 198.18.x.x में resolve करता है, तो पहले dangerous flag बंद रखें। Telegram मीडिया पहले से ही RFC 2544 benchmark range को डिफ़ॉल्ट रूप से अनुमति देता है।

• Environment overrides (अस्थायी):
  • OPENCLAW_TELEGRAM_DISABLE_AUTO_SELECT_FAMILY=1
  • OPENCLAW_TELEGRAM_ENABLE_AUTO_SELECT_FAMILY=1
  • OPENCLAW_TELEGRAM_DNS_RESULT_ORDER=ipv4first
• DNS उत्तर validate करें:

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