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

> 逐步設定：透過 BotFather 建立機器人，在 Hermes Agent 中新增權杖和存取清單，然後啟動閘道。語音訊息、排程工作，以及透過手機控制。

Source: https://ailoot.ai/blog/zh-hant-tw/hermes-agent-telegram-setup/
Canonical: https://ailoot.ai/blog/zh-hant-tw/hermes-agent-telegram-setup/
Language: zh-Hant-TW
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-118
Revision: sha256-d0f1a7a985d52ddc7f16ce826eb07b32b09c73853be36e82aa813f557e084e19


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

如果你還沒有 Hermes，請先閱讀[這個代理程式是什麼，以及如何安裝](https://ailoot.ai/blog/zh-hant-tw/hermes-agent-install-setup/)，然後再回來連接 Telegram。

其他操作說明請參閱[Ailoot 文件](https://ailoot.ai/docs/)。

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="本節重點">

重點

你需要已安裝並連接模型的 Hermes Agent，以及 Telegram 帳號。在 Telegram 建立機器人是免費的，Hermes 是開放原始碼專案。模型、雲端語音辨識，以及你若決定讓機器人全天候運作所需的伺服器，可能會另外產生費用。

</div>

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="本節重點">

重點

在 Telegram 開啟 @BotFather，傳送 /newbot，選擇顯示名稱和以 `bot` 結尾的唯一使用者名稱。BotFather 會回覆格式如 123456789:ABCdef... 的權杖，這就是機器人的金鑰。請妥善保存，勿讓任何人看到。

</div>

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

1.  ### 開啟 @BotFather

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

2.  ### 傳送 /newbot 指令

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

3.  ### 取得權杖

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

<div class="aside" data-semantic="callout" role="note" aria-label="注意">

注意

權杖可讓持有人完全控制機器人：知道權杖的人就能控制它。如果權杖外洩，請立即在與 BotFather 的對話中使用 `/revoke` 指令撤銷，並取得新的權杖。

</div>

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="本節重點">

重點

快速的「使用 QR code 建立」方法會自動偵測你的 ID。請將它記在權杖旁邊。這是你的帳號號碼；存取清單不能使用帶有 @ 符號的使用者名稱。Hermes 會使用這個 ID 建立存取清單：沒有這份清單，閘道就不會回覆任何人，包括你。

</div>

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

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



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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="本節重點">

重點

執行 `hermes gateway setup` 設定精靈並選擇 Telegram：它會要求你輸入權杖和 ID，然後儲存所有設定。手動設定則是在 `~/.hermes/.env` 檔案中加入兩行。接著使用 `hermes gateway` 啟動閘道，幾秒內機器人就會上線。

</div>

|  | 設定精靈 | 手動設定 |
|----|----|----|
| 執行項目 | `hermes gateway setup` | 使用編輯器開啟 `~/.hermes/.env` 檔案 |
| 輸入內容 | 依照精靈提示輸入權杖和 ID | 手動輸入兩個變數 |
| 儲存位置 | 精靈會將資料儲存在設定中 | 直接在 `.env` 中輸入設定 |
| 適用對象 | 所有人；建議使用此方法 | 熟悉設定檔或使用指令碼設定的人 |

1.  ### 執行設定精靈

    ```bash
    hermes gateway setup
    ```

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

2.  ### 選擇 Telegram 並輸入資料

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

3.  ### 啟動閘道

    ```bash
    hermes gateway
    ```

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

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

```bash
TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789
```

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="本節重點">

重點

Telegram 機器人可以讀取文字和語音訊息、接收檔案和圖片、在執行危險指令前直接於聊天室中詢問是否允許，並以按鈕顯示模型選項。預設情況下，只有最終回覆、確認要求和指令確認會發出提示音。

</div>

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

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

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

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

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="本節重點">

重點

排程工作會將結果傳送到主聊天室：開啟與機器人的對話並傳送 `/sethome` 指令即可。從主題開始的背景工作會回到同一個主題。關鍵條件是閘道必須持續執行；否則電腦關機時，機器人就會保持無回應。

</div>

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

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="本節重點">

重點

`TELEGRAM_ALLOWED_USERS` 授權列出的發送者 ID 在私訊與群組使用。群組也可另行授權：`TELEGRAM_GROUP_ALLOWED_CHATS` 允許每個列出群組的所有成員。請保密權杖；提及過濾器控制何時回覆，不控制誰能存取。

</div>

你的機器人可能會依使用者名稱出現在 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` 中模式的訊息，同時忽略一般群組訊息。

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="本節重點">

重點

原因是 Telegram 的隱私模式：預設情況下，群組中的機器人只能看到指令和對自身訊息的回覆。透過 @BotFather 關閉此模式：/mybots → Bot Settings → Group Privacy → Turn off。接著必須先將機器人從群組移除，再重新加入——Telegram 會記住舊設定。另一種方法是不關閉隱私模式，直接將機器人設為群組管理員。

</div>

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

修正方式：

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

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="本節重點">

重點

先確認閘道是否正在執行，以及權杖和存取清單中的 ID 是否正確。群組問題請檢查隱私模式；語音辨識請檢查 STT 提供者；透過 Edge TTS 傳送語音回覆則請檢查 ffmpeg。

</div>

| 症狀 | 原因 | 處理方式 |
|----|----|----|
| 機器人完全沒有回覆 | 權杖錯誤，或閘道未執行 | 檢查 `.env` 中的權杖，重新啟動 `hermes gateway`，並查看同一個終端機中的記錄 |
| 機器人回覆「unauthorized」 | 你的 ID 不在存取清單中 | 確認你的 ID，將其加入 `TELEGRAM_ALLOWED_USERS`，並重新啟動閘道 |
| 私人聊天室有回覆，群組中沒有回應 | 隱私模式 | 在 BotFather 選擇「Turn off」，再將機器人從群組移除並重新加入，或將它設為管理員 |
| 語音訊息沒有轉錄 | 尚未設定語音辨識 | 本機辨識會隨 faster-whisper 套件安裝；雲端選項需要各自的金鑰 |
| 透過 Edge TTS 傳送的語音回覆變成檔案，而非一般語音訊息 | 缺少 ffmpeg | 安裝 ffmpeg——Edge TTS 需要它才能轉換為 Telegram 語音訊息格式 |
| 權杖失效 | 權杖已撤銷 | 透過 BotFather 使用 `/revoke` 和 `/newbot`（或 `/token`）取得新權杖，替換 `.env` 中的值，並重新啟動閘道 |

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="本節重點">

重點

不一定需要伺服器，但只有閘道正在執行時，機器人才會運作。連接機器人是免費的；你只需支付模型費用。多位使用者可以透過 ID 清單連接。機器人無法查看私人聊天室。超過 20 MB 的檔案需要額外設定。

</div>

<div class="section">

### 常見問題

機器人需要伺服器才能運作嗎？

不需要。開始使用只要有安裝 Hermes 的電腦即可。請記住，機器人只有在閘道執行時才會運作。關閉電腦或讓它進入睡眠後，機器人就會停止回應，直到電腦重新運作。若要讓它全天候運作，可以將代理程式移至伺服器——我們另有一篇相關指南。

連接機器人要花多少錢？

連接是免費的。Telegram 不會向機器人收費，而 Hermes Agent 是開放原始碼專案。代理程式所連接的模型，以及你若想讓它全天候運作所需的伺服器，可能會另外產生費用。

我可以讓太太或團隊使用這個機器人嗎？

可以。在 `TELEGRAM_ALLOWED_USERS` 清單中，以逗號分隔各個 ID，清單中的每個人都能私訊機器人。如果你透過 `TELEGRAM_GROUP_ALLOWED_CHATS` 允許該聊天室，群組中的任何成員都可以使用機器人——根據文件，這就是允許聊天室清單的運作方式。

機器人能看到我的私人對話嗎？

不能。Bot API 只會將私人聊天室中傳送給機器人的訊息提供給機器人；群組中則會套用本節所述的 Telegram 隱私模式。機器人無法存取你與其他人的對話。

為什麼機器人拒絕接收大型語音訊息？

公開 Bot API 的檔案下載上限為 20 MB；超過此大小就會被拒絕。Hermes 文件說明了一種使用本機 Bot API 伺服器的替代方式，可將上限提高至 2 GB。只有在你打算接收超過 20 MB 的檔案時才需要這麼做。文件連結位於文章末尾的「來源」一節。

我可以替機器人新增功能嗎？

可以。Hermes 有技能和外掛，這些是可供代理程式使用的現成能力。如何為這類 AI 代理程式機器人安裝外掛，另有專文說明：如何在 Telegram 上的 AI 代理程式機器人中安裝外掛。

</div>

<div class="section" role="doc-bibliography" aria-label="來源">

### 來源

- [Hermes Agent: Telegram setup](https://hermes-agent.nousresearch.com/docs/user-guide/messaging/telegram) — 原始指南的主要來源，由作者於 12.09.2026 查閱
- [Hermes Agent: messaging gateway](https://hermes-agent.nousresearch.com/docs/user-guide/messaging)
- [Hermes Agent: installation](https://hermes-agent.nousresearch.com/docs/getting-started/installation)
- [Hermes Agent: quickstart](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart)
- [Hermes Agent: scheduled tasks](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron)
- [BotFather](https://t.me/BotFather) — Telegram 官方的機器人建立工具

</div>





準備好之後，認識一下 [Ailoot](https://ailoot.ai/)。

## 常見問題：如何將 Hermes Agent 連接到 Telegram，並透過手機管理工作

### 個人允許清單會擋住已核准群組中的其他人嗎？

若透過 TELEGRAM_GROUP_ALLOWED_CHATS 授權整個聊天室，就不會；群組每位成員都獲准使用。TELEGRAM_ALLOWED_USERS 授權個別發送者，開放群組前請檢查兩項設定。

### 要求 @ 提及，就能讓群組只對特定使用者開放嗎？

不能。提及與模式設定控制哪些訊息觸發回覆，不會取消已授權群組全體成員的權限。


## Ailoot · 公司及其專案組合

Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。

公司及其專案組合：數百萬客戶，每月銷售額達數十億。

Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。