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

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+

Discord 连接中心

为 Clawdbot 提供完整的 Discord 集成功能，并自动安装用户界面。该技能提供 Discord 机器人连接所需的一切，包括：

- Discord 频道插件 - 用于消息收发的完整 Discord 机器人集成
仪表盘 UI 标签页 - 用于设置和监控的 Web 界面
设置向导 - 分步指导创建和配置机器人
凭据管理 - 安全令牌存储（支持 OpenBao）
服务器监控 - 健康检查与服务器管理
插件架构钩子 - 自动安装 UI 组件

安装

该技能会自动安装所有必要组件：

bash

通过代理安装

从 ClawHub 安装 discord-connect-hub 技能

该技能将自动：

1. 安装 Discord 频道插件（如未安装）
在控制仪表盘中添加 Discord 标签页
注册用于 Discord 管理的 RPC 处理器
设置导航和路由
安装 UI 组件和视图

功能特性

Discord 机器人集成

- 完整的 Discord.js 机器人实现
消息发送/接收，保留格式
反应处理与表情支持
文件附件支持
斜杠命令集成
成员与服务器管理

仪表盘 UI

- 连接状态 - 实时机器人状态与健康检查
设置向导 - 交互式机器人创建指南
服务器管理 - 查看服务器、频道和权限
邀请生成器 - 创建机器人邀请链接
健康诊断 - 自动故障排除
令牌管理 - 安全凭据存储

插件架构集成

- 自动安装 UI 标签页
动态导航更新
RPC 方法注册
配置管理
重启编排

快速设置

1. Discord 应用程序设置

1. 访问 discord.com/developers/applications
创建 新应用程序 → 输入名称 → 创建
进入 Bot 标签页 → 重置令牌 → 复制令牌
启用 消息内容意图 ✅

2. 机器人权限

进入 OAuth2 → URL 生成器：

- 范围：bot + applications.commands
权限：发送消息、读取历史、反应、嵌入、文件、斜杠命令
复制邀请链接 → 在浏览器中打开 → 授权

3. 在 Clawdbot 中配置

选项 A：仪表盘（推荐）

1. 打开控制仪表盘 → 频道 → Discord
粘贴机器人令牌 → 保存并连接

选项 B：配置文件
yaml
channels:
discord:
botToken: 你的机器人令牌
# 或使用 OpenBao：
# botToken: bao:channels/discord#bot_token

插件架构钩子

该技能包含用于 Clawdbot 插件架构的钩子：

安装钩子

- install/navigation.js - 在仪表盘中添加 Discord 标签页
install/rpc-handlers.js - 注册 Discord RPC 方法
install/ui-components.js - 安装 UI 视图和模板
install/config-defaults.js - 设置默认配置

运行时钩子

- hooks/post-install.js - 安装后设置和验证
hooks/pre-uninstall.js - 卸载前清理
hooks/config-updated.js - 响应配置更改

能力注册

该技能声明其插件系统能力：

- UI 标签页：带导航和路由的 discord 标签页
RPC 方法：Discord API 交互端点
频道类型：discord 消息频道
配置模式：Discord 频道配置

RPC 方法

方法	描述
discord.status	获取机器人连接状态和用户信息
discord.health

配置选项

yaml
channels:
discord:
# 必填
botToken: 你的机器人令牌

# 服务器限制（可选）
guilds:
服务器ID:
enabled: true
channels:
频道ID:
enabled: true
requireMention: false

# 全局行为
requireMention: true # 在服务器中需要 @提及
dmPolicy: pairing # 私信处理：配对|开放|关闭
groupPolicy: open # 服务器处理：开放|提及|关闭

# 高级选项
retryAttempts: 3
heartbeatInterval: 30000
reconnectDelay: 5000

安全特性

- 令牌保护 - 在 API 响应中从不暴露完整令牌
OpenBao 集成 - 基于保险库的凭据存储
作用域权限 - 仅请求必要的机器人权限
输入验证 - 清理所有 Discord API 输入
速率限制 - 遵守 Discord API 限制
HTTPS 强制 - 安全令牌传输

健康检查

自动诊断包括：

- ✅ 令牌有效性 - 机器人令牌认证
✅ 网关连接 - Discord WebSocket 状态
✅ 消息意图 - 所需意图启用
✅ 机器人权限 - 服务器级权限验证
✅ 频道访问 - 读/写权限检查
✅ API 速率限制 - 当前使用情况和限制

故障排除

常见问题

无效令牌错误：

- 确保使用的是 机器人令牌（而非用户令牌）
验证令牌已完整复制
尝试在开发者门户中重置令牌

机器人在频道中无响应：

- 检查 消息内容意图 是否已启用
验证机器人在频道中具有权限
检查 requireMention 设置（尝试 @提及）

仪表盘无法加载：

- 验证 UI 安装是否成功完成
检查浏览器控制台是否有错误
重启网关：clawdbot gateway restart

日志分析

bash

检查 Discord 连接日志

clawdbot logs | grep discord

独立测试令牌

python scripts/test-token.py 你的令牌

文件结构

discord-connect-hub/
├── SKILL.md # 本技能指南
├── scripts/
│ ├── test-token.py # 令牌验证工具
│ ├── install-plugin.js # 插件安装脚本
│ └── health-check.py # 诊断工具
├── references/
│ ├── discord-api.md # Discord API 文档
│ ├── bot-setup.md # 详细设置指南
│ └── troubleshooting.md # 扩展故障排除
└── assets/
├── discord-backend.ts # RPC 处理器实现
├── discord-views.ts # UI 组件模板
├── navigation-hooks.js # 导航注册
├── install-hooks.js # 安装自动化
└── config-schema.json # 配置验证

插件集成详情

自动安装过程

1. 检测环境 - 检查 Clawdbot 源代码是否可用
安装后端 - 将 RPC 处理器复制到网关
注册处理器 - 向服务器添加方法注册
安装 UI 组件 - 复制视图和模板
更新导航 - 在仪表盘中添加 Discord 标签页
配置路由 - 为标签页设置 URL 路由
构建并重启 - 编译更改并重启网关

手动安装备用方案

如果自动安装不可行，该技能提供类似原始 discord-connect 技能的详细手动安装说明。

兼容性

- Clawdbot：>=2026.1.0
Node.js：>=18.0.0
Discord.js：>=14.0.0
插件架构：v2+

链接

- [Discord 开发者门户](https://discord.com/developers/applications

discord-connect-hubDiscord连接中心