建立 2026-09-19 更新 2026-09-19

Gateway 與聊天軟體

Gateway 是一個常駐的背景程序，負責連接各個訊息平台：每個平台有自己的轉接器（adapter），收到訊息後依聊天室分別維護對話，再交給同一個代理處理。排程任務（cron）也由 Gateway 每 60 秒檢查一次。有了它，你就能用手機隨時跟家裡或雲端主機上的 Hermes 說話。

官方支援的平台很多，包括 Telegram、Discord、Slack、WhatsApp、Signal、Email、SMS、Matrix、Microsoft Teams、LINE、飛書／Lark、釘釘、企業微信等，完整清單見官方 Messaging Gateway。

安裝與管理

hermes gateway setup                    # 互動式設定所有訊息平台
hermes gateway                          # 前景執行（測試用）
hermes gateway install                  # 安裝成使用者服務（Linux／macOS）
sudo hermes gateway install --system    # Linux：開機就啟動的系統服務
hermes gateway start                    # 啟動服務
hermes gateway stop                     # 停止服務
hermes gateway status                   # 查看狀態

第一次請先跑 hermes gateway setup，依畫面選平台並貼上 token；確認能收發訊息後，再用 hermes gateway install 讓它常駐。

範例：接上 Telegram

Telegram 是最快能在手機上用起來的平台。

在 Telegram 找 @BotFather，傳送 /newbot，依指示取名，取得 Bot token。
找 @userinfobot，取得你自己的數字 User ID。
執行 hermes gateway setup，選 Telegram，貼上 token 與 User ID。
啟動 Gateway，用手機對你的 bot 說一句話。

User ID 的用途是「只讓你自己使用」，見下一節。官方步驟見 Telegram 設定。

誰可以跟它說話

Gateway 的預設是拒絕所有不在允許名單、也沒有配對過的使用者。這很重要：能操作終端機的機器人，等於把你的電腦交給對方。

允許名單

寫在 ~/.hermes/.env：

TELEGRAM_ALLOWED_USERS=123456789,987654321
DISCORD_ALLOWED_USERS=123456789012345678
GATEWAY_ALLOWED_USERS=123456789,987654321   # 所有平台共用

GATEWAY_ALLOW_ALL_USERS=true 會放行所有人，官方不建議使用。

DM 配對

不想手動查 ID，可以用配對：陌生人私訊 bot 時，會收到一組一次性的配對碼（一小時後失效），由你在終端機核准：

hermes pairing list                        # 待核准與已核准的使用者
hermes pairing approve telegram XKGH5N7P   # 用配對碼核准
hermes pairing revoke telegram 123456789   # 撤銷

管理員與一般使用者

被允許的使用者分兩級：管理員可用全部指令，一般使用者只能用你明確開放的指令（/help 與 /whoami 永遠可用）。以 Discord 為例：

gateway:
  platforms:
    discord:
      allow_admin_from: ["111"]
      user_allowed_commands: [status, model]

聊天中的指令

在任何已連接的平台上，都可以用斜線指令控制對話：

指令	功能
`/new` 或 `/reset`	開始新對話
`/model [供應商:模型]`	查看或切換模型
`/personality [名稱]`	設定人格
`/retry`	重試上一則訊息
`/undo`	移除上一輪對話
`/status`	顯示對話資訊
`/whoami`	查看你的權限等級
`/stop`	停止正在執行的代理
`/approve`、`/deny`	核准或拒絕危險指令
`/sessions [all] [search <關鍵字>]`	列出或搜尋過去的對話
`/resume [名稱]`	接續指定的對話
`/bg <提示>`	在背景對話中執行

對話會一直保留

Gateway 上的對話會持續到你用 /new 重設為止，並不會自動清空。此外，最終回覆會先寫入持久化的紀錄；若 Gateway 在傳送途中當機，重啟後會補送，並加上「Recovered reply」標示。