Gateway

Gateways connect messaging platforms to OpenWalrus agents. Each platform runs as a separate gateway extension — the daemon spawns it, and it connects back to route messages.

Telegram

1. Create a bot

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

2. Configure

[services.telegram]
kind = "gateway"
crate = "walrus-telegram"
restart = "on_failure"
config = { telegram = { token = "123456:ABC-DEF..." } }

3. Start the daemon

walrus daemon

The daemon spawns the Telegram gateway, which starts the bot automatically.

Message flow

1. User sends a message on Telegram
2. The gateway receives it and forwards to the daemon via the walrus protocol
3. The daemon's event loop dispatches it to the target agent
4. Agent responses stream back through the gateway to the platform

What's next

• Extensions — how extensions and gateways work
• Event loop — how messages flow through the system
• Agents — configure the agent that handles messages