配置通道 - Telegram

摘要

Telegram 通道采用 Bot Token 接入，适合快速把 Hermes Agent 接入 Telegram 私聊或群组：先在 Telegram 中通过 BotFather 创建机器人并获取 Bot Token，再填入 LightVela 管理台的「通道」完成接入。准备工作是一个 Telegram 账号，以及完成模型配置（或直接使用套餐按月提供的模型积分）。Bot Token 属于敏感凭证，请勿公开分享；接入后 Agent 在 Telegram 中与其他通道共享同一份人格与长期记忆。

Telegram 通道采用 Bot Token 接入方式，适合快速将 Hermes Agent 接入 Telegram 私聊或群组场景。

本页覆盖

• 使用手机 Telegram 扫码或打开链接授权

• 在 Telegram 中与 Hermes Agent 进行对话

操作步骤

1. 进入管理台

登录 LightVela，点击右上角「我的 Hermes」进入管理台，找到「通道」按键。

2. 选择 Telegram 通道

找到 Telegram 模块，点击「+连接」。

3. 打开「Telegram」

1. 打开你的 Telegram 应用

2. 搜索 @BotFather 并打开聊天窗

3. 输入 /start

4. 输入 /newbot

5. 输入你的 agent 的名字：名字需独特，并结尾为 "bot"

6. 拷贝 HTTP API：

4. 复制 HTTP API 进「Telegram」

将 HTTP API Token 粘贴到 token 栏位中。

5. 与 Telegram 里的新机器人聊天

点击 BotFather 提供的链接，现在你就可以开始与它互动了。

进入该机器人的聊天界面，发送测试消息：

你好

几秒内收到 Hermes Agent 回复。

6. 可选：在 BotFather 中开启群消息

仅当你需要在群组中使用机器人时，才需要完成第 6 步和第 7 步。 完成第 5 步后，私聊已经可以正常使用。

1. 在 Telegram 打开 @BotFather。
2. 发送 /mybots。
3. 选择已经连接到 Hermes Agent 的机器人。
4. 进入「Bot Settings」。
5. 选择「Group Privacy」。
6. 选择关闭隐私模式。

7. 可选：将机器人加入群组并测试

1. 打开要使用的 Telegram 群组。
2. 选择「添加成员」或对应的群管理操作。
3. 按机器人用户名搜索，并将机器人添加到群组。
4. 在群内使用 @机器人用户名 提及机器人并发送测试消息。

关闭 Group Privacy 后，机器人可以接收被提及的群消息并回复。

成功状态

• 管理台「已接入通道」列表中出现"Telegram"

• Telegram 联系人中可查找到对应机器人

• 发送消息后能收到 Hermes Agent 回复

• 在已添加机器人的群组中 @ 机器人发送消息后能收到 Hermes Agent 回复

支持的消息类型

接入成功后，Telegram 机器人除了能够接收、回复基础文本信息外，还支持更多消息类型，详情如下：

常见问题

通道说明

• 消息类型：支持文本、图片、视频、文件、语音等多种类型，详见上方「支持的消息类型」

• 群聊支持：支持群消息。先在 BotFather 中关闭 Group Privacy，再将机器人添加到群组，并通过 @机器人用户名 发起对话

• 连接中断：长时间无响应可能为授权被撤销，回管理台重新授权接入即可

下一步

• 配置通道 - WhatsApp — 国际用户沟通与客户服务

• 配置通道 - Discord — 社群运营与开发者社区

• 配置通道 - Slack — 团队协作、工作区通知和频道任务流转

• 配置通道 - QQ — 手动创建机器人，AppID/AppSecret 接入

• 配置技能 — 扩展 Hermes Agent 能力