Discord

OpenWalrus can run agents as Discord bots, bound to a specific guild and channel.

Setup

1. Create a bot

1. Go to the Discord Developer Portal
2. Create a new application
3. Go to Bot settings and create a bot
4. Copy the bot token
5. Enable the Message Content Intent under Privileged Gateway Intents
6. Invite the bot to your server with appropriate permissions

2. Get IDs

Enable Developer Mode in Discord (Settings → Advanced → Developer Mode). Right-click your server to copy the Guild ID, and right-click the channel to copy the Channel ID.

3. Configure

Add the credentials to walrus.toml:

[channel.discord]
token = "your-bot-token"
guild_id = "123456789"
channel_id = "987654321"

4. Start the daemon

walrus daemon

The Discord bot connects and listens in the specified channel.

Message flow

1. User sends a message in the bound Discord channel
2. The serenity adapter converts it to a DaemonEvent::Message
3. The event loop dispatches it to the target agent
4. Agent responses are posted back to the channel

What's next

• Telegram — set up a Telegram bot
• Event loop — how messages flow through the system
• Configuration — full config reference