66 lines
1.9 KiB
Markdown
66 lines
1.9 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` 即可放行。
|
||
|
||
## 安全元件 tirith
|
||
|
||
命令安全守衛 binary，安裝於 `/root/.hermes/bin/tirith`（v0.3.3）。
|
||
|
||
> 2026-04-14 首次安裝時因暫時性網路問題下載失敗，留下 `.tirith-install-failed` 標記擋住重試。
|
||
> 2026-06-20 已手動重裝（從 `sheeki03/tirith` releases 下載、SHA-256 驗證、清除標記），現正常運作。
|