@@ -6,22 +6,37 @@ AstrBot v3.5.16 及之后,支持接入 [Discord](https://discord.com/) 消息
66
77进入消息平台,点击新增适配器,找到 Discord 并点击进入 Discord 配置页。
88
9- ![ ] ( ../../source/images/discord/image.png )
9+ ![ 点击创建机器人,选择discord类型 ] ( ../../source/images/discord/image.png )
1010
11- 在弹出的配置对话框中点击 ` 启用 ` 。
11+ ![ 选项从上到下依次是 1.机器人名称 2. 启用 3. Bot token 4. Discord 代理地址 5. 是否自动将插件指令注册为 Discord 斜杠指令 6. discord_guild_id_for_debug 7.Discord 活动名称] ( ../../source/images/discord/image-3.png )
12+ > 本次教程只用管1,2,3,5项
1213
14+ - 机器人名称:自定义,方便区分不同适配器
15+ - 启用:勾选后启用该适配器
16+ - Bot Token:在 Discord 创建 App 后获取的 Token(见下文)
17+ - Discord 代理地址:如果你需要使用代理访问 Discord,可以在这里填写代理地址(可选)
18+ - 是否自动将插件指令注册为 Discord 斜杠指令:勾选后,AstrBot 会自动将已安装插件中的指令注册为 Discord 斜杠指令,方便用户使用。
1319## 在 Discord 创建 App
1420
15211 . 前往 [ Discord] ( https://discord.com/developers/applications ) ,点击右上角蓝色按钮,输入应用名字,创建应用。
1622
17- ![ ] ( ../../source/images/discord/image-1.png )
23+ ![ 创建bot(输入名字) ] ( ../../source/images/discord/image-1.png )
1824
19252 . 点击左边栏的 Bot,点击 Reset Token 按钮,创建好 Token 后,点击 Copy 按钮,将 Token 填入配置中的 Discord Bot Token 处。
20- 3 . 下滑找到这三个选项全开启
2126
22- ![ ] ( ../../source/images/discord/image-2.png )
27+ ![ token选项] ( ../../source/images/discord/image-4.png )
28+ 4 . 下滑找到这三个选项全开启
2329
24- 4 . 点击左边栏的 OAuth2,在 OAuth2 URL Generator 中选中 ` Bot ` ,然后在下方出现的 Bot Permissions 处选择允许的权限。一般来说,建议添加如下权限:
30+ ![ Presence Intent,Server Members Intent,Message Content Intent截图] ( ../../source/images/discord/image-2.png )
31+
32+ - Presence Intent:允许机器人获取用户在线状态
33+ - Server Members Intent:允许机器人获取服务器成员信息
34+ - Message Content Intent:允许机器人读取消息内容
35+
36+ 5 . 点击左边栏的 OAuth2,在 OAuth2 URL Generator 中选中 ` Bot `
37+ 也就是这样
38+ ![ OAuth2 URL Generator] ( ../../source/images/discord/image-6.png )
39+ 然后在下方出现的 Bot Permissions 处选择允许的权限。一般来说,建议添加如下权限:
2540 - Send Messages
2641 - Create Public Threads
2742 - Create Private Threads
@@ -32,8 +47,17 @@ AstrBot v3.5.16 及之后,支持接入 [Discord](https://discord.com/) 消息
3247 - Attach Files
3348 - Read Message History
3449 - Add Reactions
35- 4 . 复制下方出现的 GENERATED URL。打开这个 URL,将 Bot 添加到所需要的服务器。
36- 5 . 返回 AstrBot,在填好 Discord Bot Token 后,点击保存。
37- 6 . 进入 Discord 服务器,@ 刚刚创建的机器人(也可以不 @),输入 ` /help ` ,如果成功返回,则测试成功。
50+ 如果你觉得麻烦也可以直接使用administrator权限,但仍然建议在使用环境中使用上文的配置权限(或您自己需要的权限)
51+ > 记住,权限越高,风险越大。
52+
53+ 6 . 复制下方出现的 Generated URL。打开这个 URL,将 Bot 添加到所需要的服务器。
54+ ![ Generated URL位置] ( ../../source/images/discord/image-5.png )
55+
56+ 7 . 进入 Discord 服务器,你的机器人应该已经提示在线了
57+ ![ 机器人在线] ( ../../source/images/discord/image-7.png )
58+ @ 刚刚创建的机器人(也可以不 @),输入 ` /help ` ,如果成功返回,则测试成功。
59+
60+ # 故障排除
61+ - 如果卡在最后的步骤,机器人不在线请确定自己的服务器可以直接连接discord
3862
3963如果有疑问,请[ 提交 Issue] ( https://github.com/AstrBotDevs/AstrBot/issues ) 。
0 commit comments