Skip to main content
profClaw’s Discord integration registers as a bot on your server and responds to slash commands, direct messages, and @mentions.

​
Capabilities

FeatureSupported
Direct messagesYes
Server channelsYes (on mention/command)
Slash commandsYes
Interactive buttonsYes
File attachmentsYes
ThreadsYes
ReactionsYes
OAuth app installYes

​
Setup

1

Create a Discord Application

Go to discord.com/developers and create a new application.
2

Create a Bot

Under Bot, click Add Bot. Copy the bot token.Enable these Privileged Gateway Intents:
  • Message Content Intent (required to read messages)
  • Server Members Intent (optional, for member lookup)
3

Register Slash Commands

Under OAuth2 > URL Generator, select scopes:
  • bot
  • applications.commands
Select bot permissions:
  • Send Messages
  • Read Message History
  • Use Slash Commands
  • Add Reactions
4

Invite the bot

Use the generated OAuth2 URL to invite the bot to your server.
5

Configure profClaw

DISCORD_BOT_TOKEN=...
DISCORD_APPLICATION_ID=...

​
Environment Variables

​
DISCORD_BOT_TOKEN
string
required
Your Discord bot token from the Developer Portal.
​
DISCORD_APPLICATION_ID
string
required
Your Discord application ID.
​
DISCORD_PUBLIC_KEY
string
Application public key for webhook verification (required for HTTP interaction mode).
​
DISCORD_GUILD_ID
string
Restrict to a single guild/server. Leave empty for multi-server support.

​
Configuration Example

DISCORD_BOT_TOKEN=MTI...
DISCORD_APPLICATION_ID=1234567890
# Optional: single-server mode
DISCORD_GUILD_ID=9876543210

​
Slash Commands

profClaw registers these slash commands automatically: 
/ask [question]     - Ask a question
/run [skill]        - Run a skill
/status             - Agent status

​
Usage Examples

# In any channel
@profclaw Review the last 5 commits

# Slash command
/ask What is the status of deployment #42?

# DM the bot directly
Any message in DMs is treated as a question

​
Notes

  • Bot connects via Discord’s Gateway (WebSocket) for real-time events - no public webhook URL needed.
  • For large servers, use DISCORD_GUILD_ID to scope the bot to one server for faster slash command registration.
  • Global slash command registration can take up to 1 hour to propagate; guild-scoped commands are instant.
  • Multi-server support works without additional configuration.