Discord Bot Permissions Explained

Understanding Discord Permissions

Discord uses two permission systems for bots:

1. Bot Permissions - What the bot can do in servers
2. Gateway Intents - What data the bot can access

Both must be configured correctly for your AI chatbot to work.

Essential Permissions for AI Bots

Minimum Required

| Permission | Why Needed | |------------|------------| | View Channels | See channels to respond in | | Send Messages | Reply to users | | Read Message History | Context for conversations |

Recommended Additional

| Permission | Why Needed | |------------|------------| | Embed Links | Rich formatted responses | | Attach Files | Send images/files | | Use Slash Commands | Modern command interface | | Add Reactions | React to messages |

Permission Configuration

Method 1: OAuth2 URL Generator

1. Go to Discord Developer Portal
2. Select your application
3. Navigate to OAuth2 → URL Generator
4. Select scopes: bot, applications.commands
5. Select permissions (see below)
6. Copy generated URL

Recommended Permission Integer

For most AI bots: 274878024704

This includes:

• View Channels
• Send Messages
• Send Messages in Threads
• Embed Links
• Attach Files
• Read Message History
• Use Slash Commands

Permission Calculator

You can use tools like Discord Permission Calculator to generate custom permission integers.

All Bot Permissions Explained

General Permissions

| Permission | Description | AI Bot Need? | |------------|-------------|--------------| | Administrator | Full access to everything | No (risky) | | View Audit Log | See moderation history | No | | View Server Insights | See analytics | No | | Manage Server | Edit server settings | No | | Manage Roles | Create/edit roles | No | | Manage Channels | Create/edit channels | No |

Membership Permissions

| Permission | Description | AI Bot Need? | |------------|-------------|--------------| | Create Invite | Generate invite links | No | | Change Nickname | Change own nickname | Optional | | Manage Nicknames | Change others' nicknames | No | | Kick Members | Remove members | No | | Ban Members | Ban members | No | | Moderate Members | Timeout members | No |

Text Permissions

| Permission | Description | AI Bot Need? | |------------|-------------|--------------| | Send Messages | Send messages | Yes | | Send Messages in Threads | Reply in threads | Yes | | Create Public Threads | Start threads | Optional | | Create Private Threads | Start private threads | No | | Embed Links | Send rich embeds | Yes | | Attach Files | Upload files | Recommended | | Add Reactions | React to messages | Optional | | Use External Emojis | Use emojis from other servers | Optional | | Mention Everyone | @everyone and @here | No | | Manage Messages | Delete/pin messages | Optional | | Manage Threads | Manage thread settings | No | | Read Message History | See past messages | Yes | | Send TTS Messages | Text-to-speech | No |

Voice Permissions

| Permission | Description | AI Bot Need? | |------------|-------------|--------------| | Connect | Join voice channels | No | | Speak | Talk in voice | No | | Video | Stream video | No | | Use Voice Activity | Speak without PTT | No |

Gateway Intents

Intents control what events your bot receives.

Standard Intents (No Approval Needed)

| Intent | Description | |--------|-------------| | Guilds | Server info | | Guild Messages | Messages in servers | | Direct Messages | DM messages |

Privileged Intents (Must Enable in Portal)

| Intent | Description | AI Bot Need? | |--------|-------------|--------------| | Presence Intent | User online status | Optional | | Server Members Intent | Member join/leave | Optional | | Message Content Intent | Read message text | Yes |

Critical: Message Content Intent is required for AI bots to read messages.

Enabling Privileged Intents

1. Go to Discord Developer Portal
2. Select your application
3. Go to Bot section
4. Under Privileged Gateway Intents:
   • Toggle ON Message Content Intent
   • Toggle ON others if needed
5. Save changes

Code Configuration

Discord.js Example

const { Client, GatewayIntentBits } = require('discord.js');

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent,  // Required for AI bots
    GatewayIntentBits.DirectMessages,
  ]
});

Environment Variables

# Some bots configure intents via .env
DISCORD_INTENTS=Guilds,GuildMessages,MessageContent,DirectMessages

Permission Troubleshooting

"Missing Permissions" Error

1. Re-invite bot with correct permissions URL
2. Check server-specific role permissions
3. Verify channel permission overrides

Bot Can't See Messages

1. Enable Message Content Intent in Developer Portal
2. Add intent in bot code
3. Restart bot

Bot Can't Send Messages

1. Check "Send Messages" permission
2. Verify channel-specific overrides
3. Check if bot role is lower than restriction roles

Bot Can't Use Slash Commands

1. Add applications.commands scope when inviting
2. Wait up to an hour for global commands to register
3. Check if commands are registered: client.application.commands.fetch()

Permission Hierarchy

Discord permissions follow hierarchy:

1. Server Owner - Always has all permissions
2. Administrator - Bypasses all permission checks
3. Role Position - Higher roles override lower
4. Channel Overrides - Can override server permissions

Your bot's role position affects what it can do.

Security Best Practices

Do's

• Request minimum necessary permissions
• Use slash commands instead of message prefix
• Document why each permission is needed

Don'ts

• Don't request Administrator
• Don't ask for Kick/Ban unless needed
• Don't request Manage Messages unnecessarily

Permission Sets by Use Case

Basic AI Chatbot

274877975552

• View Channels, Send Messages, Embed Links, Read Message History

Full-Featured AI Bot

274878024704

• Above + Attach Files, Slash Commands, Send in Threads

Moderation-Capable Bot

1374389936182

• Above + Manage Messages, Moderate Members

Related Guides

• OpenClaw Discord setup
• OpenClaw Discord integration
• Discord connection issues

Need Help?

Our setup service configures all permissions correctly for your AI bot.