hermes/README.md

hermes

Hermes Agent 部署與使用筆記。

部署位置

項目	值
主機	192.168.42.109 (root)
安裝路徑	/root/.hermes
版本	hermes-agent v0.17.0
進入點	/usr/local/bin/hermes → /root/.hermes/hermes-agent/venv/bin/hermes

模型 / API

走 Z.AI GLM（設定於 /root/.hermes/config.yaml）：

model:
  default: glm-5.1
  provider: zai
  base_url: https://api.z.ai/api/paas/v4

API key 存於 /root/.hermes/.env 的 GLM_API_KEY（同步進 auth.json 的 zai credential pool）。

使用

ssh root@192.168.42.109
hermes                 # 進互動 chat
hermes -z "你的問題"    # 一次性問答
hermes model           # 換模型 / provider
hermes status          # 狀態
hermes --help          # 所有子指令

Telegram

透過 gateway 整合 Telegram bot。

項目	值
Bot	小幫手 (@SystemAidBot)
Token	/root/.hermes/.env 的 TELEGRAM_BOT_TOKEN
白名單	TELEGRAM_ALLOWED_USERS=949023145（限 Timmy 本人）
服務	systemd user service hermes-gateway，已啟用 linger（撐過登出 / 開機自啟）

直接在 Telegram 跟 @SystemAidBot 對話即可。維運：

hermes gateway status                      # 狀態
hermes gateway restart                     # 重啟
journalctl --user -u hermes-gateway -f     # 即時 log

預設無白名單時會拒絕所有人；新使用者第一次傳訊會被擋並在 log 留下其 user ID， 把 ID 加進 TELEGRAM_ALLOWED_USERS（逗號分隔）再 hermes gateway restart 即可放行。

安全元件 tirith

命令安全守衛 binary，安裝於 /root/.hermes/bin/tirith（v0.3.3）。

2026-04-14 首次安裝時因暫時性網路問題下載失敗，留下 .tirith-install-failed 標記擋住重試。 2026-06-20 已手動重裝（從 sheeki03/tirith releases 下載、SHA-256 驗證、清除標記），現正常運作。