Discord Connect Hub
Complete Discord integration for Clawdbot with automatic UI installation. This skill provides everything needed for Discord bot connectivity including:
- - Discord Channel Plugin - Full Discord bot integration for messaging
- Dashboard UI Tab - Web interface for setup and monitoring
- Setup Wizard - Step-by-step bot creation and configuration
- Credential Management - Secure token storage (OpenBao support)
- Server Monitoring - Health checks and guild management
- Plugin Architecture Hooks - Automatic installation of UI components
Installation
This skill automatically installs all necessary components:
CODEBLOCK0
The skill will automatically:
- 1. Install Discord channel plugin if not present
- Add Discord tab to the Control dashboard
- Register RPC handlers for Discord management
- Set up navigation and routing
- Install UI components and views
Features
Discord Bot Integration
- - Full Discord.js bot implementation
- Message sending/receiving with formatting preservation
- Reaction handling and emoji support
- File attachment support
- Slash command integration
- Member and guild management
Dashboard UI
- - Connection Status - Real-time bot status and health
- Setup Wizard - Interactive bot creation guide
- Server Management - View guilds, channels, and permissions
- Invite Generator - Create bot invite URLs
- Health Diagnostics - Automatic troubleshooting
- Token Management - Secure credential storage
Plugin Architecture Integration
- - Automatic UI tab installation
- Dynamic navigation updates
- RPC method registration
- Configuration management
- Restart orchestration
Quick Setup
1. Discord Application Setup
- 1. Go to discord.com/developers/applications
- Create New Application → Enter name → Create
- Go to Bot tab → Reset Token → Copy token
- Enable Message Content Intent ✅
2. Bot Permissions
Go to
OAuth2 →
URL Generator:
- - Scopes:
bot + INLINECODE1 - Permissions: Send Messages, Read History, Reactions, Embeds, Files, Slash Commands
- Copy invite URL → Open in browser → Authorize
3. Configure in Clawdbot
Option A: Dashboard (Recommended)
- 1. Open Control Dashboard → Channels → Discord
- Paste bot token → Save & Connect
Option B: Config File
CODEBLOCK1
Plugin Architecture Hooks
This skill includes hooks for the Clawdbot plugin architecture:
Installation Hooks
- -
install/navigation.js - Adds Discord tab to dashboard - INLINECODE3 - Registers Discord RPC methods
- INLINECODE4 - Installs UI views and templates
- INLINECODE5 - Sets up default configuration
Runtime Hooks
- -
hooks/post-install.js - Post-installation setup and verification - INLINECODE7 - Cleanup before removal
- INLINECODE8 - Responds to configuration changes
Capabilities Registration
The skill declares its capabilities for the plugin system:
- - UI Tabs:
discord tab with navigation and routing - RPC Methods: Discord API interaction endpoints
- Channel Type:
discord messaging channel - Config Schema: Discord channel configuration
RPC Methods
| Method | Description |
|---|
| INLINECODE11 | Get bot connection status and user info |
| INLINECODE12 |
Run comprehensive health checks |
|
discord.guilds | List connected Discord servers |
|
discord.guild | Get detailed server information |
|
discord.channels | List channels in a server |
|
discord.invite | Generate bot invite URLs |
|
discord.testToken | Validate token without saving |
|
discord.setToken | Store and activate bot token |
|
discord.permissions | Check bot permissions |
Configuration Options
CODEBLOCK2
Security Features
- - Token Protection - Never exposes full tokens in API responses
- OpenBao Integration - Vault-based credential storage
- Scoped Permissions - Requests only necessary bot permissions
- Input Validation - Sanitizes all Discord API inputs
- Rate Limiting - Respects Discord API limits
- HTTPS Enforcement - Secure token transmission
Health Checks
Automatic diagnostics include:
- - ✅ Token Validity - Bot token authentication
- ✅ Gateway Connection - Discord WebSocket status
- ✅ Message Intent - Required intent enablement
- ✅ Bot Permissions - Guild-level permission verification
- ✅ Channel Access - Read/write permission checks
- ✅ API Rate Limits - Current usage and limits
Troubleshooting
Common Issues
"Invalid token" errors:
- - Ensure you're using a bot token (not user token)
- Verify the token was copied completely
- Try resetting the token in Developer Portal
Bot not responding in channels:
- - Check Message Content Intent is enabled
- Verify bot has permissions in the channel
- Check
requireMention setting (try @mentioning)
Dashboard not loading:
- - Verify UI installation completed successfully
- Check browser console for errors
- Restart gateway: INLINECODE21
Log Analysis
CODEBLOCK3
Files Structure
CODEBLOCK4
Plugin Integration Details
Automatic Installation Process
- 1. Detect Environment - Check if Clawdbot source is available
- Install Backend - Copy RPC handlers to gateway
- Register Handlers - Add method registration to server
- Install UI Components - Copy views and templates
- Update Navigation - Add Discord tab to dashboard
- Configure Routes - Set up URL routing for tab
- Build & Restart - Compile changes and restart gateway
Manual Installation Fallback
If automatic installation isn't possible, the skill provides detailed manual instructions similar to the original discord-connect skill.
Compatibility
- - Clawdbot: >=2026.1.0
- Node.js: >=18.0.0
- Discord.js: >=14.0.0
- Plugin Architecture: v2+
Links
