核心用法
discord-admin 是一款面向 OpenClaw 平台的 Discord 服务器管理插件，通过统一工具 discord_admin 暴露 22 项管理功能。用户配置 Discord Bot Token 后，插件自建 Discord.js 客户端直连 Discord 网关，所有操作返回结构化 JSON 响应。
主要功能模块：
- 角色管理：创建、编辑、删除角色，支持颜色、权限、提及设置
- 用户管理：踢出、封禁/解封、限时禁言（最长 28 天）、警告（DM 嵌入消息）
- 频道管理：锁定/解锁、克隆、设置慢速模式（0-21600 秒）、私有化（基于角色可见性）
- 消息管理：批量删除 2-100 条消息
- 邀请与 Webhook：创建/列出/删除服务器邀请和 Webhook
- 审计与信息：查询审计日志、获取服务器元数据、列出成员（支持角色筛选）、设置昵称
配置要求：
1. 安装插件并执行 npm install
2. 在 OpenClaw 配置中设置 channels.discord.token
3. Discord 开发者门户启用必要 Intent：Guilds、Guild Members（特权）、Guild Moderation、Guild Messages、Guild Invites、Guild Webhooks
4. 授予 Bot 权限：Manage Roles、Kick Members、Ban Members、Moderate Members、Manage Channels、Manage Messages、Create Instant Invite、Manage Webhooks、View Audit Log、Manage Nicknames
显著优点
- 功能全面：单工具覆盖 Discord 管理高频场景，减少多工具切换
- 结构化输出：所有操作返回 JSON，便于自动化集成
- 直连网关：Token 仅用于 Discord 网关连接，不转发第三方
- 权限可控：建议按需分配最小权限，避免滥用全管理员 Token
潜在缺点与局限性
- 特权依赖：成员列表、踢出、禁言等核心功能依赖
Guild Members特权 Intent，需 Discord 审核通过 - 消息删除限制：单次批量删除上限 100 条，大规模清理需多次调用
- 昵称管理限制：仅支持修改他人昵称，无法直接修改用户名（Discord 限制）
- 无跨服务器能力：单 Token 仅能管理该 Bot 所在服务器
- Node.js 依赖：运行环境需预装 Node 运行时
适合人群
- Discord 社区管理员与版主团队
- 需自动化服务器运维的开发者/技术运营
- 集成 Discord 管理到 OpenClaw 工作流的高级用户
- 多服务器管理场景下的效率追求者
常规风险
- Token 泄露风险：Bot Token 即账户凭证，泄露可导致服务器被恶意控制；务必存储于安全配置，避免硬编码
- 权限过度授予：全管理员 Token 若泄露后果严重，建议严格遵循最小权限原则
- 操作不可逆：封禁、批量删除消息、角色删除等操作无内置确认机制，误操作可能影响用户体验
- API 限流：高频操作可能触发 Discord 速率限制，导致临时不可用
- DM 警告依赖：
warn功能依赖用户开启私信，关闭 DM 则无法送达