Telegram
Connect Pandora to Telegram via a personal bot that responds only to you.
Create a bot
Open BotFather in Telegram and run /newbot. Follow the prompts to choose a name and username. BotFather will give you a bot token — a string like 123456789:ABCdef....
Get your user ID
Send a message to @userinfobot . It will reply with your numeric user ID (e.g. 123456789). We use this to make sure your bot will only respond to you.
Set the environment variable
Add TELEGRAM_BOT_TOKEN to your environment:
TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZEnable in the Plugins page
Open Pandora’s web UI, go to Plugins, find Telegram. Enter your Owner ID from step 2, and toggle on to start the channel.
Bot Commands
| Command | Description |
|---|---|
/start | Start the bot and begin a new conversation |
/new | Start a fresh conversation |
Both commands create a new conversation thread.
Owner-only access — The Telegram bot only responds to the Owner ID configured in settings. Messages from other users are rejected with “Sorry, this bot is private.”
Tool Approvals
When a tool requires confirmation before running, the bot sends an inline keyboard with Approve and Deny buttons. Tap one to continue or cancel the tool call.
Notifications
When Pandora needs to notify you (e.g. scheduled task results, inbox items), the Telegram channel delivers messages directly to the Owner ID.
Configuration
| Variable | Required | Description |
|---|---|---|
TELEGRAM_BOT_TOKEN | Yes | Bot token from BotFather |
| Setting | Required | Description |
|---|---|---|
| Owner ID | Yes | Your Telegram user ID. Only this user can interact with the bot. |
Troubleshooting
- Bot doesn’t respond — Check that
TELEGRAM_BOT_TOKENis set and Pandora is running. The token must match the bot you created with BotFather. - “Sorry, this bot is private” — You’re sending from a different Telegram account than the Owner ID. Verify your user ID with @userinfobot .
- Plugin shows but won’t start — The plugin always appears in the Plugins page, but the channel only starts when
TELEGRAM_BOT_TOKENis set. Restart Pandora after adding the variable. - Messages cut off — Telegram has a 4096-character limit per message. Pandora automatically splits long responses into multiple messages.