如何创建 Discord 机器人：新手完全指南

如果你正在设置 Beatra Custom Bot，首先需要拥有自己的 Discord 机器人——一个带有令牌并启用了正确 intents 的应用。本指南将带你逐步完成整个过程。更喜欢看视频？下方附有完整的视频教程链接。

🎥 视频教程： https://www.youtube.com/watch?v=qddwRsNU2X8

创建 Discord 机器人是免费的，只需几分钟即可完成。请按顺序依次操作。

第一步 —— 打开 Discord Developer Portal

前往 Discord Developer Portal（网址：https://discord.com/developers/applications），并使用你的 Discord 账户登录。这是创建和管理所有 Discord 机器人的官方入口。

第二步 —— 创建新应用

点击右上角的 New Application。为其命名——这是你机器人的项目名称，之后可以更改——接受条款并点击 Create。现在你已经拥有一个应用了。

第三步 —— 打开 Bot 标签页

在左侧边栏中点击 Bot 标签页。Discord 会自动为你的应用创建一个机器人用户。在这里你可以设置机器人的用户名和头像，这也是你的社区将会看到的内容。

第四步 —— 启用 Privileged Gateway Intents

这是最重要的一步，也是最常被忽略的一步。向下滚动到 Privileged Gateway Intents，并开启 全部三项：

• Presence Intent
• Server Members Intent
• Message Content Intent

Beatra 需要 Message Content Intent 来读取指令，其余两项则用于确保机器人在你的服务器中正常运作。如果这些选项未开启，你的机器人将无法启动或响应。启用后点击 Save Changes。

第五步 —— 将机器人设为公开

仍在 Bot 标签页中，找到 Public Bot 设置项，确保将其开启。这样你——以及 Beatra 的 onboarding 流程——才能通过邀请链接将机器人添加到你的服务器。如果该选项处于关闭状态，将只有你本人能够添加它，设置可能会因此失败。

第六步 —— 复制你的令牌

在 Bot 标签页顶部，点击 Reset Token 并确认。Discord 仅会显示一次 你的机器人令牌——请点击 Copy 进行复制。

⚠️ 请妥善保管你的令牌。 任何拥有你令牌的人都能完全控制你的机器人。切勿分享或公开发布令牌。如果令牌泄露，请回到此页面重置。Beatra 会以完全加密的方式存储你的令牌，并且不会再次显示它。

第七步 —— 将令牌粘贴到 Beatra

返回 Beatra Custom Bot 的 onboarding 界面，将令牌粘贴到令牌输入框中。在继续之前，Beatra 会验证令牌，并检查 Message Content Intent 是否已启用。如果出现 intent 相关的错误提示，请返回第四步，启用相应的 intents，保存后再重试。

常见问题

• “Message Content Intent is disabled” —— 说明你跳过了第四步。请启用全部三项 intents 并保存。
• “Invalid token” —— 说明令牌复制有误，或之后又被重置过。请重新 Reset Token 并复制最新的令牌。
• 无法将机器人添加到服务器 —— Public Bot 未开启（见第五步），或你在该服务器没有 “Manage Server” 权限。

大功告成

一旦令牌通过验证，Beatra 会为你设置好机器人，并提供一个邀请链接。从此，你的 Custom Bot 将以你自己的名义运行完整的 Beatra 体验。想了解该功能的更多详情，请阅读Custom Bot 正式发布。