Telegram Bot Errors

Solutions for Telegram bot errors with AI agents: 429 rate limits, webhook failures, session splits, silent hangs, and dual response bugs.

30 solutions in this category

• CLI handshake timeout (3s) too short — causes silent 1000 close on loaded gateways
  The CLI WebSocket handshake timeout is hardcoded to 3 seconds (DEFAULT_HANDSHAKE_TIMEOUT_MS = 3e3 in gateway-cli-*.js...
• Docker: Matrix plugin fails to load with 'Cannot find module '@vector -im/matrix-bot-sdk'' (Require stack: /app/dist/matrix-*.js) — persistent even after cleanup/rebuild
  Regression (worked before, now
• Exec approval completion events lose forum topic context in Telegram forum supergroups
  When exec approvals are configured for Telegram with , the approval prompt itself routes correctly to the user's DM w...
• Feature Request: Cross-channel real-time session mirroring for WebChat
  When webchat and Telegram (or any other channel) share the same session (), replies only route to the originating cha...
• Feature Request: Shared session context between group chats and DMs
  Currently, group chats and DMs always have isolated sessions ( vs ). There is no way to share conversation context be...
• Feature request: read-only allowlist / suppress auto-reply for WhatsApp DMs
  When using WhatsApp with , adding a phone number to makes that contact a full conversational partner. Every agent rep...
• Gateway crash-loops on single unresolvable bot token — should gracefully degrade
  Gateway crashes entirely when a single Telegram bot token cannot be resolved from env vars, taking down all other wor...
• Heartbeat drift fix (PR #39182) causes aggressive retry that blocks Telegram during active conversations
  After upgrading to 2026.3.7, heartbeats now consistently block Telegram message handling during active conversations....
• I Replaced $100+/month in GEMINI API Costs with a €2000 eBay Mac Studio — Here is my Local, Self-Hosted AI Agent System Running Qwen 3.5 35B at 60 Tokens/Sec (The Full Stack Breakdown)
  TL;DR: self-hosted "Trinity" system — three AI agents (Lucy, Neo, Eli) coordinating through a single Telegram chat, p...
• Media download fails when Telegram proxy is configured (SSRF guard overrides proxy dispatcher)
  When a Telegram proxy is configured via , media downloads (voice messages, images, files) fail
• Multi-account Telegram: bot.on('message') does not fire for group messages on non-default account
  Behavior bug (incorrect output/state without
• NO_REPLY leaks to user during pre-compaction memory flush
  Isolated cron jobs with delivery mode "announce" deliver NO_REPLY as a visible message to the user instead of suppres...
• Telegram bots freeze periodically due to NAT timeout silently dropping idle getUpdates TCP connections
  Telegram bots in OpenClaw periodically stop responding for ~15–90 seconds because the long-polling () TCP connection ...
• Telegram channel cannot send images via read tool
  When using the tool to read an image file and trying to send it through Telegram channel, the image is not delivered ...
• Telegram channel config hot-reload unloads launchd service, killing gateway
  Editing a Telegram group's config (e.g., ) triggers a config hot-reload that restarts the Telegram channel. This rest...
• Telegram channel plugin: --channels flag stalls SSH terminal session
  - Claude Code version:
• Telegram channel plugin: Desktop app zombie processes steal bot polling, MCP server fails
  - [x] I have searched existing issues and this hasn't been reported
• Telegram direct session can stay pinned to oversized stale session; /new does not reliably cut over
  Telegram direct chats can get stuck showing with no final reply when the direct-session mapping remains attached to a...
• Telegram exec approval button callbacks silently dropped when execApprovals not set on channel config
  Exec approval buttons render correctly in Telegram DM but pressing them has no effect. The approval times out after 1...
• Telegram multi-account exec approval resolution fails with 'unknown or expired approval id' on non-default accounts
  Exec approval prompts are delivered correctly to non-default Telegram bot accounts, but resolving approvals (clicking...
• Telegram plugin crashes with 409 error due to orphaned polling processes on session restart
  The Telegram channel plugin (grammy-based long polling) crashes with a 409 Conflict error when a new Claude Code sess...
• Telegram typing keepalive loop lacks circuit breaker, causes gateway crash on network failure
  When the Telegram API becomes unreachable (network blip, DNS timeout, etc.), the typing indicator keepalive loop ( in...
• Telegram webhook unreachable when gateway.tailscale.mode=funnel (port mismatch)
  When is enabled alongside Telegram webhook mode ( set), inbound webhook requests from Telegram fail with 405 Method Not
• Telegram webhook→polling transition causes persistent 409 conflicts
  Switching Telegram from webhook to polling mode causes continuous 409 Conflict errors. Even after deleting webhook vi...
• [Feature]: Re-inject Telegram DM session history after context compaction
  After context compaction fires on a Telegram DM session, the recent conversation history is completely lost. The agen...
• commands.native: 'auto' with many skills causes BOT_COMMANDS_TOO_MUCH crash loop on Telegram
  When is set to and a large number of skills are installed (60+), the gateway attempts to register all skills as nativ...
• feat(memory): graduate sessionMemory from experimental — solve the multi-session continuity problem
  When a user talks to their agent on webchat and switches to Telegram, the agent on Telegram has no knowledge of the w...
• fix(telegram): missing setStatus integration prevents health monitoring
  The Telegram provider lacks integration, causing and timestamps to remain even when messages are actively received. T...
• getUpdates conflict (409) persists even with fresh bot token and health monitor disabled
  Behavior bug (incorrect output/state without
• sessions.json sessionId/sessionFile null for heartbeat-origin sessions
  Sessions initialized via do not write or back to . This causes to return empty despite real transcript content existi...