Discord

The Fastest Way: HeraClaw Cloud ⚡

Skip the Discord bot setup, token management, and permission configuration. HeraClaw Cloud comes with Discord integration pre-configured and ready to use in 60 seconds.

Why HeraClaw Cloud for Discord?

✅ Ready in 60 seconds - No bot creation, no OAuth setup, no permission confusion ✅ Pre-configured bot - Works immediately after server authorization ✅ Always updated - We handle Discord API changes and gateway updates automatically ✅ Professional support - If anything breaks, we fix it for you ✅ Secure by default - Enterprise-grade security, message encryption, SOC 2 compliant ✅ Zero maintenance - No server management, no uptime monitoring, no debugging

How it works:

1. Sign up at cloud.getopenclaw.ai (takes 60 seconds)
2. Go to Integrations → Discord
3. Click 'Connect to Discord'
4. Authorize our bot for your server
5. Done! Start using your AI assistant in Discord

Get Started: Start with HeraClaw Cloud →

Complete Guide to OpenClaw + Discord

Discord has evolved from a gaming platform into the go-to communication hub for communities of all kinds. With over 150 million monthly active users across gaming, education, crypto, tech, and creative communities, Discord represents a unique opportunity for AI assistance. OpenClaw's Discord integration brings intelligent help directly into your community's conversations, making AI accessible exactly where your members spend their time.

Whether you're managing a 50-person friend group or a 500,000-member crypto community, this integration transforms how your server members access information, get support, and collaborate. No separate apps, no context switching - just mention your assistant and get instant, intelligent responses.

Why Use Discord with OpenClaw?

Discord's architecture is uniquely suited for AI assistants. Here's why the OpenClaw + Discord combination creates exceptional value:

1. Server and Channel Structure for Perfect Context Control

Discord's hierarchical organization gives you surgical precision in deploying AI:

• Server-level deployment: One bot serves your entire Discord server
• Category-based permissions: Enable AI only in specific channel categories (Support, General, Tech Help)
• Channel-specific access: Restrict to individual channels like #ai-help or #bot-commands
• Role-based permissions: Only users with certain roles (Moderators, Premium Members, Level 10+) can interact
• Private channel support: Works in private/hidden channels with full context awareness
• DM privacy: One-on-one conversations for sensitive questions
• Thread support: Deep-dive conversations without cluttering main channels
• Forum channel integration: AI can respond to forum posts and threads

This makes Discord perfect for communities where you want tiered access. Free members get basic AI help, premium members get advanced features, moderators get admin tools.

2. @Mention and Prefix Command Systems

Discord offers multiple ways to interact with your AI assistant:

@Mention approach (familiar to all users):

@OpenClaw what's the best GPU for gaming under $500?@OpenClaw explain blockchain like I'm 5@OpenClaw summarize the last 50 messages

Prefix commands (power user favorite):

!ask what's the server's privacy policy?!help getting-started!search previous announcements about NFT drops

Slash commands (Discord's native system):

/ask question: How do I verify my wallet?/brief type: daily/search query: moderator applications

Your community can use whichever feels most natural. Most communities enable all three.

3. Rich Embeds for Beautiful Responses

Discord's embed system makes AI responses visually stunning:

• Colored embeds: Different colors for different response types (blue for info, red for errors, green for success)
• Embedded images: Charts, graphs, diagrams rendered inline
• Thumbnail and full images: Visual aids for explanations
• Fields and sections: Organized information in neat boxes
• Footer metadata: Timestamps, model used, response confidence
• Author section: Shows which user asked the question
• Hyperlinks: Clickable links to documentation, resources, related content
• Inline code and code blocks: Syntax-highlighted code snippets

Compare a plain text response to a beautiful embed - engagement goes up 300%+.

4. Voice Channel Integration

Unique to Discord: AI can participate in voice channels:

• Voice transcription: Convert voice channel speech to text for AI processing
• Text-to-speech responses: AI can speak answers in voice channels
• Music bot integration: "Play some focus music" → AI starts lo-fi playlist
• Voice activity logging: "Summarize what was discussed in voice tonight"
• Moderation support: "Alert me if anyone says banned words in voice"

Perfect for study groups, gaming sessions, or watch parties where typing is inconvenient.

5. Reaction-Based Interactions

Discord's reaction system enables unique AI workflows:

• React with ✅ to approve: Approval workflows for suggestions
• React with ❌ to dismiss: Quick feedback without typing
• React with 📌 to save: AI automatically saves important messages
• React with 🔁 to regenerate: Get alternative AI responses
• React with 📊 for details: Expand brief answers into detailed explanations
• Reaction menus: Navigate multi-page responses with ⬅️ ➡️ arrows

This creates intuitive, no-typing workflows for mobile users.

6. Server Boosting and Premium Perks

Integrate AI features with Discord's Nitro and Server Boost system:

• Boosted servers get advanced AI: More queries per day, faster models, longer context
• Nitro users get priority: Their questions jump the queue
• Premium-only channels: AI access as a membership perk
• Custom AI personalities: Boosted servers can customize the bot's personality

This creates monetization opportunities for community owners.

7. Webhook and Automation Integration

Discord webhooks enable powerful automation:

• GitHub integration: "@OpenClaw explain this PR" (reads linked GitHub PR)
• Twitter alerts: AI summarizes trending tweets in your niche
• Calendar sync: "What events are scheduled this week?"
• Moderation logs: AI analyzes mod actions and suggests policy improvements
• Analytics: "How many messages were sent today?" → Queries Discord analytics

Your AI becomes the central nervous system for all your community's tools.

8. Stage Channels and Events

For large community events:

• Stage channel Q&A: Audience members ask questions, AI provides instant answers during presentations
• Event scheduling: "When is the next AMA?" → Checks Discord Events
• Event reminders: AI sends reminders before scheduled events
• Post-event summaries: "Summarize tonight's debate" → Full transcript summary

Perfect for educational communities, crypto projects with AMAs, and tech conferences.

Real-World Use Cases

1. Gaming Community Support (10,000+ Members)

Scenario: You run a gaming community for an MMO with 15,000 Discord members. New players constantly ask the same questions: "How do I craft weapons?" "Where's the best farming spot?" "What class should I play?" Your moderators are burned out answering repetitive questions.

How OpenClaw helps:

Deploy the AI in #new-player-help and #general-questions:

• Game mechanics: "@OpenClaw how does the trading system work?" → Pulls from your wiki and responds with step-by-step guide
• Build recommendations: "What's the best DPS build for raids?" → Current meta builds with explanations
• Quest help: "I'm stuck on the Dragon's Lair quest" → Walkthrough with tips
• Server rules: "Can I sell in-game items for real money?" → Quotes your ToS
• LFG coordination: "@OpenClaw I'm looking for a raid group" → Checks #looking-for-group and suggests active recruiters
• Event schedules: "When's the next guild raid?" → Checks pinned calendar

Advanced features:

• Build calculator integration: Upload your character stats screenshot, AI suggests optimal gear
• DPS meter analysis: Upload combat log, AI identifies performance improvements
• Loot distribution: "We got [Epic Sword], who needs it?" → Checks member gear and suggests fair distribution

Impact:

• Moderators save 20+ hours/week on repetitive questions
• New player retention increases 40% (they get instant help)
• Server activity up 25% (members engage more when help is instant)
• Premium subscriptions increase (AI access as a perk)

2. Crypto/NFT Project Community

Scenario: You've launched an NFT project with a 50,000-member Discord. Holders ask about roadmap, utility, marketplace listings, and token economics. Your team is in multiple timezones, and questions go unanswered for hours.

How OpenClaw helps:

Connect to your project's data sources:

• Floor price queries: "What's the floor price?" → Checks OpenSea API and responds with current data + 24h trend
• Roadmap questions: "When is staking launching?" → Pulls from your public roadmap
• Holder verification: Integrates with wallet verification bots to provide holder-only answers
• Marketplace links: "Show me rare traits" → Links to OpenSea with filters applied
• Tokenomics: "How does the token burn work?" → Explains from whitepaper
• Proposal voting: "What proposals are active?" → Lists DAO proposals with voting links

Advanced features:

• Whale alerts: AI announces large purchases/sales in #whale-watch
• Trait rarity: Upload NFT image, AI identifies traits and rarity rank
• Portfolio analysis: "@OpenClaw analyze my wallet 0x123..." → Holdings summary, profit/loss
• Scam detection: AI monitors #general for scam links and warns users

Impact:

• Support response time drops from 4 hours to 30 seconds
• Holder satisfaction increases (measured via sentiment analysis)
• Moderator burnout decreases (no more "wen moon" repetition)
• Scam links caught 90% faster

3. Educational Community/Study Group

Scenario: You run a Discord for computer science students (2,000 members). Students collaborate on homework, study for exams, and share resources. They need help debugging code, understanding concepts, and finding study materials.

How OpenClaw helps:

Deploy AI in #homework-help, #study-group, and #code-review:

• Concept explanations: "@OpenClaw explain binary search trees" → Clear explanation with examples
• Code debugging: Paste code snippet, "Why is this throwing an error?" → AI identifies bug and suggests fix
• Study resources: "Best resources for learning React?" → Curated list from your community's knowledge base
• Exam prep: "Generate 10 practice questions on Big O notation" → Quiz with answers
• Homework hints: "I'm stuck on problem 3" → Hints without giving away full solution (configurable strictness)
• Code review: "Review my JavaScript function" → Style feedback, efficiency suggestions, bug detection

Advanced features:

• Study group scheduling: "Find me a study partner for algorithms" → Checks member availability
• Assignment tracking: "When is the OS project due?" → Checks course calendar
• Resource repository: AI maintains searchable database of shared study materials
• Plagiarism prevention: AI configured to provide guidance, not complete solutions

Impact:

• Students get unstuck faster (less frustration, more learning)
• Peer learning increases (AI encourages collaboration)
• Study group participation up 60%
• Course completion rates improve

4. Tech Support and SaaS Community

Scenario: Your SaaS product has a 5,000-member Discord for customer support and feedback. Customers ask about features, report bugs, and request integrations. Your support team (3 people) is overwhelmed.

How OpenClaw helps:

Integrate with your knowledge base, ticketing system, and status page:

• Product questions: "Does your app integrate with Zapier?" → Pulls from documentation
• Troubleshooting: "I'm getting error 403" → Checks error database, provides fix
• Feature requests: "Can you add dark mode?" → Checks roadmap, creates ticket if new
• System status: "Is the API down?" → Checks status page and recent incidents
• Pricing: "How much for the Pro plan?" → Current pricing with comparison table
• Account issues: "I can't log in" → Password reset guide, escalates to support if needed

Advanced features:

• Smart ticket creation: If AI can't solve issue, automatically creates support ticket with full context
• Bug report parsing: "Submit bug: login button not working on mobile" → Structured bug report in your system
• Feature voting: "Upvote dark mode request" → Increments vote count in feedback tool
• Customer context: AI knows user's plan tier and customizes responses

Impact:

• Support ticket volume drops 50% (AI resolves common issues)
• First response time: <1 minute (was 30+ minutes)
• Customer satisfaction up 35%
• Support team focuses on complex issues only

5. Open Source Project Community

Scenario: You maintain a popular open source library with an 8,000-member Discord. Contributors ask about architecture, contributing guidelines, and code standards. Maintainers spend more time answering questions than coding.

How OpenClaw helps:

Connect to your GitHub repo, docs, and contribution guidelines:

• Architecture questions: "How does the rendering pipeline work?" → Explains from source code + docs
• Contribution guide: "How do I submit a PR?" → Step-by-step contribution process
• Code standards: "What's the naming convention for variables?" → Quotes style guide
• Issue triage: "I found a bug with [feature]" → Checks if it's a known issue, suggests workaround
• API usage: "How do I use the transform() function?" → Code examples from docs
• Roadmap: "Is feature X planned?" → Checks GitHub Projects and milestones

Advanced features:

• GitHub integration: "@OpenClaw explain PR #456" → Summarizes the pull request
• Code search: "Show me examples of custom hooks" → Finds relevant code in your repo
• Contributor recognition: "Who contributed the auth system?" → Credits contributors
• Release notes: "What's new in v2.0?" → Summarizes changelog

Impact:

• Maintainer time spent on questions: -60%
• New contributor onboarding 2x faster
• PR quality improves (contributors read docs via AI)
• Community engagement increases

6. Content Creator/Streamer Community

Scenario: You're a Twitch streamer with a 20,000-member Discord. Fans discuss streams, share clips, and ask about your setup. You want to provide value without being online 24/7.

How OpenClaw helps:

• Stream schedule: "When's the next stream?" → Checks your calendar
• VOD links: "Where can I watch yesterday's stream?" → Provides Twitch/YouTube links
• Clip sharing: "Find clips of the epic win" → Searches clip database
• Setup questions: "What mic do you use?" → Your gear list with affiliate links
• Game info: "What game are you playing tonight?" → Checks schedule
• Subscription perks: "What do I get as a Tier 2 sub?" → Explains benefits

Advanced features:

• Highlight generation: AI monitors #clips and creates weekly highlight reels
• Sentiment analysis: "How did chat feel about today's stream?" → Sentiment summary
• Meme tracker: AI learns your community's memes and jokes
• Giveaway management: "!enter giveaway" → Handles entry, winner selection

Impact:

• Community engagement up 40% (fans get instant interaction)
• Affiliate revenue increases (AI recommends gear with links)
• Moderators save 15 hours/week
• You stay connected even when offline

7. Local Community/Event Organization

Scenario: You run a Discord for your city's tech meetup group (1,200 members). You organize events, share job postings, and coordinate venue bookings.

How OpenClaw helps:

• Event calendar: "What meetups are scheduled this month?" → Lists upcoming events
• RSVP management: "!rsvp React Workshop" → Registers member, sends confirmation
• Venue info: "Where is tonight's event?" → Address, parking, directions
• Job board: "Any frontend jobs?" → Searches #job-postings
• Speaker info: "Who's speaking at the next event?" → Speaker bio and topic
• Sponsor recognition: Lists current sponsors with gratitude

Advanced features:

• Attendance tracking: AI checks who attended vs RSVP'd
• Feedback collection: Post-event surveys via DM
• Member intros: "Welcome @NewMember!" → Asks about their interests, introduces them
• Skill matching: "I need a designer for a project" → Suggests members with design skills

Impact:

• Event organization time cut in half
• Attendance increases 25% (better reminders)
• Member connections facilitated by AI
• Sponsor value increases (better recognition)

8. Mental Health and Support Community

Scenario: You run a peer support Discord for mental health (3,000 members). Members need resources, crisis support info, and peer connections in a safe space.

How OpenClaw helps:

Critical safety note: AI provides resources but always escalates crises to humans.

• Resource finding: "I'm feeling anxious, any tips?" → Evidence-based coping strategies
• Crisis resources: Keyword triggers ("suicidal", "self-harm") → Immediate crisis hotline info + moderator alert
• Therapy info: "How do I find a therapist?" → Local resources, insurance info
• Peer matching: "Anyone want to talk about ADHD?" → Suggests members with similar experiences
• Event reminders: "Meditation session tonight at 8pm" → Automated reminders
• Anonymity protection: AI never logs sensitive personal information

Advanced features:

• Sentiment monitoring: AI flags concerning patterns (member posting negatively frequently)
• Trigger warnings: Automatically tags potentially triggering content
• Resource library: Searchable database of articles, videos, worksheets
• Check-in prompts: "How are you doing today?" → Daily check-ins for interested members

Impact:

• Members get instant resources during crisis
• Moderators alerted to urgent situations immediately
• Peer connections facilitated safely
• Resource access improves outcomes

Features Deep Dive

@Mention Support

Mention your AI assistant anywhere in Discord:

• Public text channels it has access to
• Private channels (if invited and permissioned)
• Threads (full thread context awareness)
• Forum posts (can reply to forum threads)
• DMs (if DM support enabled)
• Group DMs (up to 10 people)
• Works with both @BotName and @mention

Prefix Commands

Customizable command prefix (default: !):

• !ask [question] - Quick questions
• !help [topic] - Help documentation
• !search [query] - Search server history/knowledge base
• !brief - Daily/weekly summaries
• !stats - Server statistics
• !role [name] - Role information
• Custom commands you define

Slash Commands (Discord Native)

Discord's built-in slash command system:

• Auto-completion as you type
• Parameter suggestions
• Help text built-in
• Mobile-friendly
• /ask question: - Questions with parameters
• /search query: - Structured search
• /brief type: daily - Dropdowns for options

Rich Embeds

Beautifully formatted responses:

• Title and description: Clear structure
• Color coding: Blue (info), red (error), green (success), purple (help)
• Fields: Organized key-value information
• Inline fields: Multi-column layouts
• Images: Thumbnails and full-size images
• Footers: Metadata (model used, response time, etc.)
• Timestamps: When response was generated
• Author field: Who asked the question
• URL links: Clickable titles

Message Components

Interactive Discord components:

• Buttons: "Show More", "Regenerate", "Mark Helpful"
• Select menus: Choose from multiple options
• Pagination: Navigate long responses with ← → buttons
• Confirmation dialogs: "Are you sure?" before destructive actions
• Form inputs: Multi-step conversations

Reaction-Based Controls

Emoji reactions for interaction:

• ✅ Confirm/Approve
• ❌ Cancel/Deny
• 🔁 Regenerate response
• 📌 Save to database
• 📊 Get detailed breakdown
• ⬅️➡️ Navigate pages
• ⭐ Mark as favorite
• 🗑️ Delete response

Thread Support

Full thread intelligence:

• Auto-creates threads for complex questions
• Remembers entire thread history
• Multiple people can participate
• Keeps main channels clean
• Thread summaries on demand
• Forum thread support (Discord's forum channels)

File Processing

Upload and analyze files:

• Images: Screenshots, memes, diagrams, photos
• Code files: Any programming language
• Documents: PDF, Word, text files
• Data files: CSV, JSON, XML
• Logs: Application logs, error logs
• Audio: Voice messages, audio files (transcription)
• Video: Short clips (thumbnail analysis)

Size limits: Up to 8MB on free Discord, 50MB with Nitro

Voice Channel Integration

Voice-specific features:

• Speech-to-text: Convert voice to text for AI processing
• Text-to-speech: AI responds in voice channels
• Voice activity detection: "Who's in voice right now?"
• Music integration: Play music via voice commands
• Voice transcription: "Summarize what was said in voice tonight"

Role-Based Permissions

Granular access control:

• Role whitelist: Only users with specific roles can interact
• Role blacklist: Certain roles are blocked
• Tiered access: Different roles get different features
• Premium roles: Server boosters/Nitro users get priority
• Moderator override: Mods can always access AI

Channel-Specific Configurations

Different settings per channel:

• #general: Basic Q&A only
• #code-help: Full code analysis and debugging
• #memes: Fun personality, less formal
• #support: Professional tone, ticket creation
• #premium: Advanced features for paying members

Auto-Moderation

AI-powered moderation:

• Spam detection: Identifies and flags spam
• Toxicity detection: Warns/kicks toxic users
• Scam link detection: Blocks phishing links
• Image moderation: NSFW content detection
• Language filter: Customizable word filters
• Raid protection: Identifies coordinated attacks

Analytics and Insights

Server intelligence:

• Message volume: "How many messages today?"
• Active users: "Who are the most active members?"
• Popular topics: "What's being discussed most?"
• Sentiment analysis: "How's the vibe in #general?"
• Member growth: "How many new members this week?"
• Engagement metrics: "What content gets most reactions?"

Webhook Integrations

Connect external services:

• GitHub: PR notifications, issue updates
• Twitter: Tweet alerts, trend monitoring
• Twitch: Stream online/offline notifications
• YouTube: New video alerts
• Reddit: Subreddit post monitoring
• RSS feeds: News, blog updates
• Custom webhooks: Any API you want

Multi-Server Support

One bot, multiple servers:

• Same bot across all your Discord servers
• Different configurations per server
• Shared or isolated memory
• Centralized management dashboard
• Server-specific personalities

Logging and Audit

Track all interactions:

• Who asked what, when
• Response times and quality
• Error tracking
• Usage patterns
• Moderation actions
• Export logs for compliance

Security Features

• Encryption in transit (TLS 1.3)
• Secure token storage
• OAuth 2.0 authentication
• Rate limiting (prevent abuse)
• DDoS protection
• Message scanning (prevent data leaks)
• Audit logging
• GDPR compliance tools

Setup Option 1: HeraClaw Cloud (Recommended)

Time required: 60 seconds Technical skill: None Cost: Included in HeraClaw Cloud subscription Best for: 95% of users, all community sizes

Why HeraClaw Cloud?

• No Discord bot application setup
• No token management
• No permission debugging
• No server infrastructure
• No uptime monitoring
• Professional support included
• Automatic updates
• 99.9% uptime SLA
• Enterprise-grade security

Steps:

1. Sign up for HeraClaw Cloud

• Visit cloud.getopenclaw.ai
• Click "Sign In" (no credit card required)
• Create your account (takes 60 seconds)

2. Navigate to Integrations

• Click "Integrations" in sidebar
• Find "Discord" in the list
• Click "Connect to Discord"

3. Authorize the Bot

• Discord OAuth screen appears
• Select your server from dropdown (requires "Manage Server" permission)
• Review permissions
• Click "Authorize"

4. Configure Channels (Optional)

• Back in HeraClaw dashboard
• Choose which channels the bot can access
• Set role-based permissions
• Configure personality and behavior
• Save configuration

5. Test the Bot

• In Discord, go to any allowed channel
• Type @OpenClaw hello!
• You should get an immediate response
• Try: @OpenClaw what can you help me with?

That's it! You're up and running.

What You Get with HeraClaw Cloud:

✅ Instant Setup - No technical configuration ✅ Automatic Updates - We handle Discord API changes ✅ Professional Support - Email, chat, phone support ✅ 99.9% Uptime - SLA-backed reliability ✅ Enterprise Security - SOC 2, GDPR compliant ✅ Unlimited Servers - Connect as many as you need ✅ Advanced Features - Voice integration, auto-moderation, analytics ✅ No Maintenance - We manage everything

Pricing: See cloud.getopenclaw.ai/pricing (affordable community plans)

Get Started: Start with HeraClaw Cloud →

Setup Option 2: Self-Hosted (Advanced)

Time required: 45-60 minutes (first time) Technical skill: Intermediate to Advanced Cost: VPS hosting ($10-50/month) + your time Best for: Technical users, custom requirements, data control needs

Who should self-host?

✅ Developers comfortable with APIs ✅ Communities with strict data policies ✅ Teams running existing infrastructure ✅ Technical enthusiasts with homelab setups ✅ Organizations that cannot use SaaS

Who should NOT self-host?

❌ Non-technical community owners ❌ Anyone who values time over cost savings ❌ Communities without DevOps knowledge ❌ Users wanting "set it and forget it"

Prerequisites:

• OpenClaw installed and running
• Terminal/SSH access to your server
• Discord server with admin permissions
• Understanding of OAuth and permissions
• Basic networking knowledge

Detailed Self-Hosted Setup

Step 1: Create a Discord Application

1. Go to discord.com/developers/applications
2. Click "New Application"
3. Name: "OpenClaw Assistant" (or your preference)
4. Click "Create"
5. You now have a Discord application (not yet a bot)

Step 2: Create the Bot User

1. In your application, click "Bot" in left sidebar
2. Click "Add Bot"
3. Confirm "Yes, do it!"
4. Bot created! Now configure it:

Bot settings:

• Username: OpenClaw (or your preference)
• Icon: Upload a profile picture
• Public Bot: OFF (unless you want others to add your bot)
• Requires OAuth2 Code Grant: OFF
• Presence Intent: ON (to see user status)
• Server Members Intent: ON (to access member list)
• Message Content Intent: ON (CRITICAL - required to read messages)

1. Under "Token" section, click "Reset Token"
2. Copy this token (starts with something like MTA...) - you'll need it later
3. Keep this secret - anyone with this token controls your bot

Step 3: Configure OAuth2 Permissions

1. Click "OAuth2" → "URL Generator" in left sidebar

2. Under "Scopes", select:

   • bot (required)
   • applications.commands (for slash commands)

3. Under "Bot Permissions", select:

Required permissions:

• General:

  • Read Messages/View Channels - See channels
  • Send Messages - Post responses
  • Embed Links - Use rich embeds
  • Attach Files - Send images, files
  • Read Message History - Context for conversations
  • Add Reactions - React to messages
  • Use External Emojis - Better formatting

• Text Permissions:

  • Send Messages in Threads - Thread support
  • Create Public Threads - Start conversations
  • Create Private Threads - Private discussions
  • Use Slash Commands - Slash command support

Optional permissions (for advanced features):

• Moderation:

  • Manage Messages - Delete spam, moderate
  • Kick Members - Auto-moderation
  • Ban Members - Severe violations
  • Manage Roles - Assign roles based on activity

• Voice:

  • Connect - Join voice channels
  • Speak - Text-to-speech in voice
  • Use Voice Activity - Detect speech

1. Copy the "Generated URL" at bottom
2. Keep this for Step 5

Step 4: Configure Privileged Intents

Critical: Discord requires approval for certain "privileged" data access.

1. Go back to "Bot" settings
2. Scroll to "Privileged Gateway Intents"
3. Enable:
   • ✅ Message Content Intent (REQUIRED - to read message text)
   • ✅ Server Members Intent (to see member list, useful for @mentions)
   • ✅ Presence Intent (to see online status, optional)

Note: If your bot is in 100+ servers, you'll need to verify your application with Discord. For most users, this isn't an issue.

Step 5: Add Bot to Your Server

1. Open the OAuth2 URL you copied in Step 3
2. Select your Discord server from dropdown
3. Click "Authorize"
4. Complete the CAPTCHA
5. Bot appears in your server's member list (offline until you run OpenClaw)

Step 6: Get Server and Channel IDs

You'll need these for configuration:

1. In Discord, go to User Settings → Advanced → Enable "Developer Mode"
2. Right-click your server icon → "Copy Server ID" → Save this
3. Right-click any channel → "Copy Channel ID" → Save this

Developer Mode lets you copy IDs for servers, channels, users, and messages.

Step 7: Configure OpenClaw

Edit your OpenClaw config file (~/.openclaw/config.yaml or ~/.config/openclaw/config.yaml):

channels:  discord:    enabled: true        # Bot token from Step 2    token: "MTA1234567890.GX1234.abcdef1234567890"        # Optional: Server ID (if you only want one server)    serverId: "123456789012345678"        # Optional: Restrict to specific channels    allowedChannels:      - "987654321098765432"  # #ai-help      - "876543210987654321"  # #support        # Optional: Never respond in these channels    ignoredChannels:      - "111111111111111111"  # #admin      - "222222222222222222"  # #mod-only        # Optional: Only users with these roles can interact    allowedRoles:      - "333333333333333333"  # Member role ID      - "444444444444444444"  # Premium role ID        # Command prefix (for !commands)    prefix: "!"        # Respond to @mentions?    respondToMentions: true        # Respond to DMs?    respondToDMs: true        # Use slash commands?    slashCommands: true        # Thread support?    threads: true        # Use embeds for responses?    useEmbeds: true        # Embed color (hex code)    embedColor: "#5865F2"  # Discord blurple

Finding Role IDs:

1. Enable Developer Mode (User Settings → Advanced)
2. Go to Server Settings → Roles
3. Right-click any role → "Copy Role ID"

Step 8: Start OpenClaw

# If running as a servicesudo systemctl restart openclaw# If running directlyopenclaw gateway start# Check logsopenclaw gateway logs --follow

What to look for in logs:

✓ Discord gateway connected✓ Bot user: OpenClaw#1234 (ID: 123456789)✓ Logged in to 1 server(s)✓ Listening in 2 channel(s)✓ Ready to serve requests

Step 9: Test the Bot

1. In Discord, go to a channel the bot can access
2. Type: @OpenClaw hello!
3. You should get a response within 2 seconds
4. Try a command: !ask What's 2+2?
5. Try a slash command: /ask question: How do I use this bot?

If no response, check logs for errors.

Step 10: Register Slash Commands

Slash commands must be registered with Discord:

# OpenClaw should auto-register on startup# If not, manually register:openclaw discord register-commands# Check registered commands:openclaw discord list-commands

Slash commands take up to 1 hour to appear globally, but show instantly for your specific server.

Advanced Self-Hosted Configuration

Multiple Servers

Run one bot across multiple Discord servers:

channels:  discord:    # Shared configuration    token: "your-bot-token"        # Server-specific configs    servers:      "123456789012345678":  # Server ID 1        allowedChannels:          - "111111111111111111"        prefix: "!"        embedColor: "#FF0000"  # Red            "987654321098765432":  # Server ID 2        allowedChannels:          - "222222222222222222"        prefix: "?"        embedColor: "#00FF00"  # Green

Custom Slash Commands

Define custom slash commands:

channels:  discord:    slashCommands:      ask:        description: "Ask the AI anything"        options:          - name: "question"            description: "Your question"            type: "string"            required: true            search:        description: "Search the knowledge base"        options:          - name: "query"            description: "Search terms"            type: "string"            required: true          - name: "category"            description: "Filter by category"            type: "string"            required: false            choices:              - name: "Documentation"                value: "docs"              - name: "Community Posts"                value: "posts"            brief:        description: "Get a summary"        options:          - name: "timeframe"            description: "How far back?"            type: "string"            required: false            choices:              - name: "Last hour"                value: "1h"              - name: "Last 24 hours"                value: "24h"              - name: "Last week"                value: "7d"

Channel-Specific Personalities

Different AI behavior per channel:

channels:  discord:    channelConfigs:      # Serious help channel      "111111111111111111":        personality: "professional"        maxTokens: 2000        temperature: 0.7        systemPrompt: "You are a helpful technical support assistant."            # Casual chat channel      "222222222222222222":        personality: "friendly"        maxTokens: 500        temperature: 1.0        systemPrompt: "You are a fun, casual chatbot who loves memes."            # Code help channel      "333333333333333333":        personality: "technical"        allowedSkills:          - "code"          - "debug"        modelPreference: "claude-opus-4"

Auto-Moderation Rules

AI-powered moderation:

channels:  discord:    moderation:      enabled: true            # Spam detection      spam:        enabled: true        threshold: 5  # messages in 10 seconds        action: "warn"  # warn, mute, kick, ban            # Toxicity detection      toxicity:        enabled: true        threshold: 0.8  # 0-1 scale        action: "warn"            # Link filtering      links:        blockUnknownDomains: true        whitelist:          - "discord.com"          - "github.com"          - "yoursite.com"        action: "delete"            # NSFW content      nsfw:        enabled: true        scanImages: true        action: "delete"

Voice Channel Integration

Enable voice features:

channels:  discord:    voice:      enabled: true            # Speech-to-text      transcription:        enabled: true        language: "en-US"            # Text-to-speech responses      tts:        enabled: true        voice: "en-US-Neural2-F"  # Female voice        speed: 1.0            # Join voice channels automatically?      autoJoin: false            # Which voice channels to monitor      allowedVoiceChannels:        - "444444444444444444"  # Study Room

Rate Limiting

Protect your bot from abuse:

channels:  discord:    rateLimit:      # Per user limits      perUser:        requests: 10        window: 60  # seconds        action: "cooldown"  # cooldown, warn, ignore            # Per channel limits      perChannel:        requests: 50        window: 60            # Global limits      global:        requests: 500        window: 60            # VIP bypass (users with specific roles skip limits)      vipRoles:        - "555555555555555555"  # Premium role

Embed Customization

Control embed appearance:

channels:  discord:    embeds:      # Use embeds at all?      enabled: true            # Color for different response types      colors:        info: "#5865F2"      # Blue        success: "#57F287"   # Green        warning: "#FEE75C"   # Yellow        error: "#ED4245"     # Red            # Include footer?      footer:        enabled: true        text: "Powered by OpenClaw"        icon: "https://yoursite.com/icon.png"            # Include timestamp?      timestamp: true            # Include author field (who asked)?      showAuthor: true            # Thumbnail image      thumbnail: "https://yoursite.com/logo.png"

Webhook Integration

Connect external services:

channels:  discord:    webhooks:      # GitHub notifications      github:        enabled: true        channelId: "666666666666666666"  # #github-updates        events:          - "push"          - "pull_request"          - "issues"            # Twitter alerts      twitter:        enabled: true        channelId: "777777777777777777"  # #social-media        accounts:          - "@YourBrand"          - "@CompetitorWatch"            # Custom webhook      custom:        url: "https://your-api.com/webhook"        events:          - "message_sent"          - "member_joined"

Troubleshooting Self-Hosted Setup

Bot Not Coming Online

Symptoms: Bot shows as offline in Discord

Potential causes:

1. OpenClaw not running
2. Invalid bot token
3. Network connectivity issues
4. Firewall blocking Discord gateway

Fix:

# Check OpenClaw statusopenclaw gateway status# Check logs for connection errorsopenclaw gateway logs | grep -i discord# Test token validitycurl -H "Authorization: Bot YOUR_TOKEN_HERE" \     https://discord.com/api/v10/users/@me# Should return bot user info, not 401 error# Restart OpenClawopenclaw gateway restart

Bot Online But Not Responding

Symptoms: Bot shows online, but doesn't respond to @mentions or commands

Potential causes:

1. Message Content Intent not enabled
2. Missing permissions in channel
3. Bot not in the channel you're testing
4. Channel is in ignoredChannels list

Fix:

1. Go to Discord Developer Portal → Your App → Bot
2. Scroll to "Privileged Gateway Intents"
3. Ensure "Message Content Intent" is ON
4. Save changes
5. Restart your bot
6. In Discord, check channel permissions for bot role
7. Ensure bot can "Read Messages" and "Send Messages"

Slash Commands Not Appearing

Symptoms: Type / and your commands don't show up

Potential causes:

1. Commands not registered
2. Bot missing "applications.commands" scope
3. Caching (can take up to 1 hour globally)

Fix:

# Manually register commandsopenclaw discord register-commands# Verify registrationopenclaw discord list-commands# For instant testing, use guild commands (server-specific)# These appear immediately but only in one serveropenclaw discord register-commands --guild-id YOUR_SERVER_ID

If bot is already added without applications.commands scope:

1. Go to OAuth2 URL Generator
2. Select both bot and applications.commands
3. Use generated URL to re-authorize (won't kick the bot)

"Missing Permissions" Error

Symptoms: Bot responds with "I don't have permission to do that"

Potential causes:

1. Channel permission overrides blocking bot
2. Role hierarchy (bot's role too low)
3. Missing specific permission for that action

Fix:

1. Server Settings → Roles → Find bot's role
2. Move it higher in the role list
3. Ensure it has necessary permissions
4. Check channel-specific overrides:
   • Right-click channel → Edit Channel → Permissions
   • Look for bot's role, ensure green checkmarks on needed permissions

High Latency (Slow Responses)

Symptoms: Bot takes 10+ seconds to respond

Potential causes:

1. Slow model inference
2. Network latency to Discord API
3. OpenClaw server overloaded
4. Large message history processing

Fix:

# Check server resourcestop -p $(pgrep openclaw)# Check network latencyping discord.com# Enable response streaming# In config.yaml:channels:  discord:    streaming: true  # Sends partial responses as they generate        # Reduce context window for faster responses    maxContextMessages: 10  # Only look at last 10 messages

"Rate Limited" Errors

Symptoms: Logs show "rate limited" or "429 Too Many Requests"

Potential causes:

1. Sending too many messages too fast
2. Discord's rate limit (5 messages per 5 seconds per channel)
3. Too many API calls

Fix:

• OpenClaw handles rate limiting automatically
• If seeing this often, you're sending too much
• Consider batching updates or using threads

# Configure message queuingchannels:  discord:    rateLimit:      messagesPerSecond: 1      burstAllowance: 3      queueMessages: true  # Queue instead of dropping

Embeds Not Showing

Symptoms: Responses are plain text instead of nice embeds

Potential causes:

1. Missing "Embed Links" permission
2. Embeds disabled in config
3. User has embeds disabled in their settings

Fix:

1. Check bot has "Embed Links" permission
2. Verify config:

channels:  discord:    useEmbeds: true

1. If user can't see embeds, that's their client setting (can't fix)

Bot Randomly Disconnects

Symptoms: Bot goes offline periodically, then reconnects

Potential causes:

1. OpenClaw process crashes
2. Network interruptions
3. Discord gateway issues
4. Memory leaks

Fix:

# Set up process monitoringsudo systemctl enable openclawsudo systemctl start openclaw# Check for crashesopenclaw gateway logs | grep -i "error\|crash\|fatal"# Monitor memory usagewatch -n 5 'ps aux | grep openclaw'# Enable automatic reconnection# In config.yaml:channels:  discord:    autoReconnect: true    reconnectAttempts: 5    reconnectDelay: 3000  # ms

Voice Features Not Working

Symptoms: Bot can't join voice or do text-to-speech

Potential causes:

1. Missing voice permissions
2. Voice dependencies not installed
3. Audio codec issues

Fix:

# Install voice dependenciessudo apt-get install ffmpeg libopus-dev libsodium-dev# Or on macOSbrew install ffmpeg opus libsodium# Verify bot has voice permissions# Discord: Server Settings → Roles → Bot Role# Ensure: Connect, Speak, Use Voice Activity# Check config# In config.yaml:channels:  discord:    voice:      enabled: true

Security Best Practices for Self-Hosted

1. Protect Your Bot Token

# Never commit token to gitecho "config.yaml" >> .gitignoreecho ".env" >> .gitignore# Use environment variablesexport DISCORD_BOT_TOKEN="your-token-here"# Reference in configchannels:  discord:    token: ${DISCORD_BOT_TOKEN}# Or use secrets managementchannels:  discord:    token: "op://Work/Discord Bot/token"  # 1Password

If your token leaks:

1. Go to Discord Developer Portal immediately
2. Bot settings → Reset Token
3. Update OpenClaw config with new token
4. Restart bot

2. Principle of Least Privilege

Only grant permissions you actually need:

• Don't give "Administrator" permission
• Don't enable "Manage Server" unless needed
• Don't allow "Mention Everyone" unless intentional
• Review permissions quarterly

3. Role-Based Access Control

channels:  discord:    # Only specific roles can use bot    allowedRoles:      - "member-role-id"      - "premium-role-id"        # Block certain roles    blockedRoles:      - "muted-role-id"        # Moderators can override    moderatorRoles:      - "mod-role-id"      - "admin-role-id"

4. Channel Isolation

Limit bot to specific channels:

channels:  discord:    # Only these channels    allowedChannels:      - "ai-help-channel-id"      - "support-channel-id"        # Never these channels    ignoredChannels:      - "admin-channel-id"      - "private-channel-id"

5. Rate Limiting

Prevent abuse:

channels:  discord:    rateLimit:      perUser:        requests: 10        window: 60            # Notify mods of abuse      alertChannel: "mod-alerts-channel-id"      alertThreshold: 20  # requests in window

6. Audit Logging

Track all interactions:

logging:  audit:    enabled: true    logFile: "/var/log/openclaw/audit.log"    includeMessages: false  # Privacy: don't log content    includeMetadata: true   # Log who, when, where    retention: 90  # days

7. Content Filtering

Prevent data leaks:

channels:  discord:    filtering:      # Block bot from repeating sensitive patterns      blockPatterns:        - "password"        - "api[_-]?key"        - "credit[_-]?card"        - "ssn"            # Redact from logs      redactPatterns:        - "\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b"  # emails        - "\b\d{3}-\d{2}-\d{4}\b"  # SSN pattern

8. Regular Updates

# Update OpenClaw regularlyopenclaw update# Check for security advisoriesopenclaw security-check# Subscribe to Discord API changelog# https://discord.com/developers/docs/change-log

9. Backup Configuration

# Backup config regularlycp ~/.openclaw/config.yaml ~/.openclaw/config.yaml.backup# Or use gitcd ~/.openclaw/git initgit add config.yamlgit commit -m "Config backup $(date +%Y-%m-%d)"

10. Monitor for Anomalies

channels:  discord:    monitoring:      # Alert on unusual patterns      alerts:        - type: "high_usage"          threshold: 100  # messages/hour          action: "notify"                - type: "new_server"          action: "require_approval"                - type: "permission_change"          action: "log_and_notify"

Comparison: HeraClaw Cloud vs Self-Hosted

Why 95% of users choose HeraClaw Cloud:

✅ Time is valuable - Hour setup + maintenance adds up ✅ Discord changes frequently - Gateway updates, API deprecations handled automatically ✅ Security is hard - Token management, rate limiting, abuse prevention ✅ Voice is complex - Audio dependencies, codec configuration ✅ Support matters - When things break at 2am, we fix it ✅ No hidden costs - Server hosting, monitoring tools, your time

When self-hosting makes sense:

✅ You have developers with spare capacity ✅ Data cannot leave your infrastructure ✅ You're already running bot infrastructure ✅ You want heavy customization ✅ You enjoy DevOps work

Frequently Asked Questions

Q: Do I need Discord Nitro or Server Boost?

A: No. The bot works on free Discord servers. Nitro/Boost give you larger file uploads (8MB → 50MB) and better audio quality in voice, but aren't required.

Q: Can I use this in multiple Discord servers?

A: Yes! HeraClaw Cloud supports unlimited servers. Self-hosted requires the same bot token across servers (same bot user), with per-server configurations.

Q: What permissions does the bot need?

A: Minimum: Read Messages, Send Messages, Embed Links, Read Message History. Optional: Manage Messages (moderation), Connect/Speak (voice), Add Reactions. Full list in setup guide.

Q: Can I restrict who can use the bot?

A: Yes. Configure role-based access (only certain roles), channel restrictions (only specific channels), or user allowlist (specific users only).

Q: Does it work in private/hidden channels?

A: Yes, if you invite the bot to the channel and it has permission to read that channel.

Q: Can it work in threads and forum channels?

A: Yes, full support for both. The bot understands thread context and can reply to forum posts.

Q: What about voice channels?

A: Yes! The bot can join voice, do text-to-speech responses, and transcribe speech to text (premium feature in HeraClaw Cloud, self-hosted requires audio dependencies).

Q: Is my data secure?

A: HeraClaw Cloud: SOC 2 certified, encrypted in transit and at rest, GDPR compliant. We don't store message content unless explicitly configured. Self-hosted: Your responsibility, you control all data.

Q: Can the bot DM users?

A: Yes, if enabled. Users can DM the bot directly for private conversations. Bot can also send proactive DMs (reminders, alerts).

Q: How fast are responses?

A: Typically 1-3 seconds from mention to response. Depends on model (GPT-4 vs Claude vs local), query complexity, and context size.

Q: Can I customize the bot's personality?

A: Yes! Configure different personalities per channel (professional in #support, casual in #general, technical in #dev-help).

Q: Does it support slash commands?

A: Yes, full Discord slash command support with auto-completion, parameter suggestions, and help text.

Q: Can it auto-moderate my server?

A: Yes. AI-powered spam detection, toxicity filtering, scam link blocking, and NSFW image detection (HeraClaw Cloud has pre-built rules, self-hosted requires configuration).

Q: What about server analytics?

A: Yes. Ask "How many messages today?" "Who are the most active members?" "What's the sentiment in #general?" Works best with HeraClaw Cloud dashboard.

Q: Can it integrate with other bots?

A: Yes. Works alongside MEE6, Dyno, Carl-bot, etc. Can even reference data from other bots ("Check my XP from MEE6").

Q: What if Discord changes their API?

A: HeraClaw Cloud: We handle all API changes with zero downtime. Self-hosted: You must manually update OpenClaw when breaking changes occur.

Q: Can I migrate from self-hosted to Cloud?

A: Absolutely. Export your config, sign up for HeraClaw Cloud, import settings. Takes ~10 minutes. Most users who migrate never go back.

Q: How do I remove the bot?

A: In Discord: Server Settings → Members → Find bot → Kick. Then disable in HeraClaw or OpenClaw config.

Q: Can the bot @mention users or roles?

A: Yes, if configured. Can mention specific users in responses, or @mention roles for announcements (use with caution - can be spammy).

Q: What about emoji reactions?

A: Yes. Bot can react to messages with emoji, and users can react to bot messages to control them (✅ to confirm, ❌ to cancel, 🔁 to regenerate).

Q: Can it send images and GIFs?

A: Yes. Can upload images (charts, diagrams), send GIF URLs, and analyze uploaded images ("What's in this screenshot?").

Q: Does it work with Discord mobile?

A: Yes, fully compatible with iOS and Android Discord apps. Slash commands, embeds, everything works.

Q: Can I use webhooks to connect other services?

A: Yes. Connect GitHub (PR notifications), Twitter (tweet monitoring), RSS feeds, custom APIs - anything that can send webhooks.

Q: What about Discord's new features (Stage Channels, Events, etc.)?

A: HeraClaw Cloud: We add support for new Discord features quickly. Self-hosted: Requires OpenClaw updates.

Q: Can the bot create channels or manage roles?

A: Yes, if you give it those permissions. Use with caution - very powerful and can be abused.

Q: How do I change the bot's name or avatar?

A: Discord Developer Portal → Your Application → Bot → Edit username/avatar. Changes appear globally (all servers).

Q: What's the difference between prefix commands and slash commands?

A: Prefix (!ask question) - Simple, works anywhere, no registration needed. Slash (/ask question:) - Native Discord UI, auto-complete, parameter validation, but requires registration.

Get Started

For 95% of users (recommended):

Start with HeraClaw Cloud →

• 60-second setup
• No technical skills needed
• Professional support
• 99.9% uptime SLA
• No credit card required

For advanced users only:

Self-Hosting Setup Guide →

• 45-60 minute setup
• Requires developer knowledge
• You maintain infrastructure
• Full control and customization

Questions? Email support@cloud.getopenclaw.ai or join our Discord for help.

Last updated: April 9, 2026

Built with OpenClaw — The open-source AI assistant platform. Self-host or use HeraClaw Cloud.