跳到主要内容

Discord

最近更新 2026/10/07

一、前置条件​

  • 拥有 Discord 账号，并有创建应用的权限
  • Agentic Engine 平台的管理员权限
  • 一个已有的 Discord 服务器（Server），用于添加 Bot

二、创建 Discord Bot 并获取凭证​

前往 Discord Developer Portal，按以下步骤操作：

  1. 点击「New Application」，输入应用名称后创建
  2. 进入应用详情，左侧导航切换到「Bot」标签页
  3. 在 Bot 页面，点击「Reset Token」生成 Bot Token，复制并保存（Token 只显示一次，请立即保存）
  4. 在 Bot 页面，开启以下 Privileged Gateway Intents 权限开关：
权限名称是否必须说明
Message Content Intent必须开启允许 Bot 读取消息正文内容
Server Members Intent按需获取服务器成员信息
Presence Intent按需获取用户在线状态
提示

Message Content Intent 必须开启，否则 Bot 将无法读取用户消息内容，无法正常工作。

  1. 如需支持用户 OAuth 绑定，在左侧「OAuth2」→「General」页面，记录 Client ID 和 Client Secret，并将回调地址添加到「Redirects」：
    https://<your-domain>/api/discord-oauth/callback
提示

Bot Token 具有完整的 Bot 操作权限，请勿提交到代码仓库或泄露给他人。若 Token 意外泄露，立即在 Discord Developer Portal 中重置 Token 并更新平台配置。

三、在平台中添加 Discord 渠道​

管理员登录 Agentic Engine，进入「管理后台」→「渠道管理」：

  1. 点击「新建渠道」，渠道类型选择 Discord
  2. 填写以下配置项：
配置项是否必填说明
渠道名称必填显示名称，如「Discord 服务器」
Bot Token必填Discord Bot 的访问令牌，用于连接 WebSocket Gateway 和发送消息
Client ID可选Discord 应用的 Client ID，仅用于 OAuth 用户绑定流程
Client Secret可选Discord 应用的 Client Secret，仅用于 OAuth 用户绑定流程
默认模型可选不填则使用系统默认模型
渠道输入附加说明可选作为每轮渠道输入的附加说明，不会替代 Agent 自身的系统提示词
警告

注意：同一企业可以配置多个 Discord 渠道实例，但同一个 Bot 身份不能在同一运行环境中重复配置。

四、用户绑定 Discord 账号​

如管理员在渠道配置中填写了 Client ID 和 Client Secret，普通用户可在「渠道绑定」中绑定自己的 Discord 账号：

  1. 打开用户菜单，进入「渠道绑定」，找到对应的 Discord 渠道实例，点击「绑定」
  2. 系统跳转至 Discord OAuth 授权页面，登录 Discord 账号并点击「授权」
  3. 授权成功后自动回跳平台，绑定状态变为「已绑定」

绑定完成后，用户在 Discord 中对 Bot 发送的消息将与平台账号关联。如需解绑，在「渠道绑定」中找到该实例并解绑即可。

五、常见问题​

渠道状态异常 / Bot 无法连接​

  • 检查 Bot Token 是否有效（未被重置）
  • 确认 Bot 已成功邀请到目标 Discord 服务器
  • 确认 Message Content Intent 已在 Developer Portal 中开启

OAuth 回调失败​

  • 确认回调地址已添加到 Discord 应用「OAuth2 → Redirects」白名单
  • 回调地址必须与平台实际部署域名完全一致，包括协议（https）和路径

用户无法绑定 Discord 账号​

  • 确认渠道配置中已填写 Client ID 和 Client Secret（缺少任一则 OAuth 绑定不可用）
  • 确认 OAuth 回调地址配置正确

Bot 收不到消息​

  • 确认 Message Content Intent 已开启，否则 Bot 无法获取消息内容
  • 确认 Bot 在目标频道有「Read Messages」和「Send Messages」权限

相关页面与下一步

这篇文档对你有帮助吗？
本页内容