将 LobeHub 连接到 Telegram

通过将 Telegram 渠道连接到您的 LobeHub 代理，用户可以通过 Telegram 私聊和群组对话与 AI 助手互动。

前置条件

• 一个拥有有效订阅的 LobeHub 账户
• 一个 Telegram 账户

第一步：创建 Telegram 机器人

<Steps> ### 打开 BotFather

打开 Telegram 并搜索 @BotFather —— 这是用于管理机器人的官方 Telegram 机器人。开始对话并发送 /newbot 命令。

设置机器人名称和用户名

BotFather 会要求您：

1. 为您的机器人选择一个 显示名称（例如，“LobeHub 助手”）
2. 选择一个 用户名 —— 必须以 bot 结尾（例如，lobehub_assistant_bot）

复制机器人令牌

创建机器人后，BotFather 会发送给您一个 API 令牌（格式：123456789:ABCdefGhIjKlmNoPQRsTuVwXyZ）。复制并保存此令牌。

重要提示： 您的机器人令牌是一个机密凭证，请勿公开分享。

</Steps>

第二步：在 LobeHub 中配置 Telegram

<Steps> ### 打开渠道设置

在 LobeHub 中，导航到您的代理设置，然后选择 渠道 标签页。从平台列表中点击 Telegram。

输入机器人令牌

将您从 BotFather 收到的机器人令牌粘贴到 机器人令牌 字段中。

机器人用户 ID 将根据您的令牌自动生成，无需手动输入。

可选：设置 Webhook 密钥

您可以选择输入一个 Webhook 密钥令牌 以增加安全性。此密钥用于验证来自 Telegram 的入站 Webhook 请求。

保存配置

点击 保存配置。LobeHub 将自动向 Telegram 注册 Webhook URL，无需手动复制 URL。

您的令牌将被加密并安全存储。 </Steps>

第三步：测试连接

在 LobeHub 的渠道设置中点击 测试连接 以验证集成。然后打开 Telegram，搜索您的机器人用户名并发送消息。机器人应通过您的 LobeHub 代理进行响应。

将机器人添加到群组聊天

要在 Telegram 群组中使用机器人：

1. 将机器人添加为群组成员
2. 默认情况下，机器人在被 @your_bot_username 提及时会响应
3. 发送一条提及机器人的消息以开始互动

<Callout type={'warning'}> 关于隐私模式（Group Privacy）： Telegram 机器人默认启用隐私模式，仅接收群组中 @提及、回复机器人的消息以及 / 命令。如果您在创建机器人后更改了隐私模式设置，必须将机器人从群组中移除后重新加入，新的设置才会对该群组生效。 </Callout>

接入策略

两个独立的策略控制入站消息，默认都为 开放。

允许的用户 ID（全局）

填入 允许的用户 ID 后，所有入站消息（私信和群聊 @提及）都必须来自列表里的 Telegram 数字用户 ID。留空则不做用户级过滤。让目标用户私信 @userinfobot 拿到自己的数字 ID，或直接从机器人收到的 update 里读 from.id。

私信策略

• 开放 (Open)（默认） — Telegram 上任何用户都可以私信机器人（若设置了全局白名单则受其约束）。
• 白名单 (Allowlist) — 私信需要发送者在 允许的用户 ID 里。和 Open 的差别在白名单为空时：Allowlist 模式全部拒绝。
• 禁用 (Disabled) — 机器人忽略所有私信，只在群组里被 @提及 时回复。

群组策略

控制机器人会在哪些 Telegram 群组 / 频道里响应。

• 开放 (Open)（默认） — 在机器人加入的任何群组 / 频道里都响应。
• 白名单 (Allowlist) — 只在 允许的频道 ID 列出的会话里响应。把群里的一条消息转发给 @userinfobot 即可拿到 chat ID（群组是负数）。
• 禁用 (Disabled) — 忽略所有群组流量，机器人只接受私信。

跨平台细节见 渠道概览。

配置参考

字段	是否必需	描述
机器人令牌	是	来自 BotFather 的 API 令牌
机器人用户 ID	自动	根据机器人令牌自动生成
Webhook 密钥令牌	否	用于验证 Webhook 请求的可选密钥
允许的用户 ID	否	逗号或空格分隔的 Telegram 数字用户 ID。全局闸门 — 私信和群聊 @ 都受其约束
私信策略	否	open（默认）、allowlist 或 disabled — 控制谁可以私信机器人
群组策略	否	open（默认）、allowlist 或 disabled — 控制机器人在哪些群组中响应
允许的频道 ID	否	逗号或空格分隔的 Telegram chat ID（群组为负数）。仅在群组策略为白名单时使用

故障排除

• 机器人未响应： 验证机器人令牌是否正确并确保配置已保存。点击 测试连接 进行诊断。
• 机器人不回私信： 打开 高级设置 检查 私信策略。如果是 Disabled，改成 Open 或 Allowlist；如果是 Allowlist，确认发起方的 Telegram 用户 ID（可通过 @userinfobot 获取）已加入 允许的用户 ID。
• Webhook 注册失败： 确保您的 LobeHub 订阅处于活动状态。Telegram 要求 Webhook 使用 HTTPS 端点，LobeHub 会自动提供。
• 群组聊天问题： 确保机器人已被添加到群组并具有读取消息的权限。使用 @username 提及机器人以触发响应。如果机器人在群组中没有响应，尝试将机器人从群组中移除后重新加入 ——Telegram 的隐私模式设置变更需要重新加入群组才能生效。