Discord 接 WorkBuddy 不开 Message Content Intent 就收不到消息

2026-08-16

Discord 接入有个很典型的失败现象：bot 在服务器里显示在线，就是不回你消息。

官方 FAQ 直接给了答案：

Bot 不回复消息 → 确认 Discord Developer Portal 中已启用 Message Content Intent。

这一条是 Discord 独有的坑，而且不开的时候没有任何报错——bot 状态正常、日志看不出问题，就是收不到消息内容。

本文依据 WorkBuddy 官方文档《Discord 接入指南》（Platform-Integration/Discord-Guide），核对日 2026-08-16。Discord 侧规则以 Discord 官方为准。我们没有安装客户端，本文不含实测数据。

一、前置条件

官方给的四条：

一个 Discord 账号；
一个你具备 Manage Server 权限的 Discord 服务器，或你可以创建新服务器；
电脑上已安装并运行 WorkBuddy；
已登录可用的 WorkBuddy 账号。

第二条比 Slack 宽松——Slack 要求你在工作区里有管理员权限或能请求安装；Discord 这边实在不行你自己新建一个服务器就行，几秒钟的事。

二、Step 1–2：创建应用与 Bot

创建 Application：打开 Discord Developer Portal 登录 → 点 New Application → 输入应用名称（官方示例 Tencent WorkBuddy）→ 点 Create。

创建 Bot：

左侧菜单点 Bot；
点 Add Bot，确认创建；
在 bot 用户名下方点 Reset Token，确认后复制 Bot Token。

官方在这里标了「重要」：

请立即保存该 Token。Token 只会完整显示一次，如果丢失需要重新生成。

这一条跟 QQ 那边性质类似——QQ 的 AppSecret 官方说明不支持明文保存、二次查看将强制重置。拿到手的当下就存进密码管理器，别想着回头再看。

好在 Discord 这边丢了还能 Reset Token 重新生成（官方 FAQ 里「Bot Token 无效」给的就是这个做法），只是重置后要回 WorkBuddy 更新。

三、Step 2 续：三个 Intents ★ 本文重点

在同一个 Bot 页面，Privileged Gateway Intents 区域，官方要求开启三个：

Presence Intent
Server Members Intent
Message Content Intent

开完点 Save Changes。

为什么这一步单独拎出来说：

Intent	不开的后果
Message Content Intent	bot 在线但收不到消息内容 ——官方 FAQ 明确列出的故障
Server Members Intent	与服务器成员信息相关的能力受限
Presence Intent	与在线状态相关的能力受限

三个里 Message Content Intent 是致命的那个。Discord 把消息内容划为特权信息，默认不给——你不主动开，bot 收到的消息就是空壳。

表现有多迷惑：bot 显示在线、服务器里能看到它、@ 它有反应（因为提及事件本身能收到）、但它读不到你说了什么。查半天以为是 WorkBuddy 的问题，其实开关在 Discord 后台。

别忘了点 Save Changes。 三个开关拨过去不保存，等于没开。

四、Step 3：邀请 Bot 到服务器

官方步骤：

左侧菜单点 OAuth2 → URL Generator；
在 Scopes 中选择：bot、applications.commands；
在 Bot Permissions 中选择：

Send Messages
Read Message History
Attach Files
Use Slash Commands

复制页面底部生成的 URL；
在浏览器中打开该 URL，选择服务器并点 Authorize。

四个权限大致对应：发消息、读历史消息、传文件（对应「上传文件和图片作为上下文」这个用法）、用斜杠命令。

权限勾错了怎么办：官方 FAQ 给了做法——出现 Missing Permissions → 使用 URL Generator 重新生成邀请链接，并勾选正确权限后重新邀请 bot。

也就是说这一步是可以重来的，不用重建应用。

五、Step 4–5：填 Token 并开始用

在 WorkBuddy 里配置：

点侧边栏的助理图标；
进入 助理 Settings → Channels；
渠道列表中选择 Discord；
把 Bot Token 粘贴到 token 字段；
点 Save。

跟 Telegram 一样，只有一个字段。比 Slack 简单（Slack 要填两个 Token）。

开始使用：打开你的 Discord 服务器，WorkBuddy bot 应显示为在线。可以直接私聊 bot，或在频道中 @Tencent WorkBuddy 提及它。

官方列的四种用法：

私聊 bot 发送私密任务；
在服务器频道中通过 @提及 分配任务；
上传文件和图片作为上下文；
接收带代码块和富文本格式的执行结果。

六、官方给的五条排查

问题	处理方式
Bot 显示离线	确认 WorkBuddy 正在运行，且助理已启用
Bot 不回复消息	确认 Developer Portal 中已启用 Message Content Intent
出现 Missing Permissions	用 URL Generator 重新生成邀请链接，勾选正确权限后重新邀请
Bot Token 无效	在 Developer Portal 中重置 Token，并更新到 WorkBuddy 的助理设置中
服务器中看不到 bot	确认已完成 OAuth2 邀请流程

这张表最值得记的是前两行的区分：

离线 → 问题在你电脑那头（客户端没运行 / 助理没启用）；
在线但不回复 → 问题在 Discord 后台（Message Content Intent 没开）。

看一眼 bot 的在线状态，就能判断该往哪边查。这个分诊比什么都省时间。

七、官方明写的那条前提

官方在助理功能说明的「注意事项」里写了：

使用助理时，电脑需要保持开机并运行 Tencent WorkBuddy；确保网络连接正常。

这也是「Bot 显示离线」的答案。这条链路的终点是你自己那台电脑——关机、休眠、客户端退出，bot 就离线，在 Discord 后台里怎么查都查不出来。

它还完美解释「时好时坏」：你在电脑前的时候好好的，人一走电脑睡了 bot 就掉线。出门前记得关掉自动休眠、笔记本接上电源。

八、在服务器频道里用之前，想清楚一件事

Discord 的用法里有一条是「在服务器频道中通过 @提及分配任务」——这意味着频道里的其他人也能指挥这个 bot，而 bot 背后连的是你自己那台电脑。

别人下的指令，会在你的电脑上执行、动你的文件。

所以：

别把 bot 邀请到不熟悉的服务器；
在公开频道里用之前，先把工作目录规划好——官方建议每类任务建独立文件夹，命名示例是 weekly-report、invoice-archive、customer-data-cleanup、batch-image-processing 这种；
敏感数据别在频道场景下处理——结果会发在频道里，谁都能看到；
需要私密任务就用私聊（官方明确把「私聊 bot 发送私密任务」和「频道中 @ 分配任务」分开列了）。

官方在使用技巧里那条「先本地后远程」在这里格外适用：远程遥控意味着它在你看不见的地方自主行动，执行了超出预期的操作你未必来得及叫停。多人频道比一对一远程又多一层风险——下指令的人可能不止你一个。

九、配置量在九个平台里的位置

平台	要几个凭证	有没有权限/事件配置	要不要发布审核
微信助理	0（只扫码）	无	无
Telegram	1 个 Token	无	无
Discord	1 个 Token	三个 Intents + 邀请权限四项	无
Slack	2 个 Token	六个权限 + 两个事件 + 一次配对	无
QQ	2 个	无，但要实名认证	无
企业微信	2 个	可见范围	无
钉钉	4 个	三个权限	要发布应用
飞书	4 个	100+ 权限 JSON + 事件回调	要发布应用

Discord 的凭证只有一个，比 Slack 少一半；但它多了 Intents 这一层，而且这一层是「不开就静默失败」的类型。

好消息是它没有发布审核环节——钉钉和飞书那两个「应用必须发布后才能使用」的坑，Discord 这边不存在。

十、什么时候选 Discord

适合：

你的团队本来就在 Discord 里协作；
你需要社区/多人频道场景——Discord 的服务器与频道结构比 Telegram 更适合分组；
你想要带代码块和富文本格式的执行结果（官方专门列了这一条）。

不适合：

只是想找个能遥控的通道——那微信助理更省事：官方明确说明它无需填写 App ID、App Secret 等开发凭证，只需扫码即可完成绑定（要求 WorkBuddy ≥ 4.6.4、微信 ≥ 8.0.70）；
需要在组织内按部门管权限——企业微信有「可见范围」，可指定成员、部门或标签，Discord 这边官方文档没有对应的管控说明。

小结

★ 三个 Privileged Gateway Intents 必开：Presence Intent、Server Members Intent、Message Content Intent，开完点 Save Changes。
Message Content Intent 是致命的那个——不开的表现是 bot 在线但收不到消息内容，没有任何报错。
Bot Token 只完整显示一次，拿到就存密码管理器；丢了可以 Reset Token 重新生成。
邀请链接：OAuth2 → URL Generator → Scopes 选 bot + applications.commands → Bot Permissions 选 Send Messages、Read Message History、Attach Files、Use Slash Commands → 复制 URL 授权。
权限勾错可以重新生成邀请链接重新邀请，不用重建应用。
分诊看在线状态：离线查你的电脑；在线但不回复查 Message Content Intent。
频道里用的时候，别人也能指挥你那台电脑——私密任务走私聊。

功能与流程以官方为准，Discord 侧规则以 Discord 官方为准，核对日 2026-08-16。