Telegram Messaging

Send messages to Telegram using the Bot API. The plugin provides both manual (/telegram) and automatic session notifications.

Quick Start

/telegram Your message here

Credentials

Set two environment variables (add to ~/.bashrc or ~/.zshrc for persistence):

export TELEGRAM_BOT_TOKEN="your-bot-token"   # from @BotFather
export TELEGRAM_CHAT_ID="your-chat-id"       # from @userinfobot

Configuration

Create .claude/telegram.local.md (project) or ~/.claude/telegram.local.md (global):

---
enabled: true
session_threshold_minutes: 10
---

Your custom notification message here

See examples/telegram.local.md.example for a working config template.

Plugin Behavior

Opt-in design: The plugin only validates credentials and sends automatic notifications when .claude/telegram.local.md exists with enabled: true.

Manual command: The /telegram command works anytime if credentials are set, regardless of the config file.

Resources

• Full documentation: README.md (at plugins/telegram/README.md)
• Configuration details: references/configuration.md
• Troubleshooting: references/troubleshooting.md