想在 2026 年跟做 Hermes Agent 安装、却卡在 PATH、API Key 或 Telegram 群聊不响应的开发者,本文是一条可复制的保姆级路径:从官方 curl 一行安装hermes setup 配模型、hermes gateway 接 Telegram 并 launchd/systemd 7×24 常驻,覆盖 macOS、Linux 与云 Mac。你将获得五大痛点拆解、四平台对比表、六步实操与常见报错对照。可与 三层记忆架构30 天实测 交叉阅读。
01

2026 年 Hermes Agent 是什么?和 OpenClaw 差在哪?

Hermes AgentNous Research 在 2026 年发布的 MIT 开源自主 Agent:进程长期驻留、任务完成后把成功路径写成 ~/.hermes/skills/ 下的 Skill,下次同类任务 token 消耗可明显下降。与一次性 ChatGPT 网页对话不同,它更像住在你机器上的工程师——可从 Telegram 收指令,在后台跑 shell、检索、改仓库。

OpenClaw 相比:OpenClaw 以消息渠道 Gateway + workspace 文件见长,生态围绕 openclaw CLI;Hermes 强调 Closed Learning Loop(自进化 Skill)、三层记忆(会话 / MEMORY.md / USER.md)与 MCP 扩展。和 LangGraph、CrewAI 等多 Agent 编排框架相比,Hermes 更偏个人或小团队的单机常驻助理,安装入口就是一条官方脚本,而不是先搭 Python 图状态机。

本文不重复「为什么要 7×24」(见记忆架构文),专注装得上、配得通、Telegram 能回、服务能常驻。覆盖 macOS 本地、Linux VPS/WSL2、以及 KVMNODE 云 Mac 上的生产部署。

01

PATH 未刷新:装完直接敲 hermes 报 command not found,其实是 Shell 没 reload。

02

API Key 空缺:没跑 hermes setuphermes model,首条对话就报 API key not set。

03

笔记本合盖:Gateway 随睡眠退出,Telegram 消息堆积,Skill 文件在涨但复利曲线平。

04

群聊隐私模式:Bot 默认只响应 / 命令,未在 BotFather 关 Group Privacy 就以为「坏了」。

05

无头机缺依赖:Linux 服务器未加 --skip-browser 或误用系统 Python,ModuleNotFoundError 频发。

下面先选部署平面,再跟六步命令。

02

Hermes Agent 装在哪?MacBook、VPS 还是月租 Mac Mini?

Hermes 官方安装脚本在 macOS 与 Linux 上测试最充分:自动装 uv、Python 3.11、Node.js 22、ripgrep、ffmpeg,仓库落在 ~/.hermes/hermes-agent/。纯 API + Gateway 模式 4GB 内存可跑;要本地模型或浏览器自动化 Skill,建议 16GB 起。

部署平面7×24 可用性官方路径完整度Skill 复利月成本体感
个人 MacBook合盖即断(≈60%)高(macOS)频繁中断¥0 硬件 + 焦虑
树莓派 4B 8GB≈88%Linux,无 MetalI/O 瓶颈硬件一次性
x86 VPS 4GB≈99.5%Linux,无 Camoufox 等 macOS Skill较稳按量计费
月租 Mac Mini M4机房 SLA,≈100%最高(launchd + UMA)持续累积固定 OpEx,可退租

安装教程解决「能跑起来」;平台选型解决「跑多久、Skill 能不能复利」——生产 Telegram 助理建议独占 macOS 节点。

03

Hermes Agent 一键安装与环境自检:curl、doctor、setup

官方推荐一行安装(macOS / Linux / WSL2 / Termux):

shell
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc
hermes doctor
hermes --version

脚本会:检测并安装 uv;用 uv 装 Python 3.11(无需 sudo);装 Node.js 22、ripgrep、ffmpeg;克隆仓库到 ~/.hermes/hermes-agent/;把 hermes 加入 PATH;拉取默认 Skills 注册表。成功标志一般为 ✅ Hermes Agent installed at ~/.hermes

无头服务器跳过浏览器栈:

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

hermes doctor 会自检 Python、Node、ripgrep、ffmpeg、PATH、API Key 等十余项。配置模型用向导或分项命令:

shell
hermes setup
hermes model
hermes config set OPENROUTER_API_KEY sk-or-xxxx
hermes

Key 写在 ~/.hermes/.env。支持 Nous Portal、OpenRouter、Anthropic、OpenAI、GitHub Copilot、Ollama 等。装完可先本地 CLI 对话验证,再开 Gateway。

提示:升级后若报 Missing config,执行 hermes config check && hermes config migrate。勿用系统 Python 直接跑,应使用 ~/.hermes/hermes-agent/venv/bin/hermes

04

六步把 Hermes Agent 接到 Telegram 并 7×24 常驻

01

创建 Bot:Telegram 找 @BotFather,/newbot,记下 Token;@userinfobot 查自己的数字 ID。

02

Gateway 向导:hermes gateway setup,选 Telegram,粘贴 Token 与 TELEGRAM_ALLOWED_USERS

03

前台试跑:hermes gateway,手机给 Bot 发消息,确认能回。

04

安装守护:macOS hermes gateway install && hermes gateway start;Linux 可用 sudo hermes gateway install --system

05

群聊(可选):BotFather 关 Group Privacy,Bot 踢出再拉进群;否则群聊只响应 / 命令。

06

云 Mac 落单:要 7×24 与 macOS Skill 路径,在 订购入口 租独占 M4,SSH 执行同样命令;退租前打包 ~/.hermes/

shell
hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status
journalctl -u hermes-gateway -f

迁云时参考 30 天迁移清单:备份 skills、.env、config.yaml,新节点重装后恢复目录即可。

05

环境参数、Skill 复利与常见报错速查

三条可引用口径:① 官方安装脚本固定拉 Python 3.11 + Node 22,磁盘预留约 1.5GB(含 Skills 缓存),本地模型建议 20GB SSD+。② 社区记录同类任务 Skill 命中后 token 可降约 38%(前提:主机 7×24 在线,Skill 才能持续复利)。③ 2026 年 6 月稳定线多为 v0.14.x,v0.15 候选版升级后务必跑 hermes config migrate

报错原因处理
command not foundPATHsource ~/.zshrc
API key not set未配模型hermes model
群聊无响应隐私模式BotFather 关 Privacy,重拉 Bot
dotenv 模块缺失系统 Python用 venv 内 hermes

摊开替代方案:合盖 MacBook 装得上却守不住 Gateway;低价 Linux VPS 能跑 Telegram 却缺 macOS 浏览器自动化与 Metal 本地推理;树莓派 I/O 与内存顶不住长会话 SQLite。在 KVMNODE 租赁独占 Mac Mini M4,用 launchd 守护、UMA 扛 Gateway + 可选本地模型,SSH 与本地无差别安装,按月 OpEx 验证 30 天再决定买断——对要把 Hermes 当生产助理、又要 Skill 复利的团队,通常比「凑合笔记本 + 偶尔开机」更省心。档位见 定价页,交付与网络见 帮助中心