如何將 Hermes Agent 連接到 Telegram，並透過手機管理工作

離開電腦時，你可以透過手機在 Telegram 中傳訊息給 Hermes Agent，或口述工作內容，並在同一個聊天室收到結果。排程工作的結果會傳送到你指定為主聊天室的對話中，只需指定一次。

如果你還沒有 Hermes，請先閱讀這個代理程式是什麼，以及如何安裝，然後再回來連接 Telegram。

其他操作說明請參閱Ailoot 文件。

將 Hermes Agent 連接到 Telegram 需要什麼？#

hermes doctor 指令會檢查 Hermes 安裝狀態和模型連線。我們會在 Telegram 應用程式中建立機器人，你需要使用電腦在終端機執行指令。

如何透過 BotFather 建立機器人？#

每個 Telegram 機器人都有一組權杖，也就是控制機器人的秘密金鑰。這組權杖由 Telegram 官方機器人 @BotFather 發出。

1. 開啟 @BotFather

   在 Telegram 搜尋 @BotFather，或開啟 t.me/BotFather。真正的 BotFather 會有藍色驗證勾號。點選「Start」開始對話。

2. 傳送 /newbot 指令

   BotFather 會詢問兩個名稱。第一個是顯示名稱，可以任意取名，例如「My Agent」。第二個是使用者名稱：必須是唯一的，且以 bot 結尾，例如 moy_agent_bot。

3. 取得權杖

   BotFather 會傳送祝賀訊息，以及一串格式如 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ 的長字串。這就是機器人權杖。請複製完整字串。

還有一種快速方式，不需要手動和 BotFather 對話。在 Hermes 網頁儀表板（hermes dashboard）和桌面應用程式的「Messaging → Telegram」頁面中，有一個「Create with QR」按鈕：用手機掃描代碼後，Hermes 會建立機器人、偵測你的 ID、將權杖存入設定，並重新啟動閘道。以下步驟說明手動設定方式；如果你選擇使用 QR，請直接前往確認連線。

如何找到 Telegram ID？為什麼需要它？#

Telegram 帳號有兩種識別碼：帶有 @ 符號的公開使用者名稱，以及內部使用的數字 ID。Hermes 使用的是數字 ID。

上方介紹的快速「使用 QR code 建立」方法會自動偵測你的 ID。請將它記在權杖旁邊。

如何將權杖提供給 Hermes Agent 並啟動閘道？#

1. 執行設定精靈

   hermes gateway setup
   

   在安裝 Hermes 的電腦上執行指令。精靈會列出可用的訊息應用程式。

2. 選擇 Telegram 並輸入資料

   精靈會要求你輸入機器人權杖和允許的 ID（可以輸入多個，以逗號分隔），並將所有資料儲存在設定中。

3. 啟動閘道

   hermes gateway
   

   閘道會啟動並連接到 Telegram。幾秒後，從應用程式傳送任意訊息給機器人：如果 Hermes 有回覆，代表連線已準備就緒。

若要改用手動設定，請開啟 ~/.hermes/.env 檔案並新增兩行，將 BotFather 提供的權杖和你的數字 ID 填入：

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

第二行授權這些人在私訊與群組使用；另行授權整個群組也能授予存取權。多位使用者請以逗號分隔。儲存檔案後，使用相同的 hermes gateway 指令啟動閘道。

如果機器人在私人聊天室中仍然沒有回應，請在同一個終端機檢查閘道記錄，並先確認權杖和存取清單中的 ID 是否正確；其他錯誤可參閱文章末尾的表格。

Telegram 機器人在手機上能做什麼？#

你在手機上最常用到的功能有五種。

文字和語音訊息。用文字寫下工作，或口述語音訊息——設定好語音辨識後，Hermes 會將其轉錄並理解內容。使用本機提供者不需要金鑰；所有處理都會在代理程式執行的電腦上完成。

檔案和圖片。你可以將文件、試算表或螢幕截圖轉傳給機器人——代理程式會以附件形式收到。它也能傳回產生的檔案：例如要求一份報告，它就會以檔案形式傳到聊天室。

危險操作確認。代理程式即將執行刪除檔案等危險操作時，會先在聊天室中詢問：回覆「yes」或「y」就會執行；回覆「no」或「n」就會取消。

用按鈕代替輸入回覆。代理程式需要釐清資訊時，會傳送附有內嵌選項按鈕的問題——點選一個選項後，代理程式就會繼續工作。不帶引數執行 /model 指令，會顯示同類型按鈕組成的模型選擇選單。

降低通知音。預設情況下，只有最終回覆、確認要求和指令確認會讓手機響起。像是「calling a tool」和「compressing context」這類服務通知會以靜音方式送達，因此手機不會在每個步驟都響起。如果你希望每個步驟都有聲音通知，請在設定中切換模式。

如何在聊天室收到背景工作的結果？#

排程工作的主聊天室。Hermes 支援排程工作，例如「每天早上7:43幫我整理摘要」。結果會傳送到主聊天室；在與機器人的對話中直接傳送 /sethome 指令即可指定一次。只要閘道持續執行，摘要就會自動送達。

背景工作。你可以傳送長時間工作，讓它在背景執行，同時繼續處理其他事情：準備完成時，機器人會傳訊息通知你。從主題開始的工作會將答案傳回同一個主題，因此不會遺失。

重要限制：只有閘道正在執行時，機器人才會回覆。如果你關閉執行 Hermes 的電腦，或讓它進入睡眠，機器人就會停止回覆，直到電腦重新運作。若要讓機器人一直保持線上，請將代理程式移至伺服器：我們另有一篇如何讓 Hermes Agent 全天候運作的指南。預設情況下，閘道會輪詢 Telegram 以取得新訊息；對於沒有流量就會進入睡眠的雲端平台，文件提供 Webhook 模式，反轉連線方向，改由 Telegram 向機器人傳送請求。

如何避免陌生人使用機器人？#

你的機器人可能會依使用者名稱出現在 Telegram 搜尋結果中，因此防護依靠兩件事：存取清單和妥善保密權杖。

先用 TELEGRAM_ALLOWED_USERS 設定個人發送者存取。群組也要檢查 TELEGRAM_GROUP_ALLOWED_CHATS：列出的群組中，所有成員都可使用，即使其 ID 不在個人清單。只有個人清單為空，不能證明所有群組都關閉。

第二是權杖。權杖不應出現在螢幕截圖、轉傳訊息或程式碼儲存庫中。如果權杖外洩，請在 BotFather 中使用 /revoke 指令撤銷。接著在設定中輸入新權杖，並重新啟動閘道。

群組的發送者授權與聊天室授權不同。透過 TELEGRAM_GROUP_ALLOWED_CHATS 允許的群組，其成員即使不在 TELEGRAM_ALLOWED_USERS 也可使用。若只應授權特定人，不要開放整個群組，並依已安裝版本設定及驗證發送者限制。如果你只希望機器人在群組中被呼叫時才回覆，可以設定 telegram.require_mention——如此一來，機器人會回應 @ 提及、回覆它的訊息、像 /command@yourbot 這樣的指令，以及符合 telegram.mention_patterns 中模式的訊息，同時忽略一般群組訊息。

為什麼機器人在群組中沒有回應？如何修正？#

新的 Telegram 機器人預設會啟用隱私模式；Hermes 文件將它描述為機器人在群組中使用時最常見的困惑來源。在此模式下，機器人只會收到以 / 開頭的指令、對自身訊息的回覆，以及服務通知。一般群組訊息不會送到機器人，因此代理程式設定無法解決這個問題。

修正方式：

1. 開啟 @BotFather 並傳送 /mybots。
2. 選擇你的機器人。
3. 開啟「Bot Settings」→「Group Privacy」→「Turn off」。
4. 將機器人從群組移除，再重新加入。

第四個步驟很容易被忽略，接著機器人就會「仍然沒有回應」。Telegram 會記住機器人加入群組時的隱私設定，必須將機器人從群組移除並重新加入後，才會更新設定。

如果你不想全面停用隱私模式，還有另一種方式：將機器人設為群組管理員。無論隱私模式如何設定，管理員機器人都能收到所有訊息。

常見連線錯誤及處理方式#

大家還會問哪些關於 Telegram 上 Hermes Agent 的問題？#

準備好之後，認識一下 Ailoot。