Hermes Agent 终端安装与 Telegram Gateway 配置示意

2026 年 Hermes Agent 保姆级安装教程：macOS / Linux / VPS 从零到 Telegram 7×24 只看这一篇

Nous Research 开源 Hermes Agent 截至 2026 年 6 月 GitHub 约 17.4 万星，主打自进化 Skill 与 20+ 消息平台 Gateway。本文不聊架构选型——只给一步都不跳的安装、配模型、Telegram 上线与 7×24 常驻清单，覆盖 macOS、Linux、VPS 与 WSL2。

1. 为什么装 Hermes 常卡在第三关

社区里「装上了但用不了」大多是三类隐性坑：

  1. PATH 未刷新：安装脚本把 hermes 写入 ~/.local/bin，未 source ~/.zshrc 就报 command not found，误以为是安装失败。
  2. LLM Key 空跑：Gateway 能起、Telegram 能连，但模型 401——hermes setup 写入的 Key 与 ~/.hermes/.env 不一致，或升级后需 hermes config migrate。
  3. 主机不在线：笔记本合盖即断，Skill 无法复利；社区实测 30 天 Skill 从 3 个增至 19 个、同类任务 token 降约 38%，前提是机器 7×24 在线（详见《Hermes 记忆架构》）。

2. Hermes Agent 是什么：与 OpenClaw 一句话对比

Hermes 由 Nous Research 维护，MIT 协议，当前稳定版 v2026.5.29.2。相对 OpenClaw 的插件生态，Hermes 更强调跨 Session 记忆与自动 Skill 封装；相对 LangGraph/CrewAI 等编排框架，它提供开箱即用的 CLI + Gateway，一条命令即可对话。本文覆盖：本地 macOS、Linux VPS、Telegram 随时可达——硬件深度对比见《三个月硬件实测》。

3. 环境要求决策矩阵（最低 vs 推荐）

项目 最低要求 推荐配置
操作系统 macOS 12+、Ubuntu 20.04+、WSL2 macOS 14+（Apple Silicon）/ Ubuntu 24.04 LTS
Python / Node 脚本自动装 3.11 / Node 18+ 无需手动装，install.sh 处理
内存 4 GB（仅 Gateway + 云端 API） 16 GB（本地 Ollama 或多 Skill 并发）
磁盘 1.5 GB（含 Skills 缓存） 20 GB SSD+
网络 可访问 GitHub raw + LLM API 稳定低延迟出口（Telegram 回调）

官方脚本会自动安装 uv、Python 3.11、Node.js 22、ripgrep、ffmpeg——不需要你提前手动装 Python 或 Node。

4. 八步安装与验证实操

  1. SSH 登录目标主机（本地 Mac 可跳过）：VPS 建议 Ubuntu 22.04+，开启 Remote Login 或 22 端口。
  2. 执行一键安装（macOS / Linux / WSL2 通用）：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

脚本会 Clone 到 ~/.hermes/hermes-agent/、配置全局 hermes 命令、拉取默认 Skills 注册表。无头服务器可加 --skip-browser。

  1. 刷新 Shell：source ~/.zshrc（macOS）或 source ~/.bashrc（Linux）。
  2. 健康检查：运行 hermes doctor，确认 Python、Node、ripgrep、ffmpeg、PATH 共 12 项通过；hermes --version 应显示 v2026.5.x。
  3. 首次对话冒烟：执行 hermes，输入「列出当前目录文件数」验证工具链。
  4. 配置 LLM（见下一节）。
  5. 接入 Telegram（见第六节）。
  6. 安装常驻服务：hermes gateway install && hermes gateway start && hermes gateway status。

5. 给 Agent 装大脑：hermes setup 配 LLM

新手推荐全向导：

hermes setup

或单独切换模型：hermes model。常用提供方：

  • OpenRouter：多模型实验首选，hermes config set OPENROUTER_API_KEY sk-or-xxxx
  • Anthropic / OpenAI：OAuth 或 API Key 写入 ~/.hermes/.env
  • Ollama：本地推理，填 Base URL + 模型名
  • Nous Portal：hermes setup --portal 零配置订阅 300+ 模型

配置完成后 hermes config check 可验证完整性；升级后若报 Missing config，执行 hermes config migrate。

6. Telegram 接入与 Gateway 7×24

6.1 创建 Bot：Telegram 搜索 @BotFather → /newbot → 获取 Token；用 @userinfobot 查你的数字 ID。

6.2 配置 Gateway（推荐向导）：

hermes gateway setup

选择 Telegram，粘贴 Token 与用户 ID。或手动写入 ~/.hermes/.env：

TELEGRAM_BOT_TOKEN=123456789:ABCdef...
TELEGRAM_ALLOWED_USERS=你的数字ID

6.3 启动与常驻：测试用 hermes gateway 前台跑；生产用 hermes gateway install + start。macOS 自动配置 launchd；Linux 可用 sudo hermes gateway install --system 开机自启。

6.4 群聊隐私模式：默认 Bot 在群里只响应 / 命令。群聊使用需在 BotFather 关闭 Group Privacy，并将 Bot 踢出再重新加入群组。

7. 部署平台横向对比（可引用数据）

平台 7×24 可用性 Skill 复利 月成本体感 适合人群
个人 MacBook ≈ 60%（合盖即断） 频繁中断 ¥0 硬件 + 高焦虑 仅 POC 测试
x86 VPS 4GB ≈ 99.5% 稳定但无 macOS Skill 按量 $5 级 纯 Linux 用户
Mac mini M4 月租 30 天 100% Skill 持续累积 固定月租、零初始投入 要 7×24 + Camoufox 等 macOS 能力

M4 统一内存让 Gateway、浏览器自动化与 SQLite WAL 共享地址空间，Gateway 常驻约 4.2 GB；launchd KeepAlive 比家用 Mac 合盖更可靠。短期验证（<18 个月）租比买更划算——不确定能否替你省 2 小时/天？先租 1 个月跑通再决定买断。

8. 常见报错速查表

报错 原因 解决
hermes: command not found PATH 未刷新 source ~/.zshrc 或新开终端
API key not set 未配置 LLM hermes model 或 hermes setup
Missing config after update 版本升级偏移 hermes config check && hermes config migrate
ModuleNotFoundError: dotenv 用了系统 Python 确认路径为 ~/.hermes/hermes-agent/venv/bin/hermes
Telegram 群聊无响应 隐私模式未关 BotFather 关 Group Privacy 并重入群

9. 常见问题

Q：Windows 能装吗？ PowerShell 有早期 Beta 脚本，但官方最稳路径仍是 WSL2 + Linux 安装命令；Dashboard 终端面板需 WSL2。

Q：必须本地模型吗？ 不必。Gateway + 云端 API 4GB 内存即可；Skill 复利才需要长期在线。

Q：退租前如何迁移？ 备份整个 ~/.hermes/，含 skills/、MEMORY.md、.env（勿泄露 Key）。

10. 总结：装通只是起点，让它一直跑着才是复利

按本文八步，你可以在 macOS、Linux 或 $5 VPS 上跑通 Hermes：一键脚本、hermes setup、Telegram Gateway、gateway install 常驻。笔记本与合盖 Mac 的真实限制是 Skill 链断裂与 macOS 专属工具（如 Camoufox）无法在 Linux 复现。

若你要 7×24 让 Agent 越用越省 token，SFTPMAC 远程 Mac mini M4 提供机房 SLA、SSH 即装即用与 ~/.hermes 的 SFTP/rsync 备份——把折旧变成可预测月费，专注任务而非半夜掉线。