首页 / 文档 / 通道 / Discord

Discord

将 通千算智 接入 Discord Bot

通过 Discord Bot 的 Gateway 长连接 接入 通千算智,支持私聊(DM)与服务器频道(@机器人 / 回复机器人触发)。Gateway 基于 WebSocket 长连接,无需公网 IP 与回调地址,开箱即用。

一、接入步骤

步骤一:创建 Discord 应用与 Bot

  1. 打开 Discord 开发者后台,点击 New Application,填写名称(如 通千算智)并创建。
  2. 左侧菜单进入 Bot 页面,点击 Reset Token 生成 Bot Token,复制并妥善保存(仅显示一次)。
提示

这个 Token 等同于 Bot 的密码,请勿泄露。若意外泄漏,在 Bot 页面再次点击 Reset Token 重置即可。

步骤二:开启 Message Content Intent

私聊与频道读取文本均依赖该权限。

  1. 在 Bot 页面下方找到 Privileged Gateway Intents。
  2. 打开 Message Content Intent 开关并保存。

未开启该开关时,机器人收到的消息内容会为空,导致无响应。

步骤三:邀请 Bot 进入服务器

  1. 左侧菜单进入 OAuth2 → URL Generator。
  2. Scopes 勾选 bot。
  3. Bot Permissions 至少勾选:Send Messages、Read Message History、Attach Files、View Channels。
  4. 复制底部生成的授权链接,在浏览器打开,选择目标服务器完成授权。

仅需私聊(DM)可跳过此步,但仍需先在任意共同服务器中与机器人建立 DM 通道,或由用户主动私聊机器人。

步骤四:接入 通千算智

启动 通千算智 后,日志中出现以下输出即表示接入成功:

代码
[Discord] Bot logged in as 通千算智#1234 (id=123456789)
[Discord] ✅ Discord bot ready, listening for messages

二、功能说明

功能 支持情况
私聊(DM) ✅
服务器频道(@机器人 / 回复机器人) ✅
文本消息 ✅ 收发
图片消息 ✅ 收发
文件消息 ✅ 收发(PDF / Word / Excel 等)

Discord 单条消息上限为 2000 字符,超长回复会自动按换行拆分为多条发送。

三、使用

完成接入后:

  • 私聊(DM):在服务器成员列表中找到你的机器人,点击头像直接发消息对话。
  • 频道:在已邀请机器人的频道中,使用 @你的机器人 你好 或 回复机器人的某条消息 触发对话。

发送图片或文件时,可以在附件的输入框中 添加文字说明(描述/问题)一并发送,机器人会结合附件回答。也支持先发附件再发问题,两条消息会自动合并提问。

关于 通千算智 与开源社区
通千算智 构建于开源项目 CowAgent(MIT 协议)之上并做了企业化增强:团队门户与权限、桌面客户端定制与自有更新通道、 语音与数字人能力、本地化部署与加固。上游社区、Discord 与交流群请访问 GitHub 仓库 获取;本产品的使用支持请联系你的团队管理员或交付同学。