WorkBuddy 接入 Slack、Telegram、Discord：三个平台的配置步骤、凭证对照与验收清单

2026-08-08

WorkBuddy（Tencent WorkBuddy）的「助理」本质上是个遥控器：你在手机上发一条消息，家里或公司那台开着机的电脑上的 WorkBuddy 收到指令、跑完任务，再把结果回到你的聊天窗口。它支持九个平台，其中 Slack、Telegram、Discord 这三个是海外协作场景里最常用的组合。

这三个平台放在一起讲，是因为它们的配置路径高度相似——都要先在对方的开发者后台建一个 App/Bot、拿到凭证、再回 WorkBuddy 填进去——但需要准备的东西数量差了一倍多。搞清楚这个差别，能帮你决定先接哪个。

一、三条路径的真实差别

先看这张对照表，它决定了你今晚要花多少时间：

平台	需要几份凭证	凭证名称	额外必须做的事	前提权限
Telegram	1	Bot API Token	无	一个 Telegram 账号即可
Slack	2	App Token（`xapp-` 开头）+ Bot Token	开启 `Enable Socket Mode`、配 7 个 Bot Token Scopes	工作区管理员权限，或可请求安装应用
Discord	1	Bot Token	开启 3 个 Privileged Gateway Intents、用 URL Generator 生成邀请链接	一个你具备 `Manage Server` 权限的服务器

Telegram 是三个里最省事的，全程只跟一个叫 @BotFather 的机器人对话，拿一个 Token 就完事，不涉及任何权限勾选。如果你只是想先体验一下”手机发指令、电脑干活”是什么感觉，从它开始。

Slack 的凭证最多，两个 Token 分别管两件事：App Token 用来建立 Socket Mode 长连接，Bot Token 用来在工作区里实际收发消息和文件，两个都不能少。

Discord 只要一个 Token，但有两处容易卡住：三个 Intents 忘了开，以及 Bot Token 只会完整显示一次。

这里要单独点出 Slack 的一个实在好处：官方说明这个集成通过 Socket Mode 建立连接，无需公网 Webhook 地址。这条对个人用户和内网办公的人价值很大——不用买域名、不用做端口映射、不用担心家里宽带没有公网 IP。企业微信那条路径里的「长连接模式」之所以被官方推荐，也是同一个道理：省掉回填 Webhook URL 这一整段麻烦事。

二、三个平台的共同前提，先确认再动手

不管接哪个平台，官方在每篇接入指南里都写了同样三条前提：

已在电脑上安装 Tencent WorkBuddy，并开启「助理」远程控制功能
已登录可用的 WorkBuddy 账号
使用助理时电脑需保持开机并运行 WorkBuddy，网络连接正常

第三条最容易被忽略。助理不是云端服务，任务是在你自己那台电脑上跑的——你合上笔记本盖子出门，手机上发过去的指令就没人接。如果你打算靠它处理通勤路上的临时需求，那台执行机就得一直开着。

WorkBuddy 端的配置入口是统一的：左下角头像 →「设置 - 助理设置」→「集成（BETA）」区域找到对应平台 → 点「配置」。三个平台的差异全在对方平台那一侧。

三、Slack：Socket Mode 两个 Token

前提是你有一个 Slack 工作区，并且具备管理员权限，或者至少能向管理员请求安装应用。

第一步，建 App。 打开 api.slack.com/apps → Create New App → 选 From scratch → 输入名称、选择目标工作区 → Create App。

第二步，开 Socket Mode 拿 App Token。 左侧菜单进 Socket Mode → 打开 Enable Socket Mode → 系统会要求你创建一个 App-Level Token：输入名称（比如 tencent-workbuddy-socket）→ 添加 scope connections:write → 点 Generate → 复制生成的 App Token，它通常以 xapp- 开头。

connections:write 这个 scope 不能漏，它就是 Socket Mode 长连接的开关。

第三步，配 Bot Token Scopes。 左侧进 OAuth & Permissions，找到 Scopes → Bot Token Scopes，依次添加这七项：

app_mentions:read
chat:write
im:history
im:read
im:write
files:read
files:write

这七项按用途分成三组：app_mentions:read 让 Bot 能收到别人 @ 它的消息；chat:write 加上三个 im:* 让它能在私聊里读写消息；两个 files:* 管的是文件读写——WorkBuddy 的任务经常产出文档、表格、图片，少了它们结果就回传不了。

第四步，安装。 回到页面上方点 Install to Workspace，完成安装后获取 Bot Token。至此两个 Token 齐了，回 WorkBuddy 助理设置里按统一入口填入即可。

四、Telegram：跟 @BotFather 聊五句话

Telegram 这条路不需要开发者后台，全程在聊天窗口里完成。

在 Telegram 搜索 @BotFather，打开对话发送 /newbot
输入 bot 的显示名称（比如 My Tencent WorkBuddy），这个是别人看到的名字，可以是中文，可以重复
输入 bot 的用户名——这一步有硬规则：必须唯一，且必须以 bot 结尾（比如 my_tencent_workbuddy_bot）。名字被占用它会让你重起，多试两个就好
BotFather 返回 Bot API Token，格式类似 123456789:ABCdef...，复制保存
打开 WorkBuddy → 侧边栏「助理」图标 → 助理 Settings → Channels → 选 Telegram → 把 Token 粘贴到 token 字段 → 点 Save
回 Telegram 搜索你刚才设的 bot 用户名 → 打开对话点 Start → 发消息

最后那个 Start 别忘了点。Telegram 的 bot 对话需要用户主动开启一次，跳过这步你会以为是接入失败。

以后想改 bot 的头像、简介，或者查看已经建过哪些 bot，在 BotFather 里发 /mybots 就能管理。

五、Discord：三个 Intents 和只显示一次的 Token

前提有两条：一个 Discord 账号，以及一个你具备 Manage Server 权限的服务器（没有就自己新建一个，创建者天然有这个权限）。

第一步，登录 Discord Developer Portal → New Application → 输入名称 → Create。

第二步，左侧进 Bot → Add Bot 确认创建 → 在用户名下方点 Reset Token → 复制 Bot Token。

这里是整篇最需要停一下的地方：Token 只会完整显示一次，丢失就得重新生成，看到的当下立刻存进密码管理器。重新生成本身不难，麻烦的是你可能已经把旧 Token 填进 WorkBuddy 了，重置之后连接会断，还得回来重填一遍。

第三步，在同一页找到 Privileged Gateway Intents，把这三项全部开启，然后点 Save Changes：

Presence Intent
Server Members Intent
Message Content Intent

第三项 Message Content Intent 尤其关键——不开它，Bot 收到的消息里就没有正文内容，你发什么它都收不到。这三个开关默认是关的，属于”不报错但功能不工作”的典型，忘了开的话表现就是 Bot 在线却完全不理你。

第四步，左侧进 OAuth2 → URL Generator，勾两组东西：

Scopes：bot、applications.commands
Bot Permissions：Send Messages、Read Message History、Attach Files

Attach Files 和 Slack 那边的 files:write 是同一件事——任务产出的文件要能发回来。

第五步，页面下方会生成一条邀请 URL，用它把 Bot 邀请进你的服务器，再回 WorkBuddy 助理设置填入 Token。

六、接通之后，第一条指令这么写

配置只是把管道打通，真正决定好不好用的是指令。官方《10 个上手技巧》给的公式是做什么 + 有什么 + 怎么样，别让 AI 猜你的意图；《创建任务》进一步把要补的信息拆成四项：目标 / 输入 / 输出格式 / 约束。

远程场景下，这四项里的「约束」权重比在桌面端高得多。下面这条可以直接复制到 Slack、Telegram 或 Discord 的对话框里当第一条测试指令：

【目标】把本周的项目进展整理成一份可直接发出的简报。

【输入】读取 D:/工作/项目A 目录下最近 7 天修改过的文档，
不要读该目录以外的任何文件。

【输出格式】生成 Markdown 文件，保存到 D:/工作/简报 目录，
文件名为「项目A进展_2026-08-08.md」；同时把正文摘要直接回复给我。

【约束】只写文件里有依据的内容，无法确认的单独列在文末「待确认」区；
不要新建、删除、覆盖任何已有文件；执行前先把你打算读的文件清单发给我确认。

最后那句”先把文件清单发给我确认”不是客套。官方《实践案例》里讲远程遥控时明确建议：涉及删除、覆盖、批量移动时先要求预览；《10 个上手技巧》第 4 条说得更直白——远程意味着它在你看不见的地方自主行动，一旦执行了超出预期的操作，你未必来得及叫停。你人不在电脑前，唯一的刹车就是这句预览要求。

同一份技巧里还有一条配套的：改文档表格前先复制一份备份（文件名加 _备份 或当天日期）。官方的原话口径是它可能”改过头”，删掉你想保留的内容或打乱原有格式，成熟的用法不是期待它永不出错，而是提前准备好回退方案。远程场景下这条尤其成立，因为你连”改坏了”都是事后才知道。

七、交付物长什么样、怎么验收

接通之后你会拿到两份东西：电脑上落盘的文件（在你指定的输出目录里，格式由你在指令里说死），以及聊天窗口里的一段文字回复。三个平台的差别只在文件怎么回传——Slack 靠 files:read / files:write，Discord 靠 Attach Files，Telegram 直接由 bot 发送。

验收按这四步走，第一次接通时建议一步不省：

验连接。发一条最简单的消息（比如”你在吗”），确认能收到回复。Discord 若 Bot 显示在线却毫无反应，先回 Developer Portal 看三个 Intents 是不是漏了 Message Content Intent；Telegram 若没反应，确认是不是漏点了 Start。
验读取范围。看它回传的文件清单，有没有超出你指定的目录。这一步是安全阀——授权目录里如果混着薪酬、合同这类文件，现在就该分目录，别等出事。
验文件真的落了盘。回到电脑上打开输出目录确认文件在、内容完整。聊天窗口里的摘要写得漂亮不代表文件写成功了。
验有没有编。远程场景下你没法边看边纠，所以正文里的每个数字、每个日期都要能在源文件里找到出处，这一步只能回到电脑前做。

AI 最容易出错的一步是第 2 步和第 4 步之间：它读到的文件不全，却仍然把结论写得很完整。所以指令里那句”无法确认的单独列出”要一直保留，它是你在手机上唯一能看出”素材不够”的信号。

八、安全提醒：这几串字符等于远程控制权

三个平台的凭证——Slack 的 App Token 与 Bot Token、Telegram 的 Bot API Token、Discord 的 Bot Token——泄露出去等于把你那台电脑的远程控制权交给别人。拿到 Token 的人可以冒充你的 bot 发指令，而指令执行的地方是你的硬盘。

几条具体做法：

不要把 Token 贴进任何聊天群、截图、代码仓库或在线文档
Discord 的 Token 只显示一次，复制的当下就存进密码管理器，别指望”回头再看一眼”
怀疑泄露就立刻重置：Slack 在 App 管理页重新生成，Discord 用 Reset Token，Telegram 在 BotFather 里用 /mybots 管理
执行机上的授权目录尽量收窄，别图省事把整个盘授权出去

顺带一提，如果你之后还要接 QQ 机器人，那边的 AppSecret 出于安全考虑不支持明文保存，二次查看将会强制重置，规则和 Discord 类似，也是”看到就存”。

九、四种情况，别走这条路

第一，公司对境外服务有合规要求。 Slack、Telegram、Discord 都是境外服务，指令内容和任务结果会经过它们的服务器。如果你所在的组织对数据出境、办公工具白名单有明确规定，这条路径直接排除，别拿”就试一下”当理由——试的那一下也是真数据。

第二，网络不稳定的环境。 助理依赖执行机与平台之间的长连接，官方在共同前提里专门写了「网络连接正常」。如果你的执行机在一个经常掉线的网络里，表现会是指令时灵时不灵，排查起来比配置本身麻烦得多。

第三，需要多人共用一台执行机。 助理的模型是”一个人的手机遥控一个人的电脑”。多人共用同一台执行机意味着大家共享同一份授权目录和同一套凭证，谁改了什么无从区分。这种需求本身就不该用远程助理解决。

第四，涉及删除、覆盖、批量移动的活儿。 不是不能做，是不该在手机上发完指令就不管。这类任务留到你坐回电脑前、能边看边停的时候再做，或者严格按上面那条”先要求预览”的写法来，看完清单再放行。

配置这件事本身，三个平台加起来不过是十几次点击。真正需要想清楚的是后面那半段：你打算把哪个目录授权出去、允不允许它删文件、人不在电脑前的时候谁来喊停。管道搭好之后，这些问题一个都躲不掉。