Telegram 接入指南
下载
聚焦模式
字号
将 WorkBuddy AI 连接到 Telegram 后，您可以通过 Telegram bot 发送任务并接收执行结果，在任意 Telegram 客户端中远程操控电脑上的 WorkBuddy AI。
一、前置条件
在开始之前，请确保您已满足以下条件：
电脑上已安装并登录 WorkBuddy AI，且保持运行
拥有一个 Telegram 账号
说明：
远程控制期间电脑需保持开机且 WorkBuddy AI 处于运行状态。若电脑休眠或应用退出，Telegram 侧的消息将无法执行。
二、通过 BotFather 创建 Bot
Telegram 的所有 bot 都通过官方的 @BotFather 创建。本指南以 Telegram 网页版 为例，无需安装任何客户端即可完成全部配置。
1. 打开 Telegram 搜索 @BotFather，或者单击 BotFather 直达链接 并进入对话；
2. 发送
/newbot；3. 输入 bot 的显示名称，这是聊天列表中显示的名字，例如
My WorkBuddy；4. 输入 bot 的用户名，需满足两个条件：全局唯一、以
bot 结尾，例如 my_workbuddy_ai_bot；5. 创建成功后，BotFather 会返回一段 Bot Token，格式类似
123456789:ABCdefGHIjklMNOpqrsTUVwxyz；6. 复制并妥善保存该 Token。
说明：管理已有 bot
在 BotFather 中发送
/mybots 可查看和管理已创建的 bot，包括查看 Token、修改名称、调整设置等。三、在 WorkBuddy AI 中完成连接
1. 打开 WorkBuddy AI，在左侧边栏单击 助理（Assistant）；
2. 进入 助理设置（Assistant Settings）；
3. 在 远程渠道（Remote Channels）区块中找到 Telegram 集成（Telegram Integration），单击 连接（Connect）.
4. 在弹出的注册 Telegram 渠道（Register Telegram Channel）窗口中填写：
Bot Token：填入上一章从 BotFather 获取的 Token
API Base URL (optional)：留空即可，详见下方说明
5. 单击连接（Connect）。
连接成功后，Telegram 集成卡片上的按钮会变为 断开连接（Disconnect）。
说明：API Base URL 什么情况下才需要填
该字段用于指向自建的 Telegram Bot API 服务器，绝大多数情况下留空、使用 Telegram 官方服务即可。
仅当您遇到以下情况时才需要自建服务器并填写此项：
需要通过 Telegram 传输超过 50 MB 的文件（官方 API 上传限制 50 MB、下载限制 20 MB，自建服务器可提升至 2 GB）
网络环境需要通过自有服务器转发 Telegram API 请求
自建服务器需额外申请 api_id 与 api_hash，属进阶用法，本指南不展开。
四、开始使用 Bot
1. 在 Telegram 中搜索您的 bot 用户名，例如
@my_workbuddy_ai_bot；2. 打开对话，单击 Start（或发送
/start）；3. 发送消息，WorkBuddy AI 会通过该 bot 实时回复。
说明：必须先发送 /start
Telegram 的机制要求用户先主动与 bot 建立会话，bot 才能向您发送消息。若未单击 Start 就直接等待消息，将收不到任何回复。
五、使用方式
发送文本消息给 bot 分配任务
发送图片、文档和文件作为任务上下文
使用
/clear 清理当前会话历史接收支持 Markdown 格式的执行结果
说明：在群组中使用
若要在群组中使用该 bot，需先关闭 Telegram 的隐私模式，否则 bot 在群组内只能收到以
/ 开头的命令，收不到普通消息。关闭方式：在 @BotFather 中发送
/setprivacy，选择对应 bot，然后选择 Disable。六、安全建议
Bot Token 等同于密码，请妥善保管
不要公开分享 Token，也不要提交到代码仓库
如 Token 已泄露，可在 @BotFather 中执行
/mybots，选择对应 bot 后进入 API Token → Revoke current token 重新生成，并在 WorkBuddy AI 中更新说明：
Bot Token 意味着对您电脑上 WorkBuddy AI 的远程操作权限。任何持有该 Token 的人都可以向您的电脑下发任务，请务必妥善保管。
七、常见问题
问题 | 处理方式 |
Bot 没有响应 | 确认电脑上的 WorkBuddy AI 正在运行，且渠道状态为已连接 |
发消息后没有任何回复 | 确认已在 bot 对话中单击 Start 或发送过 /start |
消息无法送达 | 检查电脑和 Telegram 客户端的网络连接 |
Bot Token 无效 | 在 @BotFather 中执行 /mybots 重新查看或生成 Token，并更新到 WorkBuddy AI 中 |
创建 bot 时提示用户名已被占用 | Telegram 要求 bot 用户名全局唯一，请更换一个名称重试 |
群组内发消息无响应 | 需在 @BotFather 中通过 /setprivacy 关闭隐私模式 |
传输大文件失败 | Telegram 官方 API 限制上传 50 MB、下载 20 MB，超出需自建 Bot API 服务器 |
连接中断 | 检查网络连接，WorkBuddy AI 会自动尝试重连 |
文档反馈