配置通道 - 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 能力