🎯 Connect Clawdbot + Discord (Step‑By‑Step)
Get Clawdbot running inside your Discord server so you can @mention it and get replies.
🤔 What You’ll Get / Why This Matters
- ✅ A Discord bot that shows Online
- ✅ Clawdbot connected to Discord
- ✅ The bot only works in one channel (safe for company servers)
📋 What You Need
- ✅ A Discord account with Manage Server permission (or server owner)
- ✅ Clawdbot installed on your Mac
- ✅ Terminal access on the Mac where Clawdbot runs
🚀 Step 1: Create a Discord App + Bot
1. Open this page:
https://discord.com/developers/applications
2. Click New Application
3. Name it (example): Clawdbot + Moltbot
4. Go to Bot
5. Click Add Bot
🔑 Step 2: Turn On the Right Discord Intent (IMPORTANT)
If this is OFF, your bot can look online but won’t read messages.
1. Developer Portal → Bot
2. Scroll to Privileged Gateway Intents
3. Turn ON:
- ✅ Message Content Intent
4. Click Save Changes
🔐 Step 3: Copy Your Bot Token
1. Developer Portal → Bot
2. Click Reset Token
3. Click Copy
⚠️ Important: Treat this token like a password. Don’t paste it in public chats.
🔗 Step 4: Create an Invite Link (Install Link)
1. Developer Portal → Installation
2. Under Installation Contexts enable:
- ✅ Guild Install
3. Under Default Install Settings → Guild Install set:
Scopes (required):
- ✅ bot
- ✅ applications.commands
Permissions (minimum):
- ✅ View Channels
- ✅ Send Messages
- ✅ Read Message History
- ✅ (Optional) Send Messages in Threads
4. Copy the Discord Provided Link
5. Open it in your browser
6. Choose your server → click Authorize
🔒 Step 5: Lock the Bot to One Channel (Recommended)
This is the safest way for a company server.
1. In Discord, create a channel:
- `#clawdbot`
2. Right‑click `#clawdbot` → Edit Channel
3. Go to Permissions
4. Add the bot user/role
5. Allow:
- ✅ View Channel
- ✅ Read Message History
- ✅ Send Messages
6. Make sure the bot does NOT have View Channel in other channels.
🧠 Step 6: Add Discord to Clawdbot
On your Mac:
1. Run:
clawdbot configure
2. Choose:
- Local (this machine)
- Discord
3. Paste the Bot Token when asked
4. Set policy to Allowlist (recommended)
🔄 Step 7: Restart Clawdbot
Run:
clawdbot gateway restart
clawdbot status –all
✅ You should see:
- Discord: ON / OK
💬 Step 8: Test It
In your Discord `#clawdbot` channel, type:
@Clawdbot + Moltbot hello
✅ If everything is correct, it replies.
❓ Common Problems
Problem: Bot is online but doesn’t reply
- ✅ Turn ON Message Content Intent (Step 2)
- ✅ Check channel permissions (Step 5)
Problem: My server doesn’t show in the invite dropdown
- You need Manage Server permission (or owner)
- Make sure you’re logged into the right Discord account
Problem: Clawdbot says “port already in use”
- You might have an older gateway running.
- Restart with:
clawdbot gateway restart
🎉 You Did It!
You now have Clawdbot running in Discord.
Next: tell me what you want it to do in Discord (Q&A, posting updates, tools, reminders, etc.).