WorkBuddy 接 Telegram 只要一个 Token，是九个平台里最短的流程

如果按「配置步骤数量」给 WorkBuddy 的九个接入平台排序，Telegram 大概是除微信助理之外最短的一条。

对比一下就知道差多少：飞书要导入一百多条权限的 JSON、拿四个凭证、配事件回调、创建版本发布；钉钉要三个权限、四个凭证、发布应用；Slack 要两个 Token、六个权限、两个事件、还要发配对码。

Telegram 这边——跟 BotFather 聊几句，拿一个 Token，填进去，完事。

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

一、前置条件

官方给的三条，也是九个平台里最松的：

• 一个 Telegram 账号；
• 电脑上已安装并运行 WorkBuddy；
• 已登录可用的 WorkBuddy 账号。

没有企业账号要求、没有管理员权限要求、没有实名认证要求。 对比：QQ 要实名认证、企业微信要可创建智能机器人的企业账号、钉钉要企业管理员权限、飞书要有创建应用权限的企业账号、Slack 要工作区管理员权限或能请求安装。

二、Step 1：通过 BotFather 创建 Bot

官方给的步骤：

1. 打开 Telegram，搜索 @BotFather；
2. 进入对话后发送 /newbot；
3. 输入 bot 的显示名称，官方示例 My Tencent WorkBuddy；
4. 输入 bot 的用户名——用户名必须唯一且以 bot 结尾，官方示例 my_tencent_workbuddy_bot；
5. BotFather 会返回一段 Bot API Token，格式类似 123456789:ABCdef...；
6. 复制并妥善保存该 Token。

第 4 步那条规则是 Telegram 平台的硬规则：用户名必须唯一，且必须以 bot 结尾。第一次配的人经常在这儿卡住——起了个好名字，BotFather 说不行；换了个名字，说已被占用。

建议：直接用 你的名字_workbuddy_bot 这种组合，唯一性有保障，也一眼能认出是干什么的。

官方还给了一个管理提示：在 BotFather 中使用 /mybots 可以查看和管理已有 bot。

三、Step 2：在 WorkBuddy 里填 Token

1. 在 WorkBuddy 中点击侧边栏的助理图标；
2. 进入 助理 Settings → Channels；
3. 在渠道列表中选择 Telegram；
4. 把从 BotFather 获取的 Bot API Token 粘贴到 token 字段；
5. 点 Save。

就一个字段。没有 App Token、没有 Secret、没有 AES Key。

粘贴前建议：先把 Token 粘到纯文本编辑器（记事本 / TextEdit）里看一眼首尾有没有多余空格或换行。官方在多个平台的指南里都提醒过「避免带入多余空格或遗漏字符」——首尾空白肉眼看不出来，却会让配置直接失败。

四、Step 3：必须先发一次 /start

官方第三步：

1. 在 Telegram 中搜索你的 bot 用户名，例如 @my_tencent_workbuddy_bot；
2. 打开对话并点击 Start；
3. 发送消息，WorkBuddy 会通过该 bot 实时回复。

「点击 Start」这一步别跳过。 官方在常见问题里专门列了对应的条目：

Bot 显示 unavailable → 确认你已经打开 bot 对话并发送过 /start。

这是 Telegram 的机制——bot 不能主动给没跟它说过话的人发消息。你不先发 /start，这条通道就是单向不通的。

五、四种用法

官方列的：

• 发送文本消息分配任务；
• 发送图片、文档和文件作为上下文；
• 使用 /clear 清理当前会话历史；
• 接收支持 Markdown 格式的执行结果。

/clear 这个命令值得记住。 官方在使用技巧里有一条建议：会话过长出现「前说后忘」「越聊越跑偏」时，不要硬撑，直接开新任务把关键背景重新简洁说一遍。在 Telegram 这边，/clear 就是执行这件事的开关。

六、Token 安全：官方专门给了一节

Telegram 是九个平台指南里唯一单独列了「安全建议」章节的，说明这个 Token 的敏感度值得强调：

• Bot API Token 等同于密码，请妥善保管；
• 不要公开分享 Token，也不要提交到代码仓库；
• 如需重置 Token，可在 @BotFather 中执行 /mybots，选择对应 bot 后进入 API Token → Revoke current token。

第三条是个好消息：Token 可以随时重置。 泄露了不用重建 bot，撤销旧的重新生成就行——重置后记得回 WorkBuddy 更新。

对比一下：QQ 那边官方明确说明 AppSecret 不支持明文保存、二次查看将强制重置，只有一次机会；Discord 的 Bot Token 官方也提醒「Token 只会完整显示一次，丢失需要重新生成」。Telegram 这边宽松得多。

七、官方给的四条排查

问题	处理方式
Bot 没有响应	确认 WorkBuddy 正在运行，且助理已启用
消息无法送达	检查电脑和 Telegram 客户端的网络连接
Bot Token 无效	在 @BotFather 中重新生成 Token，并更新到 WorkBuddy 的助理设置中
Bot 显示 unavailable	确认你已经打开 bot 对话并发送过 /start

第二条的措辞值得注意：官方说的是检查电脑和 Telegram 客户端两边的网络——这条链路两头都要通。

八、官方明写的那条前提

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

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

这也是上面排查表里第一条的答案。这条链路的终点是你自己那台电脑——关机、休眠、客户端退出，bot 一定不回复，在 Telegram 那边怎么查都查不出来。

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

九、什么时候选 Telegram

适合：

• 你本来就在用 Telegram；
• 你想要配置成本最低的方案，但用不了微信助理（比如手机上没微信、或者客户端版本不够 8.0.70）；
• 你需要跨设备随时接入——Telegram 多端同步做得比较好。

不适合：

• 团队协作场景——没有企业微信那样的「可见范围」管控；
• 需要在国内网络环境下稳定使用的场景。

如果你只是想省事，先看微信助理：官方明确说明它无需填写 App ID、App Secret 等开发凭证，只需扫码即可完成绑定，只要 WorkBuddy ≥ 4.6.4、微信 ≥ 8.0.70。那个比 Telegram 还短一步。

十、一条安全提醒

不管哪个平台，用 IM 遥控意味着你在聊天软件里下达的指令会真实操作你电脑上的文件。官方在使用技巧里有一条「先本地后远程」：远程遥控意味着它在你看不见的地方自主行动，执行了超出预期的操作你未必来得及叫停。建议先在桌面端边看边用，摸清风险边界再放手。

所以：远程只做查、写、汇总；批量删改、客户与财务数据、第一次试的新任务，都别远程做。

小结

• Telegram 是除微信助理外流程最短的：三步、一个 Token、没有权限申请、没有事件订阅、没有发布审核。
• 前置条件最松：只要一个 Telegram 账号，不需要企业账号、管理员权限或实名认证。
• 创建：搜 @BotFather → 发 /newbot → 输显示名 → 输用户名（必须唯一且以 bot 结尾）→ 拿 Bot API Token。
• 填入：侧边栏助理图标 → 助理 Settings → Channels → 选 Telegram → 粘 token → Save。
• ★ 必须打开 bot 对话并发送过 /start，否则 Bot 显示 unavailable。
• /clear 可以清理当前会话历史——会话跑偏时用得上。
• Token 等同密码，别提交到代码仓库；可在 BotFather 里 /mybots → API Token → Revoke current token 重置。
• 官方明写前提：电脑需保持开机并运行 WorkBuddy。

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