AI Agent Hermes 2026.06.01

2026 Hermes Agent 保姆级安装： 一行命令到 Telegram 7×24 常驻

JEX
JEXCLOUD 工程团队
· 2026年6月1日 · 约 14 分钟阅读

Hermes Agent 是 Nous Research 在 2026 年开源的 MIT 自进化 AI Agent 框架，GitHub 星标已突破 17 万。与「关窗口就清零」的聊天机器人不同，它通过 MEMORY.md、Skill 目录与 Gateway 把任务沉淀为可复用能力——但这一切的前提是：你得先把它装对、配好模型、再把 Telegram 网关跑成 7×24。

本文面向「只想看一篇装完」的读者：① 说明 Hermes 与 OpenClaw、LangGraph 的差异及安装前痛点；② 给出 curl 一键安装 → hermes doctor → hermes setup → Telegram Gateway → launchd/systemd 常驻 的完整路径；③ 提供 LLM 选型矩阵、六步验收清单与常见报错表。硬件选型与树莓派实测见 三方案硬件对比，记忆架构见 持久记忆专题。

01 Hermes Agent 安装前：2026 爆火与三类真实痛点

Hermes Agent 在 2026 年 2 月首发后，凭借「任务结束自动写 Skill、下次同类任务 token 降约 38%」的社区观测迅速出圈。与 OpenClaw 侧重多 Agent 工作流编排、LangGraph 偏图状态机不同，Hermes 的差异化是：原生跨 Session 记忆 + 20+ 消息平台 Gateway + MCP 即插即用。很多人在 Star 仓库后卡在三个环节：

  • 环境碎片化：以为要先装 Python 3.11、Node 22、ripgrep、ffmpeg——其实官方脚本会 via uv 自动补齐，但 PATH 未刷新会导致 hermes: command not found。
  • 模型未配：安装成功却报 API key not set，CLI 能进却无法推理。
  • 网关未常驻：Telegram Bot 配好，笔记本合盖后 Bot「假死」，Skill 复利与跨周记忆中断。

一句话定位：Hermes 装得顺不顺，取决于你是否把「安装 + 模型 + 常驻网关」当成一条流水线，而不是三次独立试错。

当前稳定线已到 v0.15.1（2026.5.29），修复了 v0.15.0 在 loopback 模式下 Dashboard 无限重载等问题（见 官方 Release）。下文命令以 macOS / Linux / WSL2 为准；Windows 原生 PowerShell 可用官方 install.ps1，浏览器 Dashboard 聊天面板仍建议 WSL2。

02 Hermes Agent 环境要求与 LLM 提供商决策矩阵

官方安装脚本唯一硬性前置是 Git（git --version 可用即可）。Python、Node、ripgrep、ffmpeg 均由脚本检测并安装，无需 sudo。

宿主环境最低 vs 推荐（Gateway + 云端 API 模式）
项目 最低 推荐
操作系统 macOS 12+ / Ubuntu 20.04+ / WSL2 macOS 14+（Apple Silicon）/ Ubuntu 24.04 LTS
内存 4 GB（仅 Gateway + API） 16 GB+（本地 Ollama 8B）
磁盘 约 1.5 GB（含 Skills 缓存） 20 GB SSD+（日志与模型权重）
网络 可访问 GitHub raw 与 LLM API 稳定低延迟出口（Telegram 入站）
LLM 提供商怎么选（安装后 hermes setup / hermes model）
提供商 适合谁 配置要点
Nous Portal 想零配置快速试跑 hermes setup --portal OAuth
OpenRouter 多模型实验、单 Key OPENROUTER_API_KEY 写入 ~/.hermes/.env
Anthropic / OpenAI 生产 Claude / GPT API Key 或 OAuth（Max 计划）
Ollama / VLLM 本地推理、隐私敏感 Base URL + 模型名；内存建议 16GB+

无头服务器（无 GUI 浏览器自动化）安装时加 --skip-browser，可避免拉取 Camoufox 相关依赖。配置统一落在 ~/.hermes/.env 与 ~/.hermes/config.yaml。

03 Hermes Agent 一键安装：六步从 curl 到首次对话

在 macOS、Linux 或 WSL2 终端执行官方脚本（与 安装文档 一致）：

install.sh 
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 无头 VPS 可选
# curl -fsSL ... | bash -s -- --skip-browser

source ~/.zshrc
hermes doctor
hermes --version
hermes setup
hermes

脚本会自动：安装 uv → Python 3.11 → Node.js 22 → ripgrep / ffmpeg → 克隆到 ~/.hermes/hermes-agent/ → 将 hermes 加入 PATH → 拉取默认 Skills 注册表。成功标志为终端出现 ✅ Hermes Agent installed at ~/.hermes。

  1. 执行 curl 安装：确保 Git 可用；企业代理环境需先配置 https_proxy。
  2. 刷新 Shell：source ~/.zshrc 或 source ~/.bashrc，否则下一行会 command not found。
  3. 健康检查：hermes doctor 自检 Python、Node、PATH、API Key 等约 12 项。
  4. 确认版本：hermes --version 建议 ≥ v0.14.x；升级用 hermes update。
  5. 配置模型：hermes setup 或 hermes model 写入 ~/.hermes/.env。
  6. 冒烟对话：运行 hermes，输入「统计当前目录文件数」或「搜索今日 AI 新闻并总结」验证工具链。

也可用短链 curl -fsSL https://get.hermes-agent.org | bash（与社区文档一致）。Windows PowerShell：iex (irm .../install.ps1)；Android Termux 同 Linux 脚本，官方提供 Termux 适配说明。

04 Hermes Agent Telegram 接入与 Gateway 7×24 常驻

要让手机随时找到 Agent，需完成 Bot 创建 + Gateway 配置 + 系统服务托管三步。

  1. 创建 Bot：Telegram 搜索 @BotFather，/newbot 取名，用户名须以 bot 结尾，保存 Token。
  2. 获取用户 ID：向 @userinfobot 发消息得到数字 ID，用于白名单。
  3. 交互配置（推荐）：hermes gateway setup，选 Telegram，粘贴 Token 与 ID。
  4. 或手动写入 .env：TELEGRAM_BOT_TOKEN=... 与 TELEGRAM_ALLOWED_USERS=你的ID。
  5. 前台试跑：hermes gateway，手机给 Bot 发消息确认回复。
  6. 后台常驻：macOS 执行 hermes gateway install + hermes gateway start（launchd）；Linux 可用 sudo hermes gateway install --system + systemd，日志 journalctl -u hermes-gateway -f。

群聊必读：Bot 默认隐私模式仅响应 / 命令。群用需在 BotFather 关闭 Group Privacy，并将 Bot 踢出群后重新邀请。Discord / Slack 等渠道同样走 hermes gateway setup，详见 官方消息平台文档。

gateway.service 
hermes gateway install
hermes gateway start
hermes gateway status

# Linux 开机自启（可选）
sudo hermes gateway install --system
sudo hermes gateway start --system

05 Hermes Agent 可引用规格与常见安装报错速查

  • GitHub 规模（2026-06）：约 175,000 Stars，MIT 协议，295+ 贡献者量级（仓库）。
  • 安装体积：含 Skills 缓存约 1.5 GB 起；~/.hermes/ 运行三个月后常见 200–600 MB 增长（视 Skill 与日志而定）。
  • Skill 复利前提：社区观测 30 天内 Skill 数 3 → 19 时，同类任务 token 约降 38%——需主机 7×24 在线，否则复利中断。
  • 网关内存（macOS 实测归纳）：仅 Gateway + SQLite 约 1.2–1.8 GB；叠加 Ollama 8B 建议 24 GB 统一内存。
安装与 Gateway 高频报错
报错 / 现象 原因 处理
hermes: command not found PATH 未刷新 source ~/.zshrc 或新开终端
API key not set 未配置 LLM hermes model 或编辑 ~/.hermes/.env
升级后配置丢失 版本迁移 hermes config check && hermes config migrate
群聊 Bot 不回复 隐私模式 / 未重入群 BotFather 关 Group Privacy 后重邀 Bot

可选扩展：在 ~/.hermes/config.yaml 声明 mcp_servers 接入 GitHub、数据库等 MCP；无 GUI 服务器用 hermes mcp login + SSH 隧道完成 OAuth。

06 Hermes 装在哪台机器：平台对比与 JEXCLOUD 收束

安装落地平台对比（Gateway + Skill 复利场景）
平台 7×24 可用性 安装路径成熟度 适合阶段
个人 MacBook 合盖即断 官方 curl 最顺 POC / 周末调试
Linux VPS 高，非 macOS 需 --skip-browser，部分 Skill 路径不同 已有 DevOps 团队
JEXCLOUD Mac Mini M4 机房 SLA，独立 IPv4 与本地 Mac 相同命令链 Telegram 生产 + 本地 8B

笔记本与超卖 VPS 的常见短板：① 网关长连接不稳定（睡眠、NAT、邻居 IO）；② macOS 专属浏览器自动化 Skill 在纯 Linux 上无法 1:1 复现；③ 无独享内存时并行子 Agent 易触发 OOM，hermes doctor 通过但生产仍抖。

更稳妥的路径：在 JEXCLOUD 裸金属 Mac Mini M4 上按月开通，SSH 执行与本文相同的安装命令，Gateway 用 launchd KeepAlive，~/.hermes 始终落在你的租用磁盘——无虚拟化超卖、Telegram 入站稳定、退租前可 rsync 备份技能与记忆。规格与 M4.S / M4.M / M4.XL 选型见 定价页；下单与区域延迟见 订单页 与 帮助中心。

返回博客列表
标签： Hermes Agent 安装教程 Telegram Mac Mini M4 Gateway