Telegram
通過 Telegram 與 Hermes Agent 對話。
配置通道 - Telegram
Telegram 通道採用 Bot Token 接入方式，適合快速將 Hermes Agent 接入 Telegram 私聊或群組場景。
本頁覆蓋
-
使用手機 Telegram 掃碼或打開鏈接授權
-
在 Telegram 中與 Hermes Agent 進行對話
操作步驟
1. 進入管理台
登錄 LightVela，點擊右上角「我的 Hermes」進入管理台，找到「通道」按鍵。
2. 選擇 Telegram 通道
找到 Telegram 模塊，點擊「+連接」。
3. 打開「Telegram」
-
打開你的 Telegram 應用
-
搜索 @BotFather 並打開聊天窗
-
輸入
/start -
輸入
/newbot -
輸入你的 agent 的名字：名字需獨特，並結尾為 "bot"
-
拷貝 HTTP API：
4. 複製 HTTP API 進「Telegram」
將 HTTP API Token 粘貼到 token 欄位中。
5. 與 Telegram 裏新的機器人聊天
點擊 BotFather 提供的鏈接，現在你就可以開始與它互動了。
進入該機器人的聊天界面，發送測試消息：
你好幾秒內收到 Hermes Agent 回覆。
成功狀態
-
管理台「已接入通道」列表中出現"Telegram"
-
Telegram 聯繫人中可查找到對應機器人
-
發送消息後能收到 Hermes Agent 回覆
支持的消息類型
接入成功後，Telegram 機器人除了能夠接收、回覆基礎文本信息外，還支持更多消息類型，詳情如下：
| Telegram 機器人支持的消息類型 | 是否支持 |
|---|---|
| 接收文本信息 | ✅ 已支持 |
| 接收圖片、視頻 | ✅ 已支持 |
| 接收文件 | ✅ 已支持 |
| 回覆文本信息 | ✅ 已支持 |
| 回覆圖片、視頻 | ✅ 已支持 |
| 回覆文件 | ✅ 已支持 |
| 主動發送消息（如定時發送提醒） | ✅ 已支持 |
常見問題
| 現象 | 可能原因 | 處理方式 |
|---|---|---|
| BotFather 無法創建機器人 | 機器人名稱或 username 不符合 Telegram 要求 | 確認機器人顯示名稱可自由填寫，但 username 必須以 bot 結尾，例如 my_hermes_bot |
| BotFather 未返回 HTTP API Token | 創建流程未完成 | 回到 BotFather 對話，重新執行 /newbot 並按提示完成名稱和 username 設置 |
| 粘貼 Token 後提示無效 | Token 複製不完整，或包含多餘空格/換行 | 重新從 BotFather 複製完整 HTTP API Token，並粘貼到 token 欄位 |
| 點擊接入後無響應 | 網絡延遲或授權未完成 | 刷新管理台頁面確認狀態；若未接入成功則重新操作 |
| Telegram 中找不到機器人 | 未點擊 BotFather 提供的機器人鏈接，或未開始對話 | 點擊 BotFather 提供的鏈接，進入機器人頁面後點擊 Start |
| 發送消息後無回覆 | 模型未配置、體驗積分耗盡，或機器人尚未成功接入 | 檢查「1. 模型」卡片的「當前模型」狀態，並確認 Telegram 通道顯示為已接入 |
| 機器人無法接收群消息 | Telegram 群組隱私模式限制 | 在 BotFather 中檢查 Bot Settings，必要時關閉 Group Privacy，或在群內 @ 機器人發送消息 |
| 如何解除綁定 | — | 在「已接入通道」列表中刪除該 Telegram 記錄 |
| 同一個 Telegram Bot 能否接入多個 Hermes Agent | 通常不建議，一個 Bot Token 應綁定一個 Hermes Agent | 如需多個 Hermes Agent，建議分別創建不同的 Telegram Bot |
通道説明
-
消息類型：支持文本、圖片、視頻、文件、語音等多種類型，詳見上方「支持的消息類型」
-
群聊支持：當前不支持群聊，僅支持 1 對 1 對話
-
連接中斷：長時間無響應可能為授權被撤銷，回管理台重新授權接入即可
下一步
-
配置通道 - WhatsApp — 國際用户溝通與客户服務
-
配置通道 - Discord — 社群運營與開發者社區
-
配置通道 - QQ — 手動創建機器人，AppID/AppSecret 接入
-
配置技能 — 擴展 Hermes Agent 能力