hermes doctor 验收环境；③ hermes setup 接 LLM；④ hermes gateway install 实现 7×24。结构含环境矩阵、六步 Runbook、报错表与宿主选型。
2026 为什么要装 Hermes Agent？和 OpenClaw 差在哪
很多人搜「开源 AI Agent 教程」时，会在 Hermes Agent、OpenClaw、LangGraph、CrewAI 之间犹豫。一句话区分：Hermes 偏「住在你机器上的个人值班员」——默认把 USER.md / MEMORY.md / Skill 写在 ~/.hermes，Gateway 负责渠道；OpenClaw 更强调多频道网关与 ClawHub 技能生态；LangGraph / CrewAI 更像编排框架，要自己拼记忆与部署。
自进化 Skill：同类任务再次出现时优先加载 ~/.hermes/skills/，社区实测 30 天内 Skill 从个位数涨到十余个时，同类任务 token 可降约 38%（非质量分，仅供参考）。
模型无关：Anthropic、OpenAI、OpenRouter、GitHub Copilot、Ollama 均可，密钥写在 ~/.hermes/.env。
MCP 扩展：兼容 Model Context Protocol，可挂 GitHub、浏览器自动化等 Server。
Hermes Agent 安装环境要求：macOS、Linux、VPS 怎么选
| 项目 | 最低要求 | 推荐（生产 Gateway） |
|---|---|---|
| 系统 | macOS 12+、Ubuntu 20.04+、WSL2 | macOS 14+（Apple Silicon）或 Ubuntu 24.04 LTS |
| Python / Node | 脚本自动安装 3.11 / Node 18+ | 脚本默认 Node 22，无需 sudo |
| 内存 | 4 GB（仅 API + Gateway） | 16 GB（浏览器自动化 + 本地 7B 回落） |
| 磁盘 | 约 1.5 GB（含 Skills 缓存） | ≥ 20 GB SSD |
| 网络 | 可访问 GitHub raw + LLM API | 稳定低延迟出口 |
| 宿主场景 | 7×24 可用性体感 | 适合阶段 |
|---|---|---|
| 笔记本合盖 | ≈ 60%，Skill 复利易断 | 仅 POC |
| x86 VPS 4GB | ≈ 99.5%，无 macOS 专属 Skill 路径 | 纯 Linux 用户 |
| Mac Mini M4 月租 | 机房 SLA，launchd 原生守护 | Telegram 生产、Camoufox 自动化 |
Hermes Agent 保姆级安装：六步 Runbook（macOS / Linux）
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash source ~/.zshrc
无头服务器可跳过浏览器依赖：bash -s -- --skip-browser。脚本会安装 uv、Python 3.11、Node 22、ripgrep、ffmpeg，并将仓库放到 ~/.hermes/hermes-agent/，全局命令 hermes 写入 PATH。成功标志：✅ Hermes Agent installed at ~/.hermes。
执行安装脚本：上文 curl 命令；Windows 可用 PowerShell 版 install.ps1，但生产仍推荐 WSL2 + Linux 脚本。
刷新 Shell：source ~/.zshrc 或 source ~/.bashrc，解决 hermes: command not found。
健康检查：hermes doctor 自检 Python、Node、ripgrep、ffmpeg、PATH、API Key 等约 12 项；hermes --version 确认 v0.14.x / v0.15 候选。
配置大脑：hermes setup 全向导，或 hermes model 单独选 OpenRouter / Anthropic / Ollama；密钥写入 ~/.hermes/.env，例如 hermes config set OPENROUTER_API_KEY sk-or-xxxx。
CLI 冒烟：运行 hermes，试「总结今日 AI 新闻」或「统计当前目录文件数」，确认工具调用与模型路由正常。
升级与迁移：日常 hermes update；若升级后报配置缺失，执行 hermes config check && hermes config migrate。
Hermes Agent Telegram 接入：BotFather 到 gateway install
装完 CLI 只解决「本机对话」；要在手机上随时派活，需要 Gateway。流程：在 Telegram 找 @BotFather → /newbot → 保存 Token → 用 @userinfobot 查自己的数字 ID。
hermes gateway setup hermes gateway install hermes gateway start hermes gateway status
交互向导会写入 TELEGRAM_BOT_TOKEN 与 TELEGRAM_ALLOWED_USERS。Linux 生产可 sudo hermes gateway install --system 并用 journalctl -u hermes-gateway -f 看日志；macOS 用 launchd 用户服务即可。
| 报错 / 现象 | 原因 | 处理 |
|---|---|---|
hermes: command not found | PATH 未加载 | 重开终端或 source rc 文件 |
API key not set | 未配 LLM | hermes model |
| 群聊不回复 | Bot 隐私模式 | BotFather 关 Group Privacy，踢出再拉入群 |
ModuleNotFoundError: dotenv | 误用系统 Python | 用 ~/.hermes/hermes-agent/venv/bin/hermes |
提示：常用命令还包括 hermes tools、hermes config check；MCP 可在 ~/.hermes/config.yaml 声明 mcp_servers，headless 环境用 hermes mcp login + SSH 隧道完成 OAuth。
安装之后：Skill 复利与 Mac Mini M4 宿主硬数据
Star 规模：截至 2026 年 6 月，hermes-agent 约 174,720 Star，安装与 Telegram 文档迭代以 macOS 路径最完整。
功耗：M4 空闲约 4–6W，Gateway + 自动化典型 15–25W，适合常年开机。
统一内存：16GB UMA 下 Gateway 常驻约 4GB 级，与 Camoufox、SQLite WAL 共享地址空间，较 x86 小 VPS 更少 swap 抖动。
笔记本合盖、树莓派 I/O 瓶颈、纯 Linux VPS 缺 macOS 浏览器 Skill——这些不是「安装失败」，而是宿主选错导致 Gateway SLA 不达标。若你要让 Hermes 在 Telegram 上 7×24 接单并持续写 Skill，MESHLAUNCH 的 Mac Mini M4 云端裸金属月租通常是更优解：SSH 与本地同款 curl 安装、launchd 守护、退租前可打包 ~/.hermes 迁移。先看租赁价格页按日试跑，运维边界见帮助中心。