Back to Lobehub

在 Telegram 使用 LobeHub

docs/usage/messenger/telegram.zh-CN.mdx

2.2.02.5 KB
Original Source

在 Telegram 使用 LobeHub

Telegram 是 Messenger 里最简单的平台:只有一个全局 LobeHub 机器人,任何 Telegram 账号都能直接私聊它。你只需要把自己的 LobeHub 账号绑一次。

前置条件

  • 一个 LobeHub 账号
  • 任意设备上的 Telegram 账号

第 1 步:打开「设置 → Messenger」

在 LobeHub 中打开 设置 → Messenger,点击 Telegram 卡片。

第 2 步:点击「连接」

在 Telegram 详情页右上角点击 连接。弹窗里会给出两种方式打开机器人。

第 3 步:在 Telegram 中打开机器人

在弹窗里点 在 Telegram 中打开,或用手机扫描二维码,Telegram 会自动打开官方 LobeHub 机器人。

第 4 步:发送 /start

在机器人会话里发送 /start。机器人会回复一个一次性确认链接。

第 5 步:在浏览器里确认关联

点击机器人回复里的链接,会跳回 LobeHub 网页。如未登录请先登录,然后选择一个 默认 Agent —— 之后你在该机器人里发的每条消息都会路由到这个 Agent。

确认后,Telegram 详情页会以 “user” 行的形式显示你的关联,旁边可以看到当前 Agent。

切换接收消息的 Agent

两种等价方式:

  • 在 Telegram 里 —— 给机器人发送 /agents,挑一个新的 Agent。
  • 在 LobeHub 里 —— 打开 设置 → Messenger → Telegram,在你的关联行里使用 Agent 选择器。

切换会对你发送的下一条消息立即生效。

断开连接

设置 → Messenger → Telegram 里点关联行上的 断开。断开后机器人不再接收你的消息,直到你重新发送 /start 关联。

在 LobeHub 里断开不会从 Telegram 聊天列表里删掉机器人 —— 如果不想再看到它,可以在 Telegram 里手动删除该会话。

故障排查

  • 机器人不回复 /start —— 先确认 设置 → Messenger 里有 Telegram 卡片。如果当前部署没启用 Telegram,机器人不会响应。
  • "This link is already used" —— 一次性链接只能用一次,重新发送 /start 获取新链接。
  • "This account is already linked" —— 这个 Telegram 账号已绑定到另一个 LobeHub 账号。请用那个 LobeHub 账号登录管理,或先在那边解绑。
  • "Another Telegram account is already linked" —— 你的 LobeHub 账号在 Telegram 上已有关联。先在 设置 → Messenger → Telegram 断开旧关联,再绑定新的 Telegram 账号。