Discord Bot 详细配置

1. 前置准备

前往 Discord Developer Portal（discord.com/developers）创建应用。在「Bot」页面点击「Add Bot」创建机器人，获取 Bot Token。在「OAuth2 > URL Generator」中勾选 bot 和 applications.commands 权限，生成邀请链接并将 Bot 添加到目标服务器。

2. 在 Semibot 创建 Bot 实例

进入 Semibot 配置中心 > Bots > 新建，选择 Discord 类型。填写 Bot Token（botToken），可选填 webhookSecret（用于验证入站事件）和 botUserId（用于检测 @提及）。选择默认 Agent，保存实例。

3. 连接机制

Discord 使用 WebSocket 网关连接，不需要配置 Webhook URL。Semibot 会自动启动一个 Node.js 桥接进程（discord_gateway_bridge.mjs），通过 Discord Gateway WebSocket 接收事件并转发到 Runtime。实例模式需设为 gateway、ws 或 socket。桥接进程会自动重连，每 5 秒检查一次状态。

4. 权限配置

在 Discord Developer Portal 的「Bot」页面，确保开启以下 Privileged Gateway Intents：Message Content Intent（接收消息内容）、Server Members Intent（可选，用于成员信息）。Bot 权限建议：Send Messages、Read Message History、Embed Links、Attach Files、Add Reactions。

5. 联调与验证

1. 在 Semibot 中点击「测试」确认出站链路可达。2. 在 Discord 服务器中 @Bot 发送消息。3. 在 Semibot 事件中心确认收到入站事件。4. 在会话详情查看执行记录和回传结果。常见错误：Bot 未上线（检查 Token 和桥接进程状态）、无法接收消息（检查 Message Content Intent 是否开启）、权限不足（检查 Bot 在服务器中的角色权限）。