macOS / Linux 一键部署 · hermes doctor · LLM 配置 · Gateway 7×24 · 远程 Mac 验收
谁会遇到这个问题？你已在 GitHub 上看到 Nous Research 的 Hermes Agent（截至 2026 年 6 月约 17 万 Star），想从零装通 CLI、接上 LLM、再用 Telegram 随时唤醒——却在 PATH、API Key 或 Gateway 隐私模式上卡住。结论：按官方 curl | bash 装好后，用 hermes doctor 验收，再配 Gateway 后台服务即可 7×24 常驻；生产环境建议租用 Mac Mini M4避免合盖断线。本文结构：环境要求 → 一键安装 → 验证与 LLM → Telegram → Skill 机制 → 报错表 → 平台选型 → FAQ。
Hermes Agent 是 Nous Research 在 MIT 协议下开源的「自进化 AI Agent」：完成任务后会把成功路径封装为可复用 Skill，下次同类任务 token 消耗可下降约 38%（社区 30 天实测：Skill 数 3→19）。它通过 Gateway 接入 Telegram、Discord、Slack、WhatsApp 等 20+ 平台，并支持 MCP Server 扩展。
与站内常写的 OpenClaw 相比：OpenClaw 在中文 IM 与企业集成案例更多；Hermes 强调 Nous 模型生态、三层记忆（SESSION → MEMORY.md → USER.md）与 Skill 自动沉淀。CrewAI / LangGraph 更偏编排框架，Hermes 则是「装完即用」的常驻 Agent 产品。若你已读过「为何需要 7×24 Mac」选型文，本文专注怎么装、怎么配、怎么跑通。
2026 年 6 月前后，社区讨论集中在三件事：安装脚本是否覆盖依赖、Gateway 能否 systemd/launchd 守护、以及Telegram 群隐私模式导致「Bot 在线但不回消息」。本文按真实工单顺序组织，避免只贴官方 README 却跳过验收步骤。官方文档入口：hermes-agent.nousresearch.com/docs/getting-started/installation；GitHub 仓库 NousResearch/hermes-agent 可作为版本核对来源。
安装门槛被低估：以为要自装 Python 3.11、Node 22、ripgrep——官方脚本已打包。
大脑未配置：没跑 hermes setup 或写入 ~/.hermes/.env，CLI 能进但推理失败。
Gateway 只前台跑：终端关掉 Telegram 就失联，未 gateway install 成 launchd/systemd 服务。
群聊隐私模式：Bot 在群里只响应 / 命令，需在 BotFather 关闭 Group Privacy 并重新入群。
官方安装脚本会检测系统并自动补齐依赖；下表帮你判断「这台机器够不够跑」以及是否要走云端 API 而非本地模型。
| 项目 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | 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（仅 Gateway + 云端 API） | 16 GB（本地 Ollama / 浏览器自动化） |
| 磁盘 | 约 1.5 GB（含 Skills 缓存） | 20 GB SSD+（本地模型权重） |
| 网络 | 可访问 GitHub raw + LLM API | 稳定低延迟出口（Telegram 长连接） |
可引用结论：① 不必手动装 Python/Node/ripgrep/ffmpeg。② 无头 Linux VPS 安装时加 --skip-browser 跳过浏览器自动化组件。③ Windows 原生支持仍属 Beta，优先 WSL2 + Linux 安装脚本。
若你计划把 Hermes 当作「第二台开发机上的常驻同事」，建议在规划阶段就预留独立磁盘分区或至少 20GB 可用空间：Skills 缓存、SQLite 会话库、浏览器自动化 profile 会随使用时间增长。网络侧需保证能稳定访问 GitHub raw（安装脚本）与所选 LLM API 端点；公司代理环境要在安装前配置 HTTPS_PROXY，否则 curl | bash 可能在拉取依赖时超时，表现为脚本半途退出且无明确 hermes 命令。安装成功后务必把 hermes doctor 输出保存一份，便于日后升级对比。
在终端执行官方安装命令（以 NousResearch/hermes-agent 仓库 main 分支脚本为准）：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
脚本会自动完成：安装 uv → Python 3.11 → Node.js 22 → ripgrep、ffmpeg → Clone 到 ~/.hermes/hermes-agent/ → 配置全局 hermes 命令 → 拉取默认 Skills 注册表。成功标志为终端输出 ✅ Hermes Agent installed at ~/.hermes。
执行 source ~/.zshrc（macOS）或 source ~/.bashrc（Linux）刷新 PATH。
无 GUI 的服务器：curl ... | bash -s -- --skip-browser。
运行 hermes doctor，确认 12 项健康检查通过。
运行 hermes setup 配置 LLM（见第四节）。
在租用远程 Mac上首次安装时，用 VNC 处理可能出现的系统权限弹窗（屏幕录制/辅助功能），纯 SSH 可能无法点击「允许」。
Windows PowerShell：iex (irm .../install.ps1)，仓库落在 %LOCALAPPDATA%\hermes\；Dashboard /chat 终端面板建议 WSL2。Termux 执行同一条 curl | bash，脚本会检测环境切换流程。
若你已在 VNCMac 开通节点，建议流程为：VNC 登录 → 打开「终端」→ 执行安装脚本 → hermes doctor 截图留档 → hermes setup 配 API → 再切 SSH 日常运维。原因很实际：macOS 首次允许「终端」访问文件、磁盘或自动化时，图形会话里点一次「允许」比 SSH 盲猜 TCC 失败省数小时。安装目录 ~/.hermes/ 包含 Skill、SQLite 会话库与 .env，退租前用 tar czf hermes-backup.tgz ~/.hermes 打包即可迁移到下一台机器。
hermes doctor hermes --version hermes setup # 全向导，推荐新手 # 或单独：hermes model
| 提供商 | 特点 | 配置方式 |
|---|---|---|
| Nous Portal | 零配置订阅，300+ 模型 | hermes setup --portal OAuth |
| OpenRouter | 多模型实验 | API Key → ~/.hermes/.env |
| Anthropic / OpenAI | Claude / GPT 系列 | API Key 或 OAuth |
| Ollama / vLLM | 本地推理 | Base URL + Key；需 16GB+ 内存 |
写入 Key 示例：hermes config set OPENROUTER_API_KEY sk-or-xxxx 或 echo 'OPENROUTER_API_KEY=...' >> ~/.hermes/.env。配置完成后执行 hermes 进入交互 CLI，试一句「帮我总结今天 AI 新闻」验证推理链路。走 GitHub Copilot 可在 hermes model 选 OAuth；本地 Ollama 需先 ollama serve 再填 http://127.0.0.1:11434，16GB 内存建议 7B–8B 模型，避免 Gateway 与推理抢内存触发 watchdog。
在 Telegram 找 @BotFather，/newbot 创建 Bot，保存 Token。
向 @userinfobot 发消息获取你的数字 User ID。
运行 hermes gateway setup，选 Telegram，粘贴 Token 与 ID；或手动写入 TELEGRAM_BOT_TOKEN、TELEGRAM_ALLOWED_USERS。
测试：hermes gateway 前台运行，手机给 Bot 发消息。
生产：hermes gateway install && hermes gateway start；macOS 用 launchd，Linux 可用 sudo hermes gateway install --system。
群聊必读：默认 Bot 有隐私模式，群内只响应 / 命令。需在 BotFather → Group Privacy → Turn off，并将 Bot 踢出群后重新邀请才生效。
验收清单（约 15 分钟）：① 私聊 Bot 收到回复；② hermes gateway status 显示 running；③ 重启节点后服务自动拉起（验证 launchd/systemd）；④ 日志无连续 401 / 429（API 额度或 Key 错误）。Linux 生产机可用 journalctl -u hermes-gateway -f 跟踪；macOS 租用节点可在 VNC 中打开「控制台」筛选 hermes 相关条目。
| 命令 | 用途 |
|---|---|
| hermes | 交互对话 |
| hermes tools | 管理启用工具 |
| hermes gateway status | 查看 Gateway 服务状态 |
| hermes update | 更新到最新版 |
| hermes config check | 配置完整性检查 |
Skill 机制：任务成功后 Hermes 将流程写入 ~/.hermes/skills/，下次优先命中。前提是主机 7×24 在线——笔记本合盖、VPS 休眠都会打断复利。MCP 可在 ~/.hermes/config.yaml 声明 mcp_servers（如 GitHub Server），headless 环境用 hermes mcp login + SSH 隧道完成 OAuth。
若你计划接 GitHub MCP，请为 Token 单独建只读或最小权限 PAT，不要把生产仓库的 admin 权限交给实验 Agent。浏览器自动化类 MCP（如 Camoufox）在 macOS 上路径最完整；纯 Linux VPS 可能缺少部分依赖，这与 Hermes 官方在 Apple Silicon 上测试最充分的现状一致——也是许多团队最终把 Gateway 迁到 Mac Mini 的原因之一。
| 报错 / 现象 | 原因 | 处理 |
|---|---|---|
| hermes: command not found | PATH 未刷新 | source ~/.zshrc 或新终端 |
| API key not set | 未配置 LLM | hermes model / 编辑 .env |
| Missing config after update | 版本升级偏移 | hermes config migrate |
| ModuleNotFoundError: dotenv | 用了系统 Python | 确认使用 ~/.hermes/.../venv/bin/hermes |
| Telegram 群无响应 | 隐私模式 | BotFather 关隐私 + 重新入群 |
| 平台 | 7×24 可用性 | Skill 复利 | 适合人群 |
|---|---|---|---|
| 个人 MacBook | ≈60%（合盖断） | 易中断 | 仅 POC |
| x86 VPS 4GB | ≈99.5% | 稳定，无 macOS 专属 Skill | 纯 Linux 用户 |
| Mac Mini M4 月租 | 机房 SLA | launchd 守护 + UMA | 要 Telegram 常驻的生产用户 |
自购 Mac Mini M4 16GB 约 ¥4,499 起，摊到 24 个月约 ¥180–220/月，但需自担电费、宽带与机房级断电风险。VNCMac 月租把 CapEx 转为 OpEx：不确定 Hermes 能否每天替你省 2 小时时，先租 30 天跑通 Gateway + Skill 复利，再决定是否买断。M4 统一内存在 Gateway 常驻约 4.2 GB、浏览器自动化与 SQLite WAL 同址寻址时，比 4GB x86 VPS 更不易 swap 抖动——这对 Telegram 长连接与定时 Heartbeat 很关键。
不需要。官方 install.sh 通过 uv 安装 Python 3.11、Node 22 及 ripgrep、ffmpeg。
安装与 Gateway 配置多数步骤可 SSH；首次 macOS 隐私授权、部分 OAuth 浏览器回调建议开 VNC，与站内 OpenClaw 远程 Mac 经验一致。
入口仍为官方 install 脚本；升级用 hermes update，若配置迁移报错执行 hermes config check && hermes config migrate。
主题 100讲「为何 7×24 + 记忆架构 + 租用 TCO」；本文讲「安装配置实操」。先装通再选型更顺。
Hermes Agent 的安装本身并不神秘：一条官方脚本、一次 hermes doctor、一套 .env、一个常驻 Gateway。真正拉开差距的是主机能否 7×24 在线——Skill 复利、Telegram 随时可达、跨会话记忆写入，都依赖进程与磁盘持续可用。
笔记本合盖、家用 Wi‑Fi 抖动、或 $5 VPS 在高峰被限速，都会让「越用越聪明」退化成「每次重装的新同事」。自购 Mac Mini M4 适合已验证全年常驻的用户；仍在评估阶段时，按月租用物理 M4 节点用 SSH 装 Hermes、用 VNC 过权限验收，退租前备份 ~/.hermes/ 即可迁移——比先花 ¥4,499 买断更省决策成本。
装通 Hermes 只是第一步，让它一直跑着才是价值所在。下方进入Mac Mini M4 月租套餐，为 Gateway 与 Skill 准备一台永不停歇的 macOS 主机。