SemibotDiscord Bot 详细配置
适用于 Discord Bot 接入。Discord 这边走的是网关连接，不是普通 Webhook。
1. 前置准备
先去 Discord Developer Portal（discord.com/developers）创建应用。在「Bot」页面点「Add Bot」创建机器人并拿到 Bot Token。再到「OAuth2 > URL Generator」里勾上 bot 和 applications.commands，生成邀请链接，把机器人拉进目标服务器。
2. 在 Semibot 创建 Bot 实例
打开 Semibot 配置中心，进入 Bots > 新建，选择 Discord。填好 Bot Token；如果你需要校验入站事件或识别 @提及，也可以补 webhookSecret 和 botUserId。选好默认智能体后保存。
3. 连接机制
Discord 这边不用配 Webhook URL，它走的是 WebSocket 网关。Semibot 会自动拉起桥接进程，接收 Discord Gateway 的事件，再转给执行服务。桥接进程会自动重连，所以大多数时候你只要确认它已经起来了就行。
4. 权限配置
在 Discord Developer Portal 的「Bot」页面，至少把 Message Content Intent 打开，不然机器人收不到消息内容。Server Members Intent 不是必须，但有些场景会用到。Bot 权限通常建议开 Send Messages、Read Message History、Embed Links、Attach Files 和 Add Reactions。
5. 联调与验证
先在 Semibot 里点「测试」，确认消息能发出去。再到 Discord 服务器里 @Bot 发一条消息，到事件中心看有没有入站事件，最后去会话详情确认执行过程和回传结果。常见问题一般是三类：Token 不对、桥接进程没起来，或者消息权限没开。
FAQ
Discord Bot 接入最常见的问题是什么？
最常见的是 Token 配错、网关连接没起好，或者消息权限没开。建议先确认 Bot 在线状态，再检查 Message Content Intent 和服务器权限。
为什么机器人在线但不回消息？
通常是消息内容权限没开，或者 Bot 在目标服务器/频道里没有足够权限。可以先从 Discord 开发者后台和频道权限开始查。
Discord 接入前要先完成本地安装吗？
建议先完成本地安装和基础启动。这样接 Discord 时，如果链路有问题，更容易分清是本地服务还是平台配置导致的。