消息通道
Discord 接入
配置 Bot Token 与消息内容权限，验证频道、Thread 和回复。
应用、机器人与服务器分别准备
Nexus 通过 Discord Gateway 接收消息，通过 REST 接口回复。需要一个自己的 Discord 应用及其 Bot Token，并有权把机器人加入测试服务器。
先在 Nexus 内确认目标 Agent 能完成普通对话，再在 Discord 开发者后台核对应用。Application ID 标识应用，Bot Token 用于连接，Client Secret 不能替代 Bot Token。
配置机器人接收消息
在应用的 Bot 设置中检查 Message Content Intent。当前 Nexus 连接会请求服务器消息、私聊消息及消息内容相关 Intent；平台未允许对应特权 Intent 时，Gateway 连接可能被拒绝。是否还需平台审核，以应用规模和 Discord 当前要求为准。Discord Gateway 权限说明
这项设置控制事件与内容访问。机器人在某个频道能否查看和发送消息，还要检查服务器角色及频道权限。
在 Nexus 保存字段
打开 能力 → 频道 → Discord。
| 字段 | 内容 | 常见填错 |
|---|---|---|
| Application ID | General Information / OAuth2 中的应用 ID | 填了服务器 ID |
| Bot Token | Bot 页生成的令牌 | 填了 Client Secret |
| REST API Base URL | 通常保留 https://discord.com/api/v10 | 填了网页或 Gateway 地址 |
保存后使用页面提供的授权链接，将对应机器人加入测试服务器。核对授权页面中的应用与目标服务器，不只检查链接是否能打开。
机器人加入服务器后，在测试频道确认它能查看频道并发送消息。Thread 有自己的访问与发送条件，应单独检查。
配对并验证频道
从真人账号在测试频道向机器人发送请求，打开 Nexus 能力 → 配对，核对该频道对应的外部关系，绑定到目标 Agent 与会话。随后再发一条带有明确标记的测试文字。
这是 Discord 频道连接测试，请只回复“频道测试已收到”。
检查 Nexus 内请求进入预期会话，回复出现在原频道。私聊、服务器频道和 Thread 应分别验证；一次私聊成功不能说明机器人拥有服务器频道的发送权限。
Thread 为什么要另查
Nexus 支持将回复送到对应 Thread。主频道可以发送而 Thread 失败时，先检查机器人能否访问该 Thread、Thread 当前状态以及配对目标，避免重建已经正常工作的应用配置。
先用文本测试，再处理业务附件与文件交付。不同平台支持的消息能力不同，不把 Nexus 工作区中的文件链接视为已经上传到 Discord 的附件。
接收与回复分开排错
| 失败阶段 | 检查内容 |
|---|---|
| Gateway 连接失败 | Bot Token、网络和 Message Content Intent |
| 机器人在线但无请求 | 频道可见范围、实际发送位置与配对 |
| 请求已进入 Nexus | 目标 Agent、模型和待处理审批 |
| Nexus 完成但频道无回复 | REST 请求错误、频道或 Thread 的发送权限 |
REST 地址与 Gateway 连接承担不同作用，修改其中一个不会自动修复另一个。更换令牌后在 Nexus 更新配置，并完成一条新消息的接收与回复。恢复失败投递前，先确认原频道没有收到重复消息。