接入 Discord
AstrBot v3.5.16 及之后,支持接入 Discord 消息平台。
创建 AstrBot Discord 平台适配器
进入消息平台,点击新增适配器,找到 Discord 并点击进入 Discord 配置页。


本次教程只用管1,2,3,5项
- 机器人名称:自定义,方便区分不同适配器
- 启用:勾选后启用该适配器
- Bot Token:在 Discord 创建 App 后获取的 Token(见下文)
- Discord 代理地址:如果你需要使用代理访问 Discord,可以在这里填写代理地址(可选)
- 是否自动将插件指令注册为 Discord 斜杠指令:勾选后,AstrBot 会自动将已安装插件中的指令注册为 Discord 斜杠指令,方便用户使用。
在 Discord 创建 App
- 前往 Discord,点击右上角蓝色按钮,输入应用名字,创建应用。

- 点击左边栏的 Bot,点击 Reset Token 按钮,创建好 Token 后,点击 Copy 按钮,将 Token 填入配置中的 Discord Bot Token 处。
4. 下滑找到这三个选项全开启

- Presence Intent:允许机器人获取用户在线状态
- Server Members Intent:允许机器人获取服务器成员信息
- Message Content Intent:允许机器人读取消息内容
- 点击左边栏的 OAuth2,在 OAuth2 URL Generator 中选中
Bot也就是这样
然后在下方出现的 Bot Permissions 处选择允许的权限。一般来说,建议添加如下权限: - Send Messages
- Create Public Threads
- Create Private Threads
- Send TTS Messages
- Manage Messages
- Manage Threads
- Embed Links
- Attach Files
- Read Message History
- Add Reactions 如果你觉得麻烦也可以直接使用administrator权限,但仍然建议在使用环境中使用上文的配置权限(或您自己需要的权限)
记住,权限越高,风险越大。
复制下方出现的 Generated URL。打开这个 URL,将 Bot 添加到所需要的服务器。

进入 Discord 服务器,你的机器人应该已经提示在线了
@ 刚刚创建的机器人(也可以不 @),输入 /help,如果成功返回,则测试成功。
故障排除
- 如果卡在最后的步骤,机器人不在线请确定自己的服务器可以直接连接discord
如果有疑问,请提交 Issue。

