2026 Hermes Agent 保姆级安装教程：
macOS 一键部署、Telegram 接入与 7×24 Gateway 常驻

2026 年 Nous Research 开源的 Hermes Agent 把「能聊天的模型」升级成住在你机器上的长期进程：跨会话记忆、自动沉淀 Skill、通过 Telegram 等二十余个网关随时下达任务。很多读者卡在第一步：依赖装不齐、模型 Key 配错、Telegram Bot 建了却收不到消息。

本文面向想在 macOS / Linux / WSL2 上从零跑通 Hermes 的开发者与小团队：先拆解安装痛点与宿主对照，再给官方一键脚本 → hermes doctor → hermes setup → 首次对话 → Telegram Gateway → launchd 常驻 的六步清单。读完应能独立完成安装验收，并判断该把 ~/.hermes/ 放在本机还是7×24 在线的 Mac Mini 上。

01 Hermes Agent 安装前必须知道的痛点：和 OpenClaw 不是同一条路

Hermes 与社区里常见的 OpenClaw 都带 Gateway，但默认心智不同：OpenClaw 更偏「多通道控制面 + 插件生态」；Hermes 强调三层记忆 + Skill 自进化 + MCP，安装脚本会一次性拉起 Python 3.11、Node.js 22、ripgrep、ffmpeg 等运行时，而不是让你自己拼虚拟环境。

  • 依赖链长：若用手动 pip 安装，极易遇到「系统 Python 与 venv 不一致」「缺 dotenv」等报错；官方推荐始终用安装器写入 ~/.hermes/hermes-agent/venv。
  • 合盖即断：在 MacBook 上试玩可以，但 Gateway 与定时任务需要主机睡眠策略配合；生产环境应使用不休眠的专用 Mac。
  • Linux VPS 的隐性成本：x86 VPS 能跑 Gateway + 云端 API，但部分 macOS 专属浏览器自动化路径在 Linux 上不可用或需额外折腾。
  • 消息通道鉴权：Telegram 群聊默认隐私模式会导致 Bot「看不见」普通消息；这不是 Hermes 的 bug，而是 BotFather 策略。
  • 版本漂移：发版后若只拷贝旧配置，可能出现 Missing config after update，需用 hermes config check 与迁移命令对齐 schema。

结论先行：安装本身可以 15 分钟内完成；真正决定体验的是宿主是否 7×24 在线，以及 ~/.hermes/ 是否可备份、可迁移。

行为与命令以 Nous Research 官方文档为准；发版后请再次打开下列链接核对。

Installation | Hermes Agent

NousResearch/hermes-agent on GitHub

02 Hermes Agent 环境要求与部署平台对照：装在哪台机器最省心

官方安装器在 macOS 12+、Ubuntu 20.04+、WSL2、Termux 上均有维护路径；Windows 原生 PowerShell 安装为早期 Beta，生产环境更推荐 WSL2 跑 Linux 脚本。下表用于选型，不是替代官方 Prerequisites。

Hermes Agent 部署宿主对照（2026 实操向）
宿主 7×24 可用性 安装摩擦 Skill / Gateway 复利 典型短板
MacBook 本机 合盖/睡眠易断 低（官方路径最熟） 试用足够，生产偏弱 办公室干扰、系统更新重启
树莓派 4B 8GB 约 88%（社区体感） 中（IO 与 ARM 包） 轻量 Gateway 可行 长任务、浏览器自动化易超时
x86 Linux VPS 约 99.5% 中（无头加 --skip-browser） API 模式稳定 缺 macOS 专属工具链
Mac Mini M4 月租裸金属 机房 SLA，目标 30 天在线 低（SSH 等同本地） launchd + UMA 适合常驻 需选择可信机房与租期

最低资源（官方安装页口径）：仅 Gateway + 云端 API 时 4 GB RAM 可起步；若本地跑模型或开浏览器自动化，建议 16 GB 统一内存 档位。磁盘预留 1.5 GB（含 Skills 缓存），生产建议 20 GB SSD 余量。

03 Hermes Agent 一键安装与健康检查：macOS / Linux 通用命令

在目标主机终端执行（与官方 README 一致；发版后请核对仓库 main 分支脚本路径）：

install.sh 
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
# 无头服务器可跳过浏览器栈：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --skip-browser
source ~/.zshrc
hermes doctor
hermes --version

安装器典型动作包括：安装 uv、拉取 Python 3.11、安装 Node.js 22、安装 ripgrep 与 ffmpeg、将仓库克隆到 ~/.hermes/hermes-agent/，并把 hermes 写入 PATH。成功时终端会出现类似 installed at ~/.hermes 的提示。

hermes doctor 会自检 Python、Node、ripgrep、ffmpeg、PATH 与 API Key 等项；任一项失败应先修复再继续 hermes setup，避免把问题带到 Gateway。

Telegram 通道配置说明见官方 Messaging 文档。

Telegram | Hermes Agent User Guide

04 六步落地：模型配置、首次对话、Telegram 与 Gateway 7×24 常驻

  1. 配置 LLM（装大脑）：运行 hermes setup 全向导，或 hermes model 单独切换提供商。OpenRouter / Anthropic / OpenAI / Ollama 等均支持；Key 写入 ~/.hermes/.env，也可用 hermes config set OPENROUTER_API_KEY sk-or-xxxx。
  2. 首次 CLI 对话：执行 hermes，用一句可验证任务测试（例如「列出当前目录文件数」），确认工具调用与日志无报错。
  3. 创建 Telegram Bot：在 Telegram 搜索 @BotFather，发送 /newbot，记录 Token；向 @userinfobot 获取你的数字 User ID。
  4. 绑定 Gateway：运行 hermes gateway setup 选 Telegram 并粘贴 Token 与允许用户 ID；或手动写入 TELEGRAM_BOT_TOKEN 与 TELEGRAM_ALLOWED_USERS。
  5. 前台冒烟：hermes gateway 前台运行，在手机给 Bot 发消息，确认 Hermes 能回复；群聊需按官方文档关闭 Bot 隐私模式并重新拉 Bot 入群。
  6. 后台常驻：macOS 执行 hermes gateway install 与 hermes gateway start（launchd）；Linux 可用 sudo hermes gateway install --system 配合 systemd。远程 Mac 月租节点上完成同样步骤即可 7×24 触达。
gateway.env 
hermes setup
hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status

若计划在 CALMVPS 裸金属 Mac 上部署：先在 定价页 选定 M4 内存与区域，SSH 登录后执行与本地相同的安装命令；退租前打包备份整个 ~/.hermes/ 目录。

05 可引用参数、常见报错与 CALMVPS 场景收束

  • 安装器组件：uv + Python 3.11 + Node.js 22 + ripgrep + ffmpeg（来源：官方 Installation 文档；版本号随发版变化，请以 hermes --version 为准）。
  • 配置落盘：核心目录 ~/.hermes/（.env、skills、memories、Gateway 状态）；迁移宿主务必目录级备份，而非只拷贝聊天记录。
  • 功耗参考（M4 宿主）：社区与机房实测中，空闲约 4–6 W、Agent 典型负载约 15–25 W；适合长期 Gateway 常驻（具体以机房电表与 Apple 规格为准）。
Hermes Agent 常见安装与 Gateway 报错
现象 常见原因 处理
hermes: command not found PATH 未刷新 source ~/.zshrc 或新开终端
API key not set 未配置 LLM hermes model 或编辑 ~/.hermes/.env
群聊无响应 Bot 隐私模式 BotFather 关闭 Group Privacy 后重拉 Bot
Missing config after update 配置 schema 变更 hermes config check 与 migrate

把 Hermes 装在经常合盖的笔记本上，短板是 Gateway 连续性与 Skill 复利节奏；装在廉价跨境 VPS上，短板是 macOS 工具链缺失与跨境延迟；装在树莓派上，短板是 IO 与长任务超时。对需要保姆级安装路径最熟、Telegram 7×24 触达、launchd 原生守护、且可快速升配内存的生产环境，CALMVPS 裸金属 Mac Mini M4 月租 通常是更优解：SSH 交付即用，独占 Apple Silicon，按月弹性下单。机型与租期见 CALMVPS 定价页。