2026 Hermes Agent 保姆级安装部署指南:
一键安装、Telegram 7×24 接入与 Mac Mini 常驻选型

2026 年 Hermes Agent(Nous Research,GitHub 约 17 万星)成了开源圈最热的自进化 AI Agent之一——能跨会话记忆、自动沉淀 Skill、并通过 Gateway 接入 Telegram 等 20+ 平台。若你卡在「装不上、配不好 Key、Telegram 没回执」,这篇就是写给你的:一条命令完成环境,再用六步 Runbook 跑到 hermes gateway 7×24 常驻,并对比 MacBook / VPS / Mac Mini M4 月租 谁更适合当生产主机。

01

为什么 2026 年都在装 Hermes Agent?和 OpenClaw 差在哪

Hermes Agent 不是聊天壳,而是 MIT 协议下的常驻自主 Agent:完成一类任务后会自动生成可复用 Skill(社区实测同类任务 token 可降约 38%),并通过 SESSION → MEMORY.md → USER.md 三层记忆跨会话延续上下文。与偏「编排框架」的 LangGraph / CrewAI 或偏「渠道网关」的 OpenClaw 相比,Hermes 的差异化在于原生 Skill 自进化 + 跨 Session 持久记忆 + 一条 curl 装完全栈

本文不重复「为什么要换 Mac」(见站内 VPS 迁移实测)或「记忆架构拆解」(见 三层记忆硬件文),而是专注安装部署 Runbook:macOS / Linux / WSL2 一键脚本、hermes doctor、LLM 配置、首次对话、Telegram Bot 与 Gateway 守护进程。

  1. 01

    痛点:文档分散,新手不知道先装依赖还是先配 API Key。

  2. 02

    痛点:装完 hermes: command not found,其实是 PATH 未刷新。

  3. 03

    痛点:Telegram 能私聊、群聊没反应——隐私模式与入群顺序踩坑。

  4. 04

    痛点:笔记本合盖 Gateway 断线,Skill 复利被打断。

  5. 05

    痛点:无头 VPS 缺 macOS 浏览器自动化路径(Camoufox 等)。

  6. 06

    本文交付:从 curl 到 hermes gateway start 可验收的六步清单。

02

环境要求:你不需要手动装 Python 和 Node.js

官方 install.sh 会通过 uv 拉 Python 3.11、Node.js 22、ripgrep、ffmpeg,并把仓库 clone 到 ~/.hermes/hermes-agent/。下表是规划容量时的参考(数据整理自 Nous Research 安装文档与社区部署经验,2026-06)。

项目最低要求推荐(7×24 + Gateway)
系统macOS 12+ / Ubuntu 20.04+ / WSL2macOS 14+(Apple Silicon)或 Ubuntu 24.04 LTS
内存4 GB(仅 Gateway + 云端 API)16 GB;本地推理建议 32 GB
磁盘约 1.5 GB(含 Skills 缓存)20 GB SSD+
网络可访问 GitHub raw 与 LLM API稳定低延迟出口(Telegram 体验更明显)

「装 Hermes 最难的一步,往往不是命令本身,而是选一台不会合盖、不会半夜掉线的机器。」

03

六步落地:从一键安装到 Telegram Gateway 常驻

bash
# macOS / Linux / WSL2 官方一键安装
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 无头服务器可跳过浏览器自动化组件
# curl -fsSL .../install.sh | bash -s -- --skip-browser

source ~/.zshrc   # 或 source ~/.bashrc
  1. 01

    安装并刷新 PATH:看到 ✅ Hermes Agent installed at ~/.hermes 后执行 source ~/.zshrc,新开终端再跑 hermes --version

  2. 02

    健康检查:hermes doctor 自检 Python、Node、ripgrep、ffmpeg、PATH 与 API Key 等约 12 项;报错按提示补齐。

  3. 03

    配置 LLM:新手跑 hermes setup;或 hermes model 选 OpenRouter / Anthropic / OpenAI / Ollama 等,Key 写入 ~/.hermes/.env(例:hermes config set OPENROUTER_API_KEY sk-or-xxxx)。

  4. 04

    首次对话:执行 hermes 进入 CLI,试任务如「总结今日 AI 新闻」或「统计当前目录文件数」,确认工具链正常。

  5. 05

    Telegram Bot:在 @BotFather /newbot 拿 Token;用 @userinfobot 查你的数字 ID;hermes gateway setup 选 Telegram 粘贴,或写入 TELEGRAM_BOT_TOKENTELEGRAM_ALLOWED_USERS

  6. 06

    7×24 守护:测试 hermes gateway 后执行 hermes gateway install && hermes gateway start;macOS 用 launchd,Linux 可用 sudo hermes gateway install --system + systemd。

群聊必读:Telegram 隐私模式

默认 Bot 在群里只响应 / 命令。若要在群聊 @ 机器人工作,需在 BotFather 关闭 Group Privacy,并把 Bot 踢出群后重新邀请——这是生产环境最高频的「装好了但不说话」原因。

warning

常见报错:API key not set → 重新 hermes modelModuleNotFoundError: dotenv → 确认用的是 ~/.hermes/hermes-agent/venv/bin/hermes 而非系统 Python;升级后配置漂移 → hermes config check && hermes config migrate

04

部署平台怎么选?MacBook、树莓派、VPS 与 Mac Mini 月租

Hermes 的 Skill 复利依赖主机长期在线。下表用于快速拍板(可用性为运维体感量级,非 SLA 承诺):

平台7×24 可用性Skill 复利适合场景
个人 MacBook合盖即断(约 60%)频繁中断仅 POC
树莓派 4B 8GB约 88%I/O 瓶颈、长任务易超时玩票
x86 VPS 4GB约 99.5%稳定但缺 macOS 工具链纯 Linux 用户
Mac Mini M4 月租机房托管 30 天在线UMA + launchd 原生守护要 Telegram 7×24 + macOS Skill 路径
info

提示:M4 统一内存让 Gateway、浏览器自动化与 SQLite WAL 共享高带宽内存池;社区监控 Gateway 常驻约 4 GB 量级仍有余量(16 GB 机型)。远程租机后 SSH 登录执行安装命令,与本地操作一致。

05

可引用参数与结论:装完 Hermes 后主机怎么选?

  • 安装路径:默认 ~/.hermes/hermes-agent/,全局命令 hermes 由安装脚本写入 PATH。
  • 稳定版本:v0.14.x 为当前常用稳定线(2026-06 文档口径);升级用 hermes update
  • 渠道规模:Gateway 支持 Telegram、Discord、Slack、WhatsApp 等 20+ 平台;生产建议独立独占主机。
  • Skill 存储:自动写入 ~/.hermes/skills/;主机掉线则复利中断——与「必须 7×24」直接相关。

若你只是周末试玩,笔记本 + 云端 API 足够;一旦要把 Hermes 当成「每天会接单的同事」,合盖休眠、VPS 上的 macOS 断层和群聊隐私模式坑会一起放大。自购 Mac Mini 可行,但先月租验证 30 天工作流再决定是否买断,决策成本最低——具体机型见 租赁价格说明

家用 Wi-Fi 断网、邻居 VPS 超售、树莓派磁盘 IO 吃紧,都会让 Gateway 在关键时刻掉线——而 Telegram 用户只会觉得「Bot 又死了」。对需要稳定 7×24 跑 Hermes、并保留 macOS 原生安装与 launchd 守护的生产环境,NodeMini 的 Mac Mini M4 云端租赁通常比「将就的笔记本 + 手动重启」更省心:你专注 Agent 复利,而不是半夜修 hermes gateway status

FAQ

常见问题

不需要。官方脚本会通过 uv 安装 Python 3.11 与 Node.js 22。装完后务必 source ~/.zshrc 并运行 hermes doctor 验收。

NodeMini 提供独占 Mac Mini M4 按月/按季租赁,实时价格见 租赁价格说明。Hermes 使用的 LLM API(OpenRouter 等)仍由你自行向提供商付费。

可用 PowerShell 安装脚本(早期 Beta),但 Dashboard 终端面板建议 WSL2 + Linux 安装路径。更多接入与 SSH 问题见 帮助中心