2026 Hermes Agent 保姆级安装教程：一行命令到 Telegram 7×24 常驻（macOS / Linux / Mac 云节点）
想在 Telegram 上随时使唤个人 AI Agent，却常卡在「curl 装完就没下文」：Gateway 不配对、模型没配、MacBook 合盖 Gateway 就断。本文面向 2026 年想跑通 Nous Research Hermes Agent 的开发者：从官方一行安装到 hermes doctor、LLM 配置、BotFather、launchd/systemd 常驻，含平台对比表、报错矩阵与 Mac Mini M4 月租衔接，一篇照做即可上线。
目录
1. 这篇安装教程写给谁
若你已读过站内 三层记忆与常驻必要性，知道 Hermes 为何需要 7×24；本篇专注怎么装。目标是从 Hermes Agent 官方仓库的一行脚本，走到手机 Telegram 能稳定对话、Gateway 在凌晨仍在线。流程覆盖：上游 install.sh、hermes doctor 清零告警、hermes setup / hermes model 配大脑、BotFather 拿 Token、hermes gateway setup 与 hermes gateway install。硬件可以是 macOS 本机、Linux VPS，或 SSH 登录的 Mac 云节点——不必先买 Mac mini。硬件选型与 TCO 见 树莓派 / VPS / Mac Mini 对比。
2. 跑 curl 之前的三个痛点
- 装得上，Gateway 不上线。 API Key 未写入
~/.hermes/.env、terminal.backend选错、或与其它 Agent 端口冲突，导致hermes --version正常但 Telegram 静默。 - Token 三十秒搞定，进程不能睡。 BotFather 发 Token 很快；长轮询 / webhook 要求 Gateway 进程永不挂起——笔记本合盖、家用宽带抖动、WSL2 随 Windows 休眠都会断连。
- Linux VPS「能跑」但和 macOS 工作流错位。 Hermes 在 Linux 上支持 20+ 通道与七种终端后端，但涉及 Keychain、Xcode、Camoufox 浏览器自动化的 Skill 仍倾向原生 macOS 或租用 Mac 节点。
3. 环境要求（最低 vs 推荐）
| 项目 | 最低 | 推荐 |
|---|---|---|
| 系统 | macOS 12+、Ubuntu 20.04+、WSL2 | macOS 14+（Apple Silicon）/ Ubuntu 24.04 LTS |
| Python / Node | 脚本自动装 3.11 / Node 22 | 无需手动装，install.sh 处理 |
| 内存 | 4 GB（仅 Gateway + 云端 API） | 16 GB（本地 8B 路由 + Gateway） |
| 磁盘 | 约 1.5 GB（含 Skills 缓存） | 20 GB SSD+ |
无头服务器可加 bash -s -- --skip-browser 跳过浏览器自动化依赖。Windows 原生尚未完整支持，建议 WSL2 后执行 Linux 安装脚本。
4. 平台对比：MacBook / 树莓派 / VPS / Mac Mini 月租
| 宿主 | 安装难度 | Telegram 7×24 | Skill / 记忆 | 24 个月成本体感 |
|---|---|---|---|---|
| 日常 MacBook | curl 最省事 | 差——合盖即断 | 清醒时好用，备份靠自觉 | 已有机器 ¥0，机会成本高 |
| 树莓派 4B/5 8GB | ARM 调 swap | systemd 尚可 | 本地 8B 吃紧，长任务易 OOM | 硬件约 ¥600 级 |
| 廉价 x86 VPS | systemd，无 macOS | 在线率好 | 多走纯 API 推理 | 约 ¥900–3600/两年 |
| Mac Mini M4 月租（VPSMAC 类） | 同 curl + launchd 模板 | 机房电 + SSH 运维 | 16/32GB UMA 混合路由 | 约 ¥800–1200/月含电 |
表用于决定在哪台机器上执行下文 Runbook，而非要不要装 Hermes。生产级 Telegram 桥接多数落在「Linux VPS + systemd」或「租用 Mac mini M4」——两者都能避免通勤本机背 Gateway uptime。
5. 可引用技术参数（2026）
- 社区规模： GitHub Stars 约 17 万+（2026-06），MIT 协议，Nous Research 维护；稳定版 v0.14.x，候选 v0.15.0。
- 安装器： 官方
install.sh自动装 uv、Python 3.11、Node 22、ripgrep、ffmpeg，仓库落在~/.hermes/hermes-agent/，全局hermes命令写入 PATH。 - 通道与模型： 单 Gateway 可挂 20+ IM 通道；OpenRouter 等支持 300+ 模型；社区实测同类任务 Skill 命中后 token 可降约 38%（需主机长期在线累积 Skill）。
6. 七步安装 Runbook
步骤 1 — 选宿主与基础包
macOS 执行 xcode-select --install；Ubuntu/Debian 装 curl git build-essential。建议独立 Unix 用户 hermes，勿与生产签名钥匙串混用。确认可访问 GitHub raw 与 LLM API 出口。
步骤 2 — 官方一行安装
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash source ~/.zshrc # 或 source ~/.bashrc hermes --version
成功标志：✅ Hermes Agent installed at ~/.hermes。Mac 云节点上 SSH 执行与本地完全一致。
步骤 3 — doctor 与全量向导
hermes doctor hermes setup
hermes doctor 自检 Python、Node、PATH、API Key、ffmpeg 等十余项。新手推荐 hermes setup 一次配齐；老手可用 hermes model 单独切提供商（OpenRouter / Anthropic / Nous Portal / Ollama）。密钥写入 ~/.hermes/.env，例如：hermes config set OPENROUTER_API_KEY sk-or-xxxx。
步骤 4 — 首次 CLI 对话
hermes
在交互式终端试一句：「统计当前目录文件数」或「搜索今日 AI 新闻并总结」，确认工具链与模型路由正常。
步骤 5 — Telegram（BotFather）
Telegram 搜索 @BotFather → /newbot → 复制 Token；用 @userinfobot 查自己的数字 ID。然后：
hermes gateway setup
选 Telegram，粘贴 Token 与 TELEGRAM_ALLOWED_USERS。群聊需在 BotFather 关闭 Group Privacy，并将 Bot 踢出重拉入群。也可手动写入 ~/.hermes/.env。
步骤 6 — 安装 Gateway 常驻服务
hermes gateway install hermes gateway start hermes gateway status
macOS 写入 launchd 用户服务；Linux 可用 sudo hermes gateway install --system 做开机自启，日志 journalctl -u hermes-gateway -f。
步骤 7 — 验收冒烟
Telegram 发消息应在一次模型 RTT 内回复；重启主机后再测；可选 hermes cron 做心跳。升级前加密备份整个 ~/.hermes/ 目录。
7. launchd 与 systemd 常驻
macOS： hermes gateway install 通常生成 LaunchAgent，配合 KeepAlive；改配置后 hermes gateway restart。Linux： 为用户 hermes 开启 linger（loginctl enable-linger hermes），再 enable user systemd 单元。systemd 适合 VPS，但若 Skill 依赖 Apple 栈，仍建议保留一台 macOS 节点分工。
8. 常见报错对照表
| 现象 | 原因 | 处理 |
|---|---|---|
hermes: command not found | PATH 未刷新 | source ~/.zshrc 或新开终端 |
| API key not set | 未配置 LLM | hermes model 或编辑 ~/.hermes/.env |
| Telegram 群聊不响应 | 隐私模式 / 未重入群 | BotFather 关 Group Privacy，踢 Bot 再拉 |
| Missing config after update | 版本升级配置迁移 | hermes config check && hermes config migrate |
| ModuleNotFoundError dotenv | 用了系统 Python 而非 venv | 确认路径为 ~/.hermes/hermes-agent/venv/bin/hermes |
| 重启后失效 | 未 install 服务 | 重跑 hermes gateway install 并查 launchd/systemd |
9. FAQ
WSL2 能装吗？ 可以实验；Windows 休眠仍会让 7×24 Telegram 不可靠，Gateway 最好跑在其它常开主机。重启会丢 Skill 吗？ 磁盘上 Skill 与用户画像仍在，仅进程内会话上下文清空——迁移前备份 ~/.hermes。必须 Telegram 吗？ 否，hermes gateway setup 也支持 Discord、Slack 等；Telegram 因 BotFather 最快，适合作为安装验收通道。
10. 结论
MacBook 一下午能跑完步骤 1–5，但合盖与家用宽带让 Telegram 主机不合格。树莓派省钱却易 OOM；五美元 Docker VPS 在线率高却缺 macOS 原生栈；WSL2 继承桌面休眠策略。当你已经 curl | bash、hermes doctor 全绿、BotFather 配对成功， durable 做法只有一个：把 hermes gateway install 放在永不睡眠的硬件上——对多数读者即 Mac mini M4 级 macOS（自购或月租）。
日常笔记本、廉价 VPS、WSL2 都能完成「安装教程」里的命令，却分别在合盖断连、无 macOS 工具链、桌面休眠上输掉 7×24。租赁 VPSMAC Apple Silicon Mac 云主机 用固定月费换机房 SLA、SSH 交付与退租擦除，安装命令与桌面 Mac mini 相同，只是 shell 跑在机房——这是从一行 curl 到凌晨三点 Telegram 仍在线、又不必绑死通勤本的最短路径。