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 即可放行。

使用範例

Hermes 是有工具的 AI agent（終端機、瀏覽器、網路搜尋、檔案、排程、記憶、影像等），用自然語言下指令即可（CLI hermes chat 或 Telegram @SystemAidBot 皆通）。

一般任務：

幫我查今天台北天氣
把這段話翻成英文：……
寫一支 Python 腳本算費氏數列，跑給我看
總結這個網址的重點：https://…
這台機器的磁碟用量現在多少？

用工具做事：

打開瀏覽器去 google.com 搜「GLM-5.1」，截圖給我
在 /root 下建一個資料夾叫 test，列出來確認
看 hermes-gateway 的最近 log

排程 / 主動推播（需先在 Telegram 打 /sethome 設主頻道）：

每天早上 8 點推一則今日天氣給我
30 分鐘後提醒我喝水
每週一彙整一次系統狀態傳給我

記憶（長期，跨對話／session 都記得；「記住：」觸發存入，「忘掉…」觸發刪除）：

# 存事實
記住：我是羅楊竣，叫我 Timmy
記住：我在鴻發國際科技（MA）上班，老闆是 Jason
記住：我老婆 Una，兒子 Jay 2016 年生

# 偏好 / 工作習慣（以後照做）
以後回我都用繁體中文
給我答案先講結論再講細節

# 專案 / 待辦
記住：hermes 跑在 192.168.42.109，gateway 用 systemd 管
記下：客戶 A 的合約 6 月底到期

# 取出 / 回想
我兒子叫什麼？
你記得關於我的哪些事？

# 更新 / 刪除
更正：我兒子生日是 2 月 16 日
忘掉我家在台北那條，改成新北
這件事只記這次對話就好，別長期存

常用斜線指令：

指令	用途
/new	開新對話（清掉前文）
/status	看 session／模型／token
/model	換模型
/stop	停掉背景任務
/background <任務>	丟背景跑，不卡對話
/sessions	瀏覽／回到舊對話
/sethome	設主頻道（收排程結果）
/help	全部指令

安全元件 tirith

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

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