Telegram 接入指南 ​

将 Tencent WorkBuddy 连接到 Telegram 后，你可以通过 Telegram bot 发送任务并接收执行结果。配置完成后，可以在任意 Telegram 客户端中远程控制电脑上的 Tencent WorkBuddy。

前置条件 ​

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

配置步骤 ​

Step 1：通过 BotFather 创建 Telegram 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

提示：你也可以在 BotFather 中使用 /mybots 查看和管理已有 bot。

Step 2：在 Tencent WorkBuddy 中配置 Telegram ​

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

Step 3：开始使用 Bot ​

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

使用方式 ​

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

安全建议 ​

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

常见问题 ​

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