Messenger

Messenger 让你通过 官方 LobeHub 机器人 在 Telegram、Slack、Discord 上直接和 LobeHub Agent 对话。只需将 LobeHub 账号绑定一次、选好接收消息的 Agent，之后你在机器人里发的每一条消息都会被路由到该 Agent 并在同一会话里回复给你。

所有配置都集中在 LobeHub 的 设置 → Messenger 页面。

[!NOTE]

Messenger 面向 个人使用 —— 让你在常用聊天工具里方便地用自己的 LobeHub Agent。如果你想以自家机器人身份把某个 Agent 公开给社区使用，请改用 Agent 上的 渠道（Channels）。

Messenger 与渠道（Channels）的区别

	Messenger	渠道（Channels）
机器人身份	官方 @LobeHub 机器人，由 LobeHub 托管	你自己的机器人，需要自带 Token
配置成本	点 连接、发送 /start、选一个 Agent	在平台上创建机器人、粘贴凭据、配置策略
适用场景	个人 —— 只有你自己和机器人对话	公开 —— 频道 / 服务器里所有人都能对话
接收 Agent	每个平台绑定一个，可随时切换	每个频道绑定一个 Agent
配置入口	设置 → Messenger	Agent → 渠道

支持的平台

平台	接入模式	文档
Telegram	全局机器人 —— 任意账号都可直接私聊	在 Telegram 使用 LobeHub
Slack	按工作区安装 + 成员各自关联	在 Slack 使用 LobeHub
Discord	按服务器安装 + 成员各自关联	在 Discord 使用 LobeHub

如果 设置 → Messenger 页面没有出现某个平台的卡片，说明当前部署尚未启用该平台 —— 请稍后再来，或联系管理员开启。

工作原理

1. 通过一段类 OAuth 的流程，将你的 LobeHub 账号 关联 到平台账号。
2. 关联时选择一个 默认 Agent，之后该平台收到的消息都会路由到这个 Agent。
3. 切换 Agent：在机器人里发送 /agents，或回到 LobeHub 的 设置 → Messenger。
4. 随时可以在同一页面 断开连接 —— 断开后机器人将不再接收消息，直到你重新 /start。

每个 LobeHub 账号在每个平台上可保留一条关联（Slack 还会按工作区各保留一条）。

切换接收消息的 Agent

你可以随时切换接收你消息的 Agent：

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

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

断开连接

每个平台有两种含义不同的断开操作：

操作	效果
在 user 行点 断开	解除 你自己 的 LobeHub 账号与该平台账号的关联。机器人不再接收你的消息，直到你重新 /start。
在 workspace / server 行点 断开	移除安装审计记录。Slack 会因此让该工作区的整个机器人失效；Discord 上机器人会继续留在服务器，直到 Discord 管理员把它踢出。

任何时候都可以重新走一次 连接 流程恢复关联。

通用报错

下面这几条提示在任何平台关联时都可能出现：

• "This link is already used"（链接已被使用） —— 一次性确认链接只能使用一次。请回到机器人重新发送 /start 获取新链接。
• "This account is already linked"（该账号已被关联） —— 该平台账号已绑定到另一个 LobeHub 账号。请用那个 LobeHub 账号登录管理；或先在那边解绑后再尝试。
• "Another <platform> account is already linked"（另一个平台账号已关联） —— 你的 LobeHub 账号在该平台上已有关联。先在 设置 → Messenger 里断开旧关联，再绑定新账号。

平台特有的报错和细节请见各平台文档的「故障排查」一节。