跳到主要内容

Discord

Anyy 使用 Discord Bot Token 和官方 Gateway Profile 连接。当前 Adapter 支持私聊、服务器频道、Discord Thread、入站附件、Pairing 和在线健康检查。

1. 创建 Discord Application

在 Discord Developer Portal:

  1. 创建 Application,并添加 Bot User;
  2. 把 Bot Token 保存到安全的密码管理器;
  3. 根据准备启用的会话设置 Gateway Intents;
  4. 把 Bot 安装到目标服务器,并只授予读取/发送消息所需权限。

Anyy 会根据策略计算所需 Intent:私聊需要 Direct Message Intent;启用服务器消息需要 Guild Message Intent;Group Policy 为 openallowlist 时还需要 Message Content Intent。Dashboard 会列出匹配的外部前置条件。

2. 添加到 Anyy

进入 Dashboard → ChannelsAdd channelDiscord,选择 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 在哪里可以读写消息。

修改策略后,Intent 也可能需要变化

扩大 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 见 消息平台