Overview
Kao supports managing multiple Discord bots from a single account. Run different bots for different servers, share access with team members, or keep a backup bot ready.
Adding Another Bot
- Go to Bots in your dashboard
- Click Add Bot
- Enter the new bot's token
- Kao validates the token and registers the bot
Each bot needs its own Discord application and token. See the Bot System guide for creating a bot.
Bot Dashboard
The Bots page shows all your registered bots:
- Bot name and avatar
- Online/offline status
- Which servers the bot is in
- Quick actions (start, stop, restart)
Bot Status
Monitor your bots in real time:
- Online - Bot is connected and ready
- Offline - Bot is disconnected
- Starting - Bot is connecting
Server Assignment
Each bot can be assigned to specific servers:
- Click on a bot
- Go to the Servers tab
- Assign servers to this bot
- The bot manages emotes only in its assigned servers
Primary Bot
When multiple bots are in the same server, one is marked as primary. The primary bot handles emoji operations for that server.
Bot Presence
Customize what your bot displays as its status:
- Click on a bot
- Go to Presence
- Set the activity type and text
- The bot updates its Discord status
Permission & Intent Checks
Verify your bot is configured correctly:
Recheck Permissions
- Click on a bot
- Click Recheck Permissions
- Kao verifies the bot has the required permissions in all assigned servers
Recheck Intents
- Click on a bot
- Click Recheck Intents
- Kao verifies the bot has the necessary gateway intents enabled in the Discord Developer Portal
Token Management
Updating a Token
If you regenerate a bot's token:
- Go to the bot's settings
- Click Update Token
- Enter the new token
- Kao re-encrypts and stores it
Regenerating a token in Discord invalidates the old one. Update it in Kao immediately or the bot will go offline.
Shared Server Access
Access servers through other users' bots:
- When someone adds their bot to a server you're both in, you may see it in your Shared Servers list
- Shared servers let you browse emojis and perform actions based on your access level
- Access is controlled by the bot owner's server settings
Troubleshooting
Bot Won't Come Online
- Verify the token is correct and hasn't been regenerated
- Check that the bot has the required intents enabled in Discord Developer Portal
- Use Recheck Intents to diagnose
Bot Missing from Server
- Make sure the bot was invited with the correct permissions
- Use the bot invite link from Kao to reinvite with proper permissions
Can't See a Server
- The bot may not be in that server yet
- The server may not be assigned to that bot
- Check shared server access if using another user's bot