OpenClaw + Discord Integration: Complete Setup Guide

# Recommended bot permissions for an OpenClaw agent:
Send Messages          # Reply to users
Read Message History   # Access conversation context
View Channels          # See which channels exist
Embed Links            # Format responses with rich embeds
Attach Files           # Send files (reports, charts)
Add Reactions          # React to messages for acknowledgment
Use Slash Commands     # If registering slash commands later

# Permission integer: 277025770560
# Full invite URL format:
https://discord.com/api/oauth2/authorize?client_id=YOUR_APP_ID&permissions=277025770560&scope=bot

# Required: Bot token from the Developer Portal
openclaw config set channels.discord.bottoken YOUR_TOKEN

# Optional: Respond only when @mentioned (recommended for busy servers)
openclaw config set channels.discord.mentionOnly true

# Optional: Restrict the bot to specific channel IDs
openclaw config set channels.discord.allowedChannels '["123456789012345678", "987654321098765432"]'

# Optional: Set a custom status message
openclaw config set channels.discord.status "Ready to help"

# Optional: Use embeds for formatted responses
openclaw config set channels.discord.useEmbeds true

# Start or restart the gateway to apply changes
openclaw gateway restart

# Check gateway logs for Discord connection
openclaw gateway logs | grep discord

# Expected output:
# [channel:discord] connected as BotName#1234
# [channel:discord] listening in 3 servers, 12 channels

# Enable automatic reconnection (enabled by default)
openclaw config set channels.discord.autoReconnect true

# Delay before first reconnect attempt (milliseconds)
openclaw config set channels.discord.reconnectDelay 5000

# Maximum reconnect attempts before giving up
openclaw config set channels.discord.maxReconnectAttempts 10

# Exponential backoff multiplier (each retry waits longer)
openclaw config set channels.discord.backoffMultiplier 1.5

# Resume missed events after reconnection
openclaw config set channels.discord.resumeEvents true

# Install pm2 globally
npm install -g pm2

# Start the OpenClaw gateway with pm2
pm2 start "openclaw gateway start" --name openclaw-discord

# Configure pm2 to restart on crash
pm2 set openclaw-discord:restart_delay 10000
pm2 set openclaw-discord:max_restarts 50

# Save the pm2 process list so it survives reboots
pm2 save
pm2 startup

# Allow the bot in all servers but restrict to specific channels
openclaw config set channels.discord.allowedChannels '[
  "111111111111111111",
  "222222222222222222",
  "333333333333333333"
]'

# Or use server-specific configurations (advanced)
# Create a discord-servers.json in your agent directory:
{
  "servers": {
    "SERVER_ID_1": {
      "allowedChannels": ["111111111111111111"],
      "mentionOnly": false
    },
    "SERVER_ID_2": {
      "allowedChannels": ["222222222222222222", "333333333333333333"],
      "mentionOnly": true
    }
  }
}

# Reference it in config
openclaw config set channels.discord.serverConfig "./discord-servers.json"

# Agent 1: Community support bot for public server
cd ~/agents/support-bot
openclaw config set channels.discord.bottoken SUPPORT_BOT_TOKEN
openclaw gateway start --port 18790

# Agent 2: Internal team assistant for private server
cd ~/agents/team-assistant
openclaw config set channels.discord.bottoken TEAM_BOT_TOKEN
openclaw gateway start --port 18791

# Both agents run simultaneously on different ports

#!/bin/bash
# discord-health-check.sh
# Run this on a cron schedule: */5 * * * * /path/to/discord-health-check.sh

GATEWAY_STATUS=$(openclaw gateway status 2>&1)
DISCORD_STATUS=$(openclaw gateway logs --lines 20 | grep -c "discord.*connected")

if echo "$GATEWAY_STATUS" | grep -q "stopped"; then
  echo "Gateway is down, restarting..."
  openclaw gateway start
  # Optional: send alert to Telegram
  curl -s "https://api.telegram.org/botYOUR_TG_TOKEN/sendMessage" \
    -d "chat_id=YOUR_CHAT_ID" \
    -d "text=OpenClaw Discord bot restarted (gateway was stopped)"
fi

if [ "$DISCORD_STATUS" -eq 0 ]; then
  echo "Discord channel not connected, restarting gateway..."
  openclaw gateway restart
  curl -s "https://api.telegram.org/botYOUR_TG_TOKEN/sendMessage" \
    -d "chat_id=YOUR_CHAT_ID" \
    -d "text=OpenClaw Discord bot reconnected (channel was disconnected)"
fi

# Monitor with pm2
pm2 monit

# Check specific metrics
pm2 show openclaw-discord

# View real-time logs
pm2 logs openclaw-discord --lines 50

# Set up pm2 alerts (requires pm2-logrotate module)
pm2 install pm2-logrotate
pm2 set pm2-logrotate:max_size 10M
pm2 set pm2-logrotate:retain 7

# 1. Create Discord application and bot
#    discord.com/developers/applications > New Application > Bot > Add Bot

# 2. Enable Message Content Intent
#    Bot settings > Privileged Gateway Intents > Message Content Intent: ON

# 3. Generate invite URL and add bot to server
#    OAuth2 > URL Generator > scope: bot > permissions: 277025770560

# 4. Configure OpenClaw with bot token
openclaw config set channels.discord.bottoken YOUR_TOKEN

# 5. Set optional preferences
openclaw config set channels.discord.mentionOnly true
openclaw config set channels.discord.useEmbeds true

# 6. Start or restart the gateway
openclaw gateway restart

# 7. Verify connection
openclaw gateway logs | grep "discord.*connected"

# 8. Test by sending a message in Discord
#    @YourBot hello, are you working?

# 9. Set up monitoring (optional but recommended)
#    crontab -e > add health check script every 5 minutes

# 10. Configure pm2 for production uptime
pm2 start "openclaw gateway start" --name openclaw-discord
pm2 save && pm2 startup