206 lines
6.1 KiB
Markdown
206 lines
6.1 KiB
Markdown
# 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`）：
|
||
|
||
```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）。
|
||
|
||
## 使用
|
||
|
||
```bash
|
||
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 對話即可。維運：
|
||
|
||
```bash
|
||
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 日
|
||
忘掉我家在台北那條，改成新北
|
||
這件事只記這次對話就好，別長期存
|
||
```
|
||
|
||
依技能分類的更多範例（伺服器上共 27 類 skill，Telegram 打 `/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/tirith`（v0.3.3）。
|
||
|
||
> 2026-04-14 首次安裝時因暫時性網路問題下載失敗，留下 `.tirith-install-failed` 標記擋住重試。
|
||
> 2026-06-20 已手動重裝（從 `sheeki03/tirith` releases 下載、SHA-256 驗證、清除標記），現正常運作。
|