Hermes Agent Mac 安装指南：网关与 OpenClaw 迁移（2026）

Hermes Agent 是 Nous Research 的开源自进化 AI 代理（github.com/NousResearch/hermes-agent，MIT）。它不是一次性聊天界面，而是运行学习闭环：精选记忆、代理自建技能、FTS5 会话检索、定时 cron，以及 Telegram、Discord、Slack、WhatsApp、Signal 等消息网关。本指南在 Mac 上完成安装与网关配置——MacBook 或无外接显示器的 Mac mini 均可，不假设你必须租用云主机。

为何在 Mac 上运行 Hermes

Hermes 标榜「随处可跑」，但 macOS 仍是实用默认环境：

• 原生安装器 — 一行 install.sh 支持 macOS（及 Linux/WSL）。
• Apple Silicon — 通过 uv 使用 Python 3.11、Node 工具链，以及 ffmpeg/ripgrep。
• 网关进程 — hermes gateway 在后台保持，便于用 Telegram 聊天；若 Mac 睡眠，网关会中断，除非迁到常开主机。
• OpenClaw 路径 — 若你已在 Mac 上运行 OpenClaw，可用 hermes claw migrate 从 ~/.openclaw 导入记忆与技能。

可引用定义：Hermes Agent 是带持久记忆、agentskills.io 兼容技能、多平台消息网关，以及六种终端后端（local、Docker、SSH、Singularity、Modal、Daytona）的 MIT 代理框架。

与流程层对比：Obra Superpowers 强化设计/TDD 纪律；Hermes 提供运行时、工具与频道——二者叠加而非互斥。

若网关需拉取较大依赖，注意本机出口带宽；Hermes 本身不绑定任何云厂商。东京或首尔节点仅在你把 SSH 后端放在远端时才有意义。

macOS 上的架构

外部参考：Hermes 文档；若网关与 Docker 后端同机运行，可按 Apple Mac mini 规格 规划内存。

提供商灵活：hermes model 可在 Nous Portal、OpenRouter（200+ 模型）、OpenAI、Anthropic、NVIDIA NIM 与自定义端点间切换，无需改代码。

Mac 八步安装手册

1. 步骤 1 — 前置条件 — macOS 13+；若同时开 Docker 后端与网关，建议 16 GB 内存；xcode-select --install。
2. 步骤 2 — 官方安装 — curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash，然后 source ~/.zshrc。
3. 步骤 3 — 验证 CLI — hermes doctor 与 hermes --version。
4. 步骤 4 — 首次配置 — hermes setup；Nous 捆绑工具可用 hermes setup --portal。
5. 步骤 5 — 模型与工具 — hermes model、hermes tools，仅启用需要的工具集。
6. 步骤 6 — TUI 冒烟测试 — 运行 hermes，在会话中使用 /model、/skills、/usage。
7. 步骤 7 — 可选消息网关 — hermes gateway setup 与 hermes gateway start；移动端可用 /stop 中断。
8. 步骤 8 — 从 OpenClaw 迁移 — hermes claw migrate --dry-run 后执行 hermes claw migrate，导入 SOUL.md、技能与消息配置。

若需 24/7 网关 且笔记本会睡眠：在备用 Mac mini 上关闭睡眠，或通过 SSH 终端后端 在远端 Mac 执行命令（见下一节）。

终端后端：本机 Mac 与 SSH

通过 hermes tools 与配置文件设置，详见 工具文档。

故障排除

hermes: command not found

现象：Shell 找不到 ~/.local/bin/hermes。

修复：将 export PATH="$HOME/.local/bin:$PATH" 写入 ~/.zshrc 并 source ~/.zshrc；若二进制缺失，重新运行 install.sh。

hermes doctor 报 Python/uv 错误

现象：Python 版本错误或 venv 损坏。

修复：安装 uv：curl -LsSf https://astral.sh/uv/install.sh | sh，然后 hermes update 与 hermes doctor。

网关已连接但代理无回复

现象：Telegram 消息被忽略。

修复：检查 hermes gateway 日志、bot token 与 DM 配对白名单；hermes gateway stop 后 hermes gateway start。

在 Apple Silicon 上启用 docker 后端时，请保持 Docker Desktop 为最新版，避免首次工具调用因虚拟机镜像过旧而变慢。若团队已使用 cron，请在与网关相同的机器上调度 Hermes 任务，使配对令牌与允许列表留在同一 ~/.hermes/ 目录。

对比各提供商费用前，先在 TUI 中用 /usage 记录 token；再逐步开启浏览器或图像工具，可避免 Telegram 每条消息都拉取超大上下文。

国内用户若网关需频繁 npm 拉包，请确保出口带宽稳定；这与 Hermes 本身无关，但会显著影响首次 hermes gateway setup 耗时。将 SSH 后端指向东京或首尔区域的常开 Mac，可在笔记本睡眠时仍保持 Telegram 响应，且无需把 API 密钥分散到多台机器。

生产环境建议为 hermes gateway 单独创建 macOS 用户，并关闭 iCloud 同步桌面目录，避免 FTS5 索引与私人文件混放。完成八步安装后，用一条 Telegram 测试消息验证工具流式输出，再逐步开放 Discord 或 Slack 频道，可降低多平台同时排障的复杂度。

FAQ

延伸阅读

• 8B 本地模型调参：止住 Agent 死循环
• Hermes 轨迹压缩：AI 账单 $500→$50
• Hermes Agent 定时任务：Discord 自动日报
• Hermes Agent MCP 开发工具链配置
• Obra Superpowers 安装指南
• OpenClaw Mac mini 安装