Discord
Anyy 使用 Discord Bot Token 和官方 Gateway Profile 连接。当前 Adapter 支持私聊、服务器频道、Discord Thread、入站附件、Pairing 和在线健康检查。
1. 创建 Discord Application
在 Discord Developer Portal:
- 创建 Application,并添加 Bot User;
- 把 Bot Token 保存到安全的密码管理器;
- 根据准备启用的会话设置 Gateway Intents;
- 把 Bot 安装到目标服务器,并只授予读取/发送消息所需权限。
Anyy 会根据策略计算所需 Intent:私聊需要 Direct Message Intent;启用服务器消息需要 Guild Message Intent;Group Policy 为 open 或 allowlist 时还需要 Message Content Intent。Dashboard 会列出匹配的外部前置条件。
2. 添加到 Anyy
进入 Dashboard → Channels → Add channel → Discord,选择 Bot Gateway,填写 Token,再选择 DM 和 Group Policy。
CLI 设置:
anyy setup channel discord
Token 会作为 Profile Secret 保存。启用时,Anyy 会同时验证 Bot 身份和 Application 身份,再接受连接。
3. 选择访问策略
Discord 私聊默认 pairing,群组默认 mention。
| Policy | 私聊 | 服务器频道 |
|---|---|---|
pairing | 支持 | 支持 |
allowlist | 支持 | 支持 |
open | 支持 | 支持 |
mention | — | 支持 |
disabled | 支持 | 支持 |
Sender Allowlist 使用 Discord User ID;群组限制使用渠道设置页给出的 Channel/Guild 身份。
4. 验证连接
anyy channel reload
anyy channel doctor discord
向 Bot 私聊,或在允许的服务器频道 Mention。Pairing 模式下批准新 Sender:
anyy channel pairing list --channel discord
anyy channel pairing approve --request REQUEST_ID
Thread 与附件
Discord Thread 身份会保留在会话路由里,回复会回到同一 Thread。入站附件通过媒体上限检查后,下载到有作用域的 Anyy 会话。
Discord 侧不要授予 Bot 超出需要的权限。Anyy 控制模型和工具权限,Discord 权限则决定 Bot 在哪里可以读写消息。
扩大 Group Policy 时,同步更新 Discord Gateway Intents,再 Reload Anyy。Token 有效不代表 Discord 一定会投递消息事件。
常见问题
| 现象 | 检查项 |
|---|---|
| Bot 认证成功但收不到服务器消息 | 检查 Intents、Bot 安装、频道权限与 Group Policy |
| 只有 Mention 才响应 | 默认 mention 策略下属于正常行为 |
| 私聊等待批准 | 批准 Pairing Request 后重新发 DM |
| 回复位置不对 | 确认事件带有目标 Channel/Thread 身份 |
| 附件缺失 | 检查 Discord URL、文件大小、媒体上限和诊断结果 |
通用 Pairing 和 Reload 见 消息平台。