第9篇博客文章的背景图片

在Discord上部署你的AI聊天机器人

想为你的Discord服务器创建一个聪明的对话式AI机器人吗?这份分步指南将带你完成整个过程,只需10分钟,无需编写代码!

观看视频


创建AI机器人的5个简单步骤

按照以下步骤操作,你就能在Discord服务器中运行一个功能完整的AI聊天机器人

  1. 创建Discord服务器
  2. 创建Discord应用
  3. 将机器人添加到服务器
  4. 创建Quickchat AI账户
  5. 将Discord机器人与Quickchat AI集成

你的AI机器人会是什么样子?

设置完成后,机器人就会在Discord上运行,随时与服务器成员进行自然对话

最终效果:聪明的对话式AI


最快的方法:一键连接

如果你已经有Quickchat AI账户,可以完全跳过Developer Portal。在控制台左侧边栏打开External Apps,选择Discord,然后在Connect下点击Add to your Discord server

Quickchat AI的Discord连接界面及Add to your Discord server按钮 External Apps → Discord中的一键连接界面。

Discord会要求你授权共享的Quickchat AI应用并选择服务器。点击Authorize后,机器人即可上线,成员可以在频道中通过**@提及它来使用。唯一要求是你在所选服务器中拥有Manage Server**权限。

新注册的Quickchat AI用户会进入Discord专属引导界面,直接开始这一连接流程。

Quickchat AI新用户看到的Discord专属引导界面 新用户从Discord专属引导界面开始,随后进入一键连接流程。

以下步骤介绍手动连接方式,也就是Use your own Discord app选项:自行创建Discord应用,再使用机器人令牌连接。如果你希望自定义机器人名称和头像、使用私信或Discord AI Actions,或者在一个服务器中运行多个机器人,请选择这条路径。Discord Actions需要使用你自己的机器人连接,因为该连接提供调用Discord API所需的令牌。


1. 创建Discord服务器

如果你还没有Discord账户,请前往discord.com注册,然后设置你的第一个服务器:

创建第一个服务器


2. 创建Discord应用

前往**Discord Developer Portal**,创建一个新应用。

创建新应用


3. 将机器人添加到Discord服务器

记得打开下方开关,允许机器人接收消息内容:

启用消息内容访问

创建机器人后,需要将它添加到服务器。方法是构造一个Discord URL,然后粘贴到浏览器中打开:

https://discord.com/api/oauth2/authorize?client_id=<YOUR CLIENT ID>&permissions=309237713920&scope=bot

权限数字是怎么来的?

权限数字(309237713920)对应以下权限:

  • View Channels
  • Send Messages
  • Create Public Threads
  • Send Messages in Threads
  • Read Message History

这些是机器人正常运行所需的最低权限。你可以前往discord.com/developers/applications,选择自己的应用,点击左侧的Bot,然后向下滚动查看:

Discord机器人的权限

在哪里找到YOUR CLIENT ID?

最简单的方法是查看浏览器地址栏,复制URL中的那串长数字:

https://discord.com/developers/applications/<YOUR CLIENT ID>/bot

客户端ID

本例中的客户端ID是1234567890123456789,因此,将机器人添加到服务器时需要打开的完整URL为:

https://discord.com/api/oauth2/authorize?client_id=1234567890123456789&permissions=309237713920&scope=bot

如果这一步遇到问题:

  • “Integration requires code grant”:你的应用启用了Require OAuth2 Code Grant。在Developer Portal中打开应用,进入Bot,关闭该选项并保存,然后重新打开邀请URL。(详细说明
  • 出现蛋糕或“baked”界面:这是Discord的成功页面,说明机器人已经添加。请在Server Settings → Integrations → Bots and Apps中确认。
  • 提示:将机器人令牌粘贴到Quickchat AI控制台后(第5步),Discord集成页面会自动生成邀请URL并显示设置清单,因此你可以跳过上面的手动拼接步骤。

4. 创建Quickchat AI账户

注册**Quickchat AI,为机器人提供像真人一样自然的对话式AI**。

Quickchat AI让你能够创建具备自定义知识库、AI Actions等功能的AI智能体,适用于Discord机器人、网站等场景


5. 将机器人与Quickchat AI集成

要将机器人连接到Quickchat AI,请从Developer Portal获取Discord Bot Token

  1. 依次进入Bot SettingsReset TokenCopy Token

重置令牌

  1. Quickchat AI控制台中打开External Apps → Discord,选择Use your own Discord app,然后粘贴令牌。Quickchat AI会启动机器人,并在启动过程中显示状态。

粘贴令牌

如果机器人没有上线

机器人启动失败时,Discord集成页面会显示具体错误,并提供直达解决方法的链接。最常见的两种情况是:

  • Invalid token:令牌不正确或已重新生成,重置令牌会使旧令牌失效。在Developer Portal中打开机器人,进入Bot → Reset Token,复制新令牌,然后在Quickchat AI中点击Reconnect并粘贴。具体界面见Invalid bot token
  • Message Content Intent未开启(显示为PrivilegedIntentsRequired):机器人已经连接,但无法读取消息。在Developer Portal中打开机器人,进入Bot → Privileged Gateway Intents,打开Message Content Intent并保存。具体开关见Message Content Intent

每次更改令牌或设置后,机器人都会重启,请等待最多约一分钟让它上线。

如果你自己的机器人在线却从不回复

检查共享的一键连接Quickchat AI机器人是否仍在同一个服务器中。当两个机器人同时存在时,共享机器人会回复,而你自己的机器人会保持安静,即使令牌、意图设置和权限都正确。在Quickchat AI控制台打开External Apps,在一键设置的Connected servers下找到该服务器,并从那里移除。你自己的机器人会立即接管。参见Both bots are in the same server


你的AI机器人已经上线!

回到Discord,机器人应该已经在线并准备好聊天了。只需**@提及**它即可开始对话。

正在运行的机器人

被**@提及时,机器人默认直接在频道中回复。如果在Reply in设置中选择Thread**,它会创建一个讨论串,用户可以在其中继续对话,无需再次提及机器人。

讨论串中的对话


机器人如何回应

机器人可以通过多种方式触发,不同方式对会话历史的处理也不同:

场景触发方式会话历史
在频道中@提及在任意文字频道@提及机器人取决于Reply in设置(见下文)
在机器人讨论串中发消息向机器人创建的讨论串发送消息保留整个讨论串的历史
回复机器人消息对机器人消息使用Discord的回复功能每次开始新对话
/ask斜杠命令输入/ask和问题(仅限一键连接机器人)每次开始新对话
私信向机器人发送DM(仅限自己的应用)在整个私信会话中保留

在频道中发送普通消息不会触发机器人。这是有意的设计,可以让机器人在繁忙服务器中保持安静,也是刚添加的机器人看起来像“坏了”最常见的原因。/ask也提供了一种更容易发现的使用方式:在任何频道输入/都能看到它,而且在消息内容访问受限的地方也能使用。它注册在共享的一键连接机器人上,因此,如果连接的是自己的应用,请使用@提及。

“Reply in”设置

Quickchat控制台的Channels > External Apps > Discord下,有一个包含两个选项的**“Reply in:”**下拉菜单:

  • Channel(默认):直接在被提及的频道中回复。每次@提及都会开始一个新对话,不记忆之前的互动。
  • Thread:每次@提及都会创建一个新讨论串。讨论串以机器人和用户名命名,例如“Aria & john_doe”。在讨论串内,机器人会回复每条消息,无需@提及,并保留完整会话历史。

私信

私信需要使用你自己的Discord应用。共享的一键连接机器人只在服务器内回复,因为用同一个共享身份响应主动发来的私信,会影响它服务的所有服务器。

使用自己的应用时,在私信中无需@提及。机器人会回复每条消息,并在整个会话中保留历史。回复私信时,它无法访问服务器频道历史。

注意: 机器人只会在自己创建的讨论串中回复。如果有人手动创建讨论串并在其中发言,机器人不会回应。


机器人如何理解频道上下文

当有人在频道中@提及机器人时,它看到的不只是包含提及的那一条消息。它会自动获取频道中的近期消息,并以带时间戳的会话记录形式加入AI提示词。因此,它能够理解正在进行的讨论,并引用前面的发言。

从AI视角来看,上下文示例如下:

Most recent messages on the #general channel:
[2026-02-19 14:01] alice: Has anyone tried the new API endpoint?
[2026-02-19 14:03] bob: Yeah, I got a 429 back after about 50 requests
[2026-02-19 14:05] alice: @QuickchatBot what's the rate limit for the v2 API?

机器人还会读取频道中活跃讨论串和已归档讨论串的消息,因此讨论串讨论也会包含在上下文中。

当有人使用Discord回复功能回应某条消息时,机器人会把上下文缩小到被回复消息前后的内容,而不是获取全部近期历史。这能为用户所指的具体讨论提供更有针对性的上下文。

消息中的特殊内容,如贴纸、GIF、图片、嵌入内容和表情回应,会以注释形式表示。即使机器人无法在会话记录中直接看到图像,也能知道这些内容的存在。@提及标记会替换为易读的显示名称。

无需配置。所有Quickchat AI Discord机器人都默认启用频道上下文。

机器人利用频道上下文回答后续问题

智能搜索整个服务器的历史

默认情况下,机器人只读取被提及频道中的消息。启用Smart AI search over server history后,AI可以查询服务器内任意文字频道的消息,并根据用户问题决定查看哪个频道。

例如,有人在#general中问“#engineering对迁移问题最后是什么结论?”,机器人可以读取#engineering的近期历史,并根据找到的信息回答。

该功能还支持时间范围筛选和分页,因此需要时可以继续查找更早的历史。

模式范围适合用途
默认仅当前频道通用社区机器人
Smart AI search over server history服务器内任意频道支持机器人、跨频道知识检索

注意: Smart AI search over server history目前处于测试阶段。如果感兴趣,请通过电子邮件或Quickchat Discord服务器联系我们。

Discord集成设置中的Smart AI search over server history开关


向机器人发送图片

用户在@提及机器人时可以附加图片,AI会使用视觉能力处理它。支持PNG、JPG、JPEG、GIF和WebP格式。如果附加多张图片,机器人会处理第一张。

Discord CDN上的图片URL会和消息文字一起作为多模态输入传给AI模型,因此AI能在同一轮对话中同时看到文字和图片。无需配置,图片理解默认开启。

以下是Discord社区的一些实际用法:

  • 开发者社区:用户发送堆栈跟踪或错误消息的截图,请机器人解释
  • 设计社区:用户分享UI原型,请机器人提供反馈
  • 游戏社区:用户分享游戏设置截图,请机器人给出优化建议
  • 电商支持:客户向支持机器人发送有缺陷产品的照片

用户向机器人发送截图,机器人分析图片并回答问题


将AI Actions连接到Discord

AI Actions让机器人能够在Discord对话期间调用外部API和工具。在Quickchat控制台的AI Agent > Actions & MCPs中配置一次,即可用于所有频道,包括Discord、网站组件、WhatsApp、Telegram等。

可使用两类操作:

操作类型功能
API Action向外部端点发送HTTP请求(GET、POST、PUT、DELETE),支持配置参数、请求头和请求体
Remote MCP连接Model Context Protocol服务器,访问外部工具和数据源

以下是使用AI Actions可在Discord中构建的功能:

  • 订单追踪机器人:将API Action连接到电商后端,让社区成员可以询问“订单#12345到哪里了?”并获得实时状态。
  • GitHub问题机器人:将Remote MCP连接到GitHub仓库,让开发者可以直接在Discord中问“有没有带critical标签的未解决错误?”
  • 支持工单机器人:从文档中回答问题,只为无法解决的情况打开会提醒支持身份组的私密工单讨论串
  • 管理助手:选择禁言、踢出、封禁和慢速模式模板,让管理员用自然语言执行操作。
  • 会议预约机器人:将Remote MCP连接到Cal.com或Google Calendar,让用户通过Discord预约与团队的会议。
  • CRM集成:连接HubSpot,让机器人从Discord对话中记录潜在客户或创建支持工单。
  • 线索与反馈记录:连接Google Sheets,让机器人把Discord对话中的潜在客户、未回答问题和演示请求直接写入团队现有的电子表格。

设置API Action

  1. 在Quickchat控制台进入AI Agent > Actions & MCPs
  2. 点击Add Action。对于已支持的Discord操作,选择Discord Action并挑选模板。支持模板会要求选择服务器、频道和身份组;管理模板则可以直接安装。Quickchat会为你创建可编辑的请求、说明、参数、响应处理和运行条件。
  3. 只有需要图库之外的端点时,才选择自定义HTTP Request操作。为它起一个名字,例如“查询订单状态”,并写明AI何时使用它,例如“用户询问订单状态时使用。先询问订单号。”
  4. 设置HTTP方法(如GET)、端点URL和所需参数,然后保存。

现在,智能体可在支持的频道中使用该操作。Discord图库中的Actions是可编辑的普通HTTP Request Actions,因此更改后请检查授权、目标和参数。更详细的步骤见HubSpot AI Actions教程Discord管理机器人指南(将禁言、踢出、封禁、身份组和慢速模式作为AI Actions使用),或Actions文档

Quickchat控制台的Actions & MCPs页面,显示已配置的API Action


延伸阅读

以下指南更详细地介绍了相关主题:


注册Quickchat AI,开始构建你的AI智能体,或加入Discord社区:discord.gg/KqkHwvPRNH