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/.envGLM_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/.envTELEGRAM_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.109gateway 用 systemd 管
記下:客戶 A 的合約 6 月底到期

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

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

依技能分類的更多範例(伺服器上共 27 類 skillTelegram 打 /commands 可分頁瀏覽全部):

# 開發 / DevOps / GitHub
這個 repo 有什麼 bug幫我看 src/ 底下
git 把目前改動 commit 並推到 main
監控這台機器 CPU超過 80% 就通知我

# 研究 / 網路 / feeds
深入研究 GLM-5.1 跟 GPT-5 的差異,列出出處
追蹤 Hacker News 首頁,每天早上摘要前 5 則

# 資料 / 圖表
這個 CSV 幫我算各欄平均,畫長條圖
把部署架構畫成流程圖

# 媒體 / 影像
幫我把這張圖去背
畫一張賽博龐克風格的貓

# 通訊 / 生產力
幫我擬一封請假信,明天請一天
把這段會議錄音轉逐字稿並抓重點

# 智慧家庭 / Apple需先接 Home Assistant / Apple 整合)
把客廳的燈關掉
冷氣設到 26 度

# 社群 / 內容
把這段話改寫成一則 X 貼文,限 280 字
想 5 個 YouTube 影片標題,主題是居家咖啡

# 休閒 / 遊戲
推薦今晚適合兩人看的電影
陪我玩文字接龍

# 自動化代理 / MCP
這個任務你自己規劃步驟,分階段做完回報我
列出你現在掛載了哪些 MCP 工具

# 紅隊 / 安全(限自家授權環境)
幫我掃這台主機開了哪些 port
檢查這段程式有沒有 SQL injection 風險

# 後台 / 排程
/background 把 /var/log 掃一遍找錯誤,跑完再回我
每天凌晨 3 點備份 hermes 設定

多模態(直接在 Telegram 丟給 bot不用打字描述

(傳照片)這是什麼?幫我看
(傳收據)幫我把金額抓出來記帳
(傳語音)直接講,它會聽
(傳 PDF這份文件幫我摘要

Session / 推理控制(對話進行中):

/queue 等一下順便幫我查天氣      # 排到下一輪,不打斷
/steer 改用台幣計價              # 下個工具呼叫後插話
/branch                          # 分岔探索,不動原對話
/compress here 5                 # 壓縮上下文、保留最近 5 輪
/undo                            # 倒退一輪重問
/rollback                        # 還原檔案系統檢查點
/reasoning high                  # 調高推理強度(難題用)
/usage                           # 看 token 用量與額度

常用斜線指令:

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

安全元件 tirith

命令安全守衛 binary安裝於 /root/.hermes/bin/tirithv0.3.3)。

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

Description
No description provided
Readme 44 KiB
Languages
Markdown 100%