Telegram 閘道
這是什麼
把 Telegram 訊息路由至 Hermes 工作階段的行動控制介面。
白話解釋
想像一條直通郵件處理中心的電話線，而且還能分成多個私人分機，也就是 Telegram 主題，讓工作討論與私人討論不會混進同一個收件匣。只有已列入允許清單的號碼能通過，除非管理者明確把這扇門開放給所有人。
為什麼重要
Telegram 聊天訊息會透過這個閘道直接進入 Hermes 工作階段，因此手機能真正控制代理，而不只是接收通知。初學者路線經常使用 Telegram 作為行動入口，可能是因為相較於需要複雜審核流程的平台，Telegram Bot API 較容易設定。它和 WhatsApp、Discord 共用底層 gateway 服務，不會另外執行一套連線層。
運作方式
plugins/platforms/telegram/adapter.py 的 TelegramAdapter 繼承共用平台介接器，透過 python-telegram-bot 的 start_polling 長輪詢 Telegram 伺服器，不必提供可從公開網路連入的事件掛鉤 URL，因此沒有固定網址的筆記型電腦或家用伺服器也能運作。重試階梯會監看停滯連線，必要時可改走直接 IP 網路路徑。gateway/platforms/base.py 的共用介接器會把 Telegram 論壇主題與私人聊天主題對應到 Hermes thread_id，讓回覆回到問題原本所在的討論線，而不是主聊天。允許哪些使用者傳入訊息，由介接器每次依寄件者檢查的環境變數決定；另一個由 cron 排程器讀取的環境變數，則指定 cron 或通知輸出的預設聊天位置。
具體範例
使用者在私人 Telegram「採買」主題中傳訊息給 Hermes 機器人。訊息透過長輪詢連線抵達，並帶有該主題的 thread_id；Hermes 將寄件者 Telegram ID 與允許清單比對，確認符合後，把文字交給已追蹤該主題的代理工作階段。代理為購物清單新增兩項物品並產生簡短回覆；由於回覆帶回相同 thread_id，訊息會出現在「採買」主題，而不是機器人的一般聊天中。
如何連結
「Telegram 閘道」屬於「介面」系列。最直接相關的概念包括：「通訊閘道」、「WhatsApp 閘道」、「代理執行環境」、「個人作業系統」。這些連結描述教學關係，不取代來源證據。
來源證據
plugin:platforms/telegram— 此基準關聯未納入核准的核心原始碼投影驗證範圍，不能單獨作為已驗證程式行為的依據；上文另依釘選版本來源人工核對。
工作流程
相關文章
- Hermes Agent 完整入門：打造安全、可持續成長的私人 AI 助理
- 從零到個人 AI 助理：在 VPS 上建置 Hermes 而不造成混亂
- 十個 Hermes 工作流程，將聊天機器人變成 24/7 助理
- Hermes Agent 初學者指南：從空伺服器到實用自動化的逐步路線
- 用 Hermes、本機模型、自動化與共享知識庫打造個人 AI 系統
- 十個被低估的 Hermes 功能，展現其真實力量
- 掌握 Hermes Desktop：從本機聊天應用程式到永遠線上的代理控制中心
- 深入 Hermes：代理迴圈、上下文、記憶、閘道與 Cron 任務如何協同運作