Discord - profClaw

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

Capabilities

Feature	Supported
Direct messages	Yes
Server channels	Yes (on mention/command)
Slash commands	Yes
Interactive buttons	Yes
File attachments	Yes
Threads	Yes
Reactions	Yes
OAuth app install	Yes

Setup

Create a Discord Application

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

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)

Under OAuth2 > URL Generator, select scopes:

bot
applications.commands

Select bot permissions:

Send Messages
Read Message History
Use Slash Commands
Add Reactions

Invite the bot

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

Configure profClaw

DISCORD_BOT_TOKEN=...
DISCORD_APPLICATION_ID=...

Environment Variables

string

required

Your Discord bot token from the Developer Portal.

string

required

Your Discord application ID.

string

Application public key for webhook verification (required for HTTP interaction mode).

string

Restrict to a single guild/server. Leave empty for multi-server support.

Configuration Example

.env
settings.yml

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

chat:
  discord:
    bot_token: "${DISCORD_BOT_TOKEN}"
    application_id: "${DISCORD_APPLICATION_ID}"
    guild_id: "${DISCORD_GUILD_ID}"

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.

Chat Providers Overview - Compare all 27 supported channels
Slack - Workspace messaging with Socket Mode
Notifications Tool - Send proactive messages to Discord channels from agents
profclaw channels - Enable and test the Discord connection from the CLI

​Capabilities

​Setup

​Environment Variables

​Configuration Example

​Slash Commands

​Usage Examples

​Notes

​Related

Capabilities

Setup

Environment Variables

Configuration Example

Slash Commands

Usage Examples

Notes

Related