Skip to content
本站由雨云提供云计算服务

接入 Discord

AstrBot v3.5.16 及之后,支持接入 Discord 消息平台。

创建 AstrBot Discord 平台适配器

进入消息平台,点击新增适配器,找到 Discord 并点击进入 Discord 配置页。

点击创建机器人,选择discord类型

选项从上到下依次是 1.机器人名称 2. 启用 3. Bot token 4. Discord 代理地址 5. 是否自动将插件指令注册为 Discord 斜杠指令 6. discord_guild_id_for_debug 7.Discord 活动名称

本次教程只用管1,2,3,5项

  • 机器人名称:自定义,方便区分不同适配器
  • 启用:勾选后启用该适配器
  • Bot Token:在 Discord 创建 App 后获取的 Token(见下文)
  • Discord 代理地址:如果你需要使用代理访问 Discord,可以在这里填写代理地址(可选)
  • 是否自动将插件指令注册为 Discord 斜杠指令:勾选后,AstrBot 会自动将已安装插件中的指令注册为 Discord 斜杠指令,方便用户使用。

在 Discord 创建 App

  1. 前往 Discord,点击右上角蓝色按钮,输入应用名字,创建应用。

创建bot(输入名字)

  1. 点击左边栏的 Bot,点击 Reset Token 按钮,创建好 Token 后,点击 Copy 按钮,将 Token 填入配置中的 Discord Bot Token 处。

token选项 4. 下滑找到这三个选项全开启

Presence Intent,Server Members Intent,Message Content Intent截图

  • Presence Intent:允许机器人获取用户在线状态
  • Server Members Intent:允许机器人获取服务器成员信息
  • Message Content Intent:允许机器人读取消息内容
  1. 点击左边栏的 OAuth2,在 OAuth2 URL Generator 中选中 Bot 也就是这样 OAuth2 URL Generator 然后在下方出现的 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权限,但仍然建议在使用环境中使用上文的配置权限(或您自己需要的权限)

记住,权限越高,风险越大。

  1. 复制下方出现的 Generated URL。打开这个 URL,将 Bot 添加到所需要的服务器。 Generated URL位置

  2. 进入 Discord 服务器,你的机器人应该已经提示在线了 机器人在线 @ 刚刚创建的机器人(也可以不 @),输入 /help,如果成功返回,则测试成功。

故障排除

  • 如果卡在最后的步骤,机器人不在线请确定自己的服务器可以直接连接discord

如果有疑问,请提交 Issue

Deployed on Rainyun Logo