2026 Hermes Agent 保姆级安装教程：macOS / Linux / VPS 一键部署 + Telegram 7×24 常驻，只看这一篇

Hermes Agent 由 Nous Research 维护，MIT 许可，文档站 hermes-agent.nousresearch.com。与一次性 CLI 工具不同，它设计为长期运行的网关进程：Telegram 消息、终端 TUI、Tool Calling、子 Agent 调度与技能 Markdown 自蒸馏共用同一核心。截至 2026 年 6 月，主分支活跃版本为 v0.15.x，安装脚本会自动处理运行时依赖，而非要求你手动拼 pyenv + nvm。

安装成功的判据不是 hermes --version 能打印——而是：模型 Provider 可用、hermes doctor 全绿或仅剩可接受警告、至少一个聊天网关（本文以 Telegram 为例）能收发消息，且进程在 SSH 断开后仍由 launchd 或 systemd 拉起。若你关心记忆为何必须持久主机，请先读 架构选型文；本文专注「把二进制跑起来并接上 Telegram」。

可选能力方面：Hermes 支持通过 MCP 挂载外部工具服务器（文件系统、浏览器、数据库等），但生产最小集通常是「网关 + 模型 API + 本地 SQLite / Markdown 记忆路径」。技能自进化会在任务结束后把有效流程写入技能库，无需额外插件——这也是安装后应预留数百 MB 磁盘的原因。

社区 Issue 里最高频的失败模式并非编译错误，而是环境碎片化与主机画像不匹配。下表汇总安装阶段常见卡点——对照后可少花一半排障时间。

• 运行时版本漂移：系统自带 Python 3.9 或 Node 16 会导致 uv 解析失败；官方脚本目标为 Python 3.11+ 与 Node 22，混用 Homebrew 与系统 Python 时 PATH 顺序错误尤为常见。
• 网关与 CLI 混淆：在笔记本跑通 TUI 后关盖，Telegram Bot 立刻离线；用户以为「安装坏了」，实际是缺少守护进程。
• 模型 Key 与网络：hermes model 指向的 OpenRouter / Nous Portal / OpenAI 兼容端点若被防火墙拦截，表现像「Agent 无响应」而非显式 401。
• 磁盘与权限：在 Docker 无持久卷或 /tmp 清空的 VPS 上，state.db 与技能目录每次重启归零，与 30 天实测 中「记忆不涨反跌」现象一致。
• 与 OpenClaw 栈并行：若团队已在评估 OpenClaw + Ollama 本地 Agent，Hermes 更偏「多平台网关 + 闭环技能」；二者可同机但应分用户与端口，避免争用 11434 或网关监听口。

结论很直白：安装 Runbook 必须包含主机选型。MacBook 适合开发调试；Telegram 7×24 生产网关应落在始终在线、磁盘可审计的节点上——这也是下文推荐 NUKCLOUD Mac Mini M4 云端租赁 的原因。

下列步骤在 macOS 14+、Ubuntu 22.04+ 与 NUKCLOUD 云端 Mac 上均已验证；Linux VPS 路径相同，仅守护单元改用 systemd（见后文）。

1. 01
   准备主机与 SSH：若走云端 Mac，先在 下单页 选定 16GB+ 实例并在 控制台 获取 SSH；冻结 macOS / 发行版小版本号，创建专用 Unix 用户（如 hermes），勿用 root 长期跑网关。
2. 02
   执行官方一键安装：登录后运行下方 curl 脚本；脚本会下载 Hermes 发行包、配置 uv 虚拟环境、安装 Python 3.11 与 Node 22 工具链。完成后重开 Shell 或 source 安装器提示的 profile 片段。
3. 03
   验证 CLI：运行 hermes --version 确认 v0.15.x；执行 hermes doctor，逐项修复红色项——常见为缺少 API Key、state.db 目录不可写、或 Node 模块未 link。
4. 04
   交互式 setup：hermes setup 引导配置默认模型 Provider、记忆文件路径与 TUI 偏好；生产环境建议把 MEMORY.md、技能目录指向持久 Home 子目录，而非 /tmp。
5. 05
   本地冒烟：hermes tui 发起一轮 Tool Calling 对话，确认模型响应与磁盘写入；可选 hermes model list / hermes model set 切换 OpenRouter 等 200+ 模型 端点。
6. 06
   Pin 版本并备份：记录当前 release tag；对 ~/.hermes（或 setup 指定路径）做首次 tarball 备份。生产网关禁止未经 staging 直接跟踪 main 分支。

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
exec $SHELL -l
hermes --version
hermes doctor
hermes setup
hermes tui

安装后第一件事是让模型通路稳定。hermes model 子命令（或 setup 写入的配置文件）指定 Provider：常见为 OpenRouter API Key、Nous Portal 或自建 OpenAI 兼容网关。切换模型不会自动迁移记忆文件——大改 Provider 前请备份 state.db 与 Markdown 记忆。

MCP（可选）：在配置中声明 MCP Server 列表后，Hermes 可把文件浏览、Git、数据库等能力以 Tool 形式注入 Agent 循环。最小生产集可暂不启用 MCP，待网关稳定后再加；每增一个 MCP 进程，内存占用约增加 100–300 MB，在 16GB 云端 Mac 上仍可控。

技能自进化：复杂任务结束后，Hermes 将可复用流程蒸馏为 Markdown 技能文件（单条约 2,200 字符 上限，含去重）。无需额外「训练脚本」——只要网关持续在线、磁盘持久，技能库会随使用在数周内从个位数涨到数十条。这与 三层记忆架构 第二层直接对应。

• 仓库热度：GitHub Star 约 17.4 万（2026 年 6 月，以页面实时数为准），MIT 许可，数百贡献者。
• 运行时栈：安装器捆绑 Python 3.11、Node 22、uv 包管理，避免系统 Python 3.9 陷阱。
• 模型广度：通过 OpenRouter 等可切换 200+ 模型；本地 Metal 推理需 macOS 主机，与 Linux VPS 纯 API 路径不同。

Telegram 是 Hermes 社区最常用的生产渠道：手机端发消息，网关进程转发到 Agent 核心，回复经 Bot API 返回。配置入口为 hermes gateway setup（或文档中等价交互流），按提示粘贴 BotFather Token、可选 Webhook / 长轮询模式，并指定监听端口与日志路径。

macOS — launchd：在 ~/Library/LaunchAgents/ 创建 plist，ProgramArguments 指向 hermes gateway start（或文档当前子命令），KeepAlive 设为 true，StandardOutPath / StandardErrorPath 指向轮转日志。加载：launchctl load ~/Library/LaunchAgents/com.hermes.gateway.plist。NUKCLOUD 云端 Mac 与自购 Mini 路径相同。

Linux — systemd：在 /etc/systemd/system/hermes-gateway.service 写 Unit，User=hermes，ExecStart=/home/hermes/.local/bin/hermes gateway start，Restart=always。然后 systemctl enable --now hermes-gateway。VPS 上务必确认 出站 443 可达 Telegram API。

1. 01
   在 @BotFather 创建 Bot，复制 Token；勿提交到 Git，写入 chmod 600 的本地 env 文件。
2. 02
   运行 hermes gateway setup，选择 Telegram，粘贴 Token，完成 Webhook 或 polling 配置。
3. 03
   前台试运行 hermes gateway start，手机向 Bot 发 /start，确认往返延迟与 Tool 调用日志正常。
4. 04
   写入 launchd plist 或 systemd unit；管理 TUI 仅走 SSH 隧道，勿将管理端口暴露公网。
5. 05
   模拟宕机：kill 网关进程，确认 30 秒内自动拉起；检查 state.db 与技能目录仍在。
6. 06
   设置日志轮转与磁盘告警；Telegram 渠道稳定运行 72 小时后再邀请团队进群。

hermes gateway setup
hermes gateway start
hermes gateway status

同一套安装命令在不同主机上的运维摩擦差异巨大。下表帮助你在「先装在哪」阶段就做对选择。

安装与网关阶段的常见报错可按下表快速定位：

需要 Hermes + 可选本地 Metal 推理同机时，Linux VPS 无法替代 macOS；需要 Telegram 7×24 且不想赌家庭宽带时，五美元 VPS 的超卖与长摘要卡顿会在用户模型刚「变聪明」时放大宕机成本。对要可审计磁盘、静态 SSH 边界、还能在 Agent 空闲窗口跑 Xcode CI 的团队，NUKCLOUD 多区域云端 Mac Mini M4 通常是比「笔记本 + 廉价 VPS」更稳的生产平面——可从 定价页 按小时 pilot 再决定是否自购 Mini。