fbpx

๐ŸŽฏ 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.).