Discord
Discord bot integration guide
Discord Bot
Integrate Overseer with your Discord server for team-based AI assistance with role-based access control.
Important
The Test button in Overseer only checks whether your Discord bot token is valid.
It does not mean all of these are already done:
- the bot was invited to your server
- the Discord worker process is running
- Message Content Intent is enabled
- slash commands were registered
If Test says OK but the bot says nothing in Discord, you still need to finish the setup below.
Setup
Go to Discord Developer Portal and create a new application.
Navigate to the Bot tab and click Add Bot. Copy the token.
Use the OAuth2 URL Generator with bot and applications.commands scopes.
Invite to your server.
In Discord Developer Portal, open the Bot settings and turn on Message Content Intent.
In Overseer, save:
DISCORD_BOT_TOKEN=your-discord-token
DISCORD_CLIENT_ID=your-client-id
DISCORD_ALLOWED_GUILDS=server-id-1,server-id-2pnpm discord:devTest with one of these:
/ask helloor DM the bot directly, or mention the bot in a server channel.
Features
- Server Integration — Works within your Discord server context
- Slash Commands — Native Discord slash command support
- Mention Replies — Mention the bot in a channel to talk to it
- DM Support — Private direct messages also work
- Role-Based Access — Control who can interact with the bot
- Thread Support — Keep conversations organized
- Rich Embeds — Beautiful formatted responses
Troubleshooting
If the bot was invited but still does not answer:
- Make sure the Discord interface is Active
- Make sure Client ID is filled in
- Make sure Allowed Guild IDs includes your server, or leave it empty
- Restart the Discord worker
- Try
/ask hello - Try a DM
- Try mentioning the bot in a server message