☀️ 夏季促销：使用优惠码 享终身 9 折

设置 Red Discord Bot

在 ServerPrism 上运行 Red 的分步指南 — 从在 Discord 开发者门户中创建机器人到加载您的第一个 cog。

Last updated May 25, 2026

本指南将引导您在 ServerPrism 上设置 Red Discord Bot，从在 Discord 开发者门户中创建机器人到声明所有者并加载您的第一个 cog。

开始之前

您需要一个 Discord 帐户和一个您拥有 管理服务器 权限的服务器。

1. 在 Discord 开发者门户中创建您的机器人

  1. 访问 discord.com/developers/applications 并点击 New Application。
  2. 给它一个名称（这是您机器人的身份 — 选择一个您满意的名称），接受条款，然后点击 Create。
  3. 在左侧边栏中，点击 Bot。
  4. 在机器人用户名下方，点击 Reset Token 并将令牌复制到安全的地方。您稍后会将其粘贴到 ServerPrism 中。请像对待密码一样对待它 — 任何拥有它的人都可以控制您的机器人。

2. 启用特权网关意图 (Privileged Gateway Intents)

这一步至关重要 — 如果没有启用所有三个意图，Red 将拒绝启动，并以 CONFIGURATION_ERROR（退出代码 78）退出。

仍在 Bot 页面上，向下滚动到 Privileged Gateway Intents 并打开：

  • Presence Intent
  • Server Members Intent
  • Message Content Intent

点击底部的 Save Changes。

3. 邀请机器人到您的 Discord 服务器

  1. 在左侧边栏中，点击 OAuth2 → URL Generator。
  2. 在 Scopes 下，勾选 bot 和 applications.commands。
  3. 在 Bot Permissions 下，勾选您希望它拥有的权限。对于大多数设置，Administrator 是最简单的起点 — 您以后可以收紧权限。
  4. 复制底部生成的 URL，在新标签页中打开它，选择您的 Discord 服务器，然后授权。

机器人将加入您的服务器，但在您在 ServerPrism 上启动它之前将显示为离线。

4. 在 ServerPrism 上订购 Red Discord Bot

  1. 访问我们网站上的 Discord Bots 类别 并选择 Red Discord Bot 产品。
  2. 选择一个计划（1 GB RAM 对于大多数设置来说足够了），选择一个离您较近的区域，然后结账。
  3. 订购时，您将被要求提供：
    • Discord Bot Token — 粘贴步骤 1 中的令牌。
    • Command Prefix — 用户在命令前输入的字符，例如 ! 或 <。您以后可以在 Discord 中更改此项。
  4. 配置完成后，面板将安装 Red 并启动机器人。首次安装需要几分钟（pip 安装 + 依赖项）。

5. 在 Discord 中声明所有权

当机器人在线时，您需要告诉 Red 谁是它的所有者，以便您可以运行管理命令。

  1. 在 Discord 中，私信您的机器人命令 <set owner（将 < 替换为您的前缀）。

  2. Red 将在面板控制台中打印一个一次性确认令牌 — 您会看到类似以下内容：

    Use the command [p]set owner XXXXXX in DM to confirm

  3. 从控制台复制该确认令牌，然后私信机器人：

    <set owner XXXXXX

  4. Red 回复“I now recognise you as my owner.”。您已完成 — 管理命令现在对您有效。

6. 加载您的第一个 cog

Cogs 是 Red 的插件。要启用下载和安装它们：

<load downloader
<repo add aikaterna-cogs https://github.com/aikaterna/aikaterna-cogs
<cog install aikaterna-cogs trivia
<load trivia

浏览 Red Cogs 索引 以获取数百个其他 cog。每个 cog 的页面上都有安装说明。

常见问题

首次启动时出现“redbot: command not found”

安装程序未完成。这是我们 Red egg 中一个已知的错误，现已修复 — 如果您在全新安装时遇到此问题，请提交支持工单，我们将重新安装您服务器上的 egg。

“You need to configure the bot instance using redbot-setup prior to running the bot”

实例配置文件丢失。与上述相同 — 提交工单，我们将进行修补。从面板重新安装服务器也可以在新部署的 egg 上修复此问题。

退出代码 78 / “Red requires all Privileged Intents to be enabled”

返回上面的步骤 2，并在 Discord 开发者门户中启用所有三个特权意图。它们默认是关闭的。

机器人在线但不响应命令

两个常见原因：

  1. Message Content Intent 已关闭 — 重新检查步骤 2。没有此权限，机器人无法看到消息文本。
  2. 您使用了错误的前缀 — 检查您的面板控制台以获取机器人启动时使用的前缀，或者在 Discord 中使用 @YourBot prefix（提及机器人总是有效，无论前缀如何）。

更改机器人的前缀

<set prefix !

新前缀立即生效。

获取帮助

对于 Red 特定的问题，官方 Red 文档 是最好的资源。对于 ServerPrism 托管问题 — 账单、计划更改、性能 — 请提交支持工单，我们将尽快回复您。