2026 Hermes Agent 保姆級安裝教程：macOS / Linux / VPS 從零到 Telegram 7×24
Nous Research 的 Hermes Agent 在 2026 年以 GitHub 高星與「一條命令裝完」出圈，但實務上卡在 hermes: command not found、模型 401、Telegram 無回覆的人並不少。本文只講安裝到上線：官方 install.sh、~/.hermes 初始化、hermes setup 配模型、BotFather 取得 TELEGRAM_BOT_TOKEN，以及 hermes gateway install 讓 Bot 真正 7×24。記憶架構與硬體選型請見站內姊妹文；這裡是「一步都不跳」的落地清單。
1. 三個最常見卡關點
- PATH 未刷新： CLI 在
~/.local/bin，腳本跑完當下找不到hermes。 - 憑證只在互動 shell： launchd 守護的 gateway 讀不到 API Key，Telegram 401 或靜默。
- 閘道未常駐： 終端關掉即停，合蓋後 Webhook 逾時。
2. macOS / Linux / VPS 環境決策矩陣
| 維度 | macOS（含遠端 Mac） | Linux / WSL2 | 雲端 VPS |
|---|---|---|---|
| 最低配置 | Apple Silicon 或 Intel，16GB RAM，30GB 碟 | 2 vCPU、4GB RAM、Ubuntu 22.04+ | 同 Linux；注意 swap 與 NVMe |
| 推薦配置 | Mac mini M4 16～24GB，~/.hermes 放本機 NVMe |
4 vCPU、8GB+，獨立資料碟 | 8GB+ 記憶體，固定公網 IP |
| 7×24 常駐 | launchd + 關閉休眠（最佳） | systemd user unit | 穩定但無 macOS 工具鏈 |
| Telegram 接入 | Token 寫 LaunchAgent EnvironmentVariables | EnvironmentFile + daemon-reload |
需開放 HTTPS 或長連出站 |
試跑可用 WSL2；Telegram 長期穩定請用 macOS 常駐節點或固定 IP VPS。
3. 步驟一：官方 install.sh 一鍵安裝
macOS、Linux 或 WSL2 執行（無需 sudo，寫入 ~/.hermes）：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc # 或 source ~/.bashrc
hermes --version成功：hermes --version 有輸出且出現 ~/.hermes/。預留 30GB 給 Skills 與日誌。
4. 步驟二：hermes doctor 健康檢查
hermes doctor確認 Node ≥ 20、~/.hermes 可寫、埠未占用。PATH 警告時把 ~/.local/bin 寫入 shell rc。
5. 步驟三：hermes setup 配置 LLM
hermes setup精靈寫入 ~/.hermes/config.yaml：OpenRouter 試跑、Anthropic/OpenAI 生產、Ollama 本機（127.0.0.1:11434）。完成後 hermes chat "ping" 測模型再進通道。
6. 步驟四：Telegram BotFather 與 Token
- 在 Telegram 搜尋 @BotFather，傳送
/newbot，依提示取名並取得 Bot Token。 - 把 Token 設為環境變數（名稱依 Hermes 版本可能為
TELEGRAM_BOT_TOKEN，以hermes setup或文件為準）：
export TELEGRAM_BOT_TOKEN="123456789:ABCdefGHIjklMNOpqrsTUVwxyz"生產勿明文進 Git；macOS 放 LaunchAgent，Linux 用 EnvironmentFile。換 Token 後先 deleteWebhook 再重啟。
7. 步驟五～六：gateway install 與 7×24 常駐
模型與 Token 就緒後，安裝並啟動訊息閘道：
hermes gateway install
hermes gateway start
hermes gateway statusmacOS： launchd 註冊後關閉休眠。Linux： loginctl enable-linger $USER 避免 SSH 斷線停服務。Telegram 發測試句，查 ~/.hermes/logs/ 與 gateway status。
8. 常見報錯對照表
| 現象 / 報錯 | 可能原因 | 建議處理 |
|---|---|---|
| hermes: command not found | PATH 未含 ~/.local/bin | source shell rc；hermes doctor |
| Model 401 / unauthorized | API Key 未注入守護進程 | 改 LaunchAgent / systemd EnvironmentFile |
| Telegram 無回覆 | Token 空、Webhook 衝突、閘道未起 | gateway status；deleteWebhook 後重啟 |
| gateway install 失敗 | 埠占用、權限不足 | lsof 查埠；非 root 使用者重試 |
| SSH 斷線 Bot 就停 | 未用 install 註冊守護 | hermes gateway install + launchd/systemd |
9. 常見問題
Q：curl | bash 安全嗎？ 可先下載審閱；只寫使用者目錄。
Q：和 OpenClaw 共存？ 分開埠與 ~/.hermes 即可。
Q：VPS 夠嗎？ Telegram + 雲端 API 通常夠；本地 Ollama 請升 Mac mini M4。
10. 總結與遠端 Mac 建議
門檻在憑證進守護進程與閘道 7×24。六步：install → doctor → setup → BotFather → gateway install → status。
不想維護 UPS 與合蓋斷線，SFTPMAC 遠端 Mac mini M4 租賃 提供 launchd、NVMe ~/.hermes 與 SFTP 同步。硬體與記憶細節見 20260527、20260528 姊妹文。