Telegram

OpenWalrus can run agents as Telegram bots. Messages from Telegram are routed through the event loop, and agent responses are streamed back to the chat.

Setup

1. Create a bot

Talk to @BotFather on Telegram and create a new bot. Copy the bot token.

2. Configure

Add the token to walrus.toml:

[channel.telegram]
token = "123456:ABC-DEF..."

3. Start the daemon

walrus daemon

The Telegram bot starts automatically and begins listening for messages.

Message flow

1. User sends a message to the bot on Telegram
2. The teloxide adapter converts it to a DaemonEvent::Message
3. The event loop dispatches it to the target agent
4. Agent responses stream back as Telegram messages

Attachments

The Telegram adapter handles text messages and attachments. Files sent to the bot are forwarded as part of the message context.

What's next

• Discord — set up a Discord bot
• Event loop — how messages flow through the system
• Agents — configure the agent that handles messages