# Send Discord Connect UI to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "discord-connect-ui",
    "name": "Discord Connect UI",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/maverick-software/discord-connect-ui",
    "canonicalUrl": "https://clawhub.ai/maverick-software/discord-connect-ui",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/discord-connect-ui",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=discord-connect-ui",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "package.json",
      "scripts/install-plugin.js",
      "scripts/test-token.py",
      "scripts/health-check.py",
      "assets/config-schema.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/discord-connect-ui"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/discord-connect-ui",
    "downloadUrl": "https://openagent3.xyz/downloads/discord-connect-ui",
    "agentUrl": "https://openagent3.xyz/skills/discord-connect-ui/agent",
    "manifestUrl": "https://openagent3.xyz/skills/discord-connect-ui/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/discord-connect-ui/agent.md"
  }
}
```
## Documentation

### 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:

# Install via agent
Install the discord-connect-hub skill from ClawHub

The skill will automatically:

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

### 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

### 1. Discord Application Setup

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 + applications.commands
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)

Open Control Dashboard → Channels → Discord
Paste bot token → Save & Connect

Option B: Config File

channels:
  discord:
    botToken: "YOUR_BOT_TOKEN"
    # Or with OpenBao:
    # botToken: "bao:channels/discord#bot_token"

### Plugin Architecture Hooks

This skill includes hooks for the Clawdbot plugin architecture:

### Installation Hooks

install/navigation.js - Adds Discord tab to dashboard
install/rpc-handlers.js - Registers Discord RPC methods
install/ui-components.js - Installs UI views and templates
install/config-defaults.js - Sets up default configuration

### Runtime Hooks

hooks/post-install.js - Post-installation setup and verification
hooks/pre-uninstall.js - Cleanup before removal
hooks/config-updated.js - 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

MethodDescriptiondiscord.statusGet bot connection status and user infodiscord.healthRun comprehensive health checksdiscord.guildsList connected Discord serversdiscord.guildGet detailed server informationdiscord.channelsList channels in a serverdiscord.inviteGenerate bot invite URLsdiscord.testTokenValidate token without savingdiscord.setTokenStore and activate bot tokendiscord.permissionsCheck bot permissions

### Configuration Options

channels:
  discord:
    # Required
    botToken: "YOUR_BOT_TOKEN"
    
    # Guild restrictions (optional)
    guilds:
      "SERVER_ID":
        enabled: true
        channels:
          "CHANNEL_ID":
            enabled: true
            requireMention: false
    
    # Global behavior
    requireMention: true        # Require @mention in servers
    dmPolicy: "pairing"         # DM handling: pairing|open|closed
    groupPolicy: "open"         # Server handling: open|mention|closed
    
    # Advanced options
    retryAttempts: 3
    heartbeatInterval: 30000
    reconnectDelay: 5000

### 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

### 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: clawdbot gateway restart

### Log Analysis

# Check Discord connection logs
clawdbot logs | grep discord

# Test token independently
python scripts/test-token.py YOUR_TOKEN

### Files Structure

discord-connect-hub/
├── SKILL.md                 # This skill guide
├── scripts/
│   ├── test-token.py       # Token validation utility
│   ├── install-plugin.js   # Plugin installation script
│   └── health-check.py     # Diagnostic tool
├── references/
│   ├── discord-api.md      # Discord API documentation
│   ├── bot-setup.md        # Detailed setup guide
│   └── troubleshooting.md  # Extended troubleshooting
└── assets/
    ├── discord-backend.ts   # RPC handler implementation
    ├── discord-views.ts     # UI component templates
    ├── navigation-hooks.js  # Navigation registration
    ├── install-hooks.js     # Installation automation
    └── config-schema.json   # Configuration validation

### Automatic Installation Process

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

Discord Developer Portal
Bot Permissions Calculator
Clawdbot Discord
ClawHub Repository
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: maverick-software
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/discord-connect-ui)
- [Send to Agent page](https://openagent3.xyz/skills/discord-connect-ui/agent)
- [JSON manifest](https://openagent3.xyz/skills/discord-connect-ui/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/discord-connect-ui/agent.md)
- [Download page](https://openagent3.xyz/downloads/discord-connect-ui)