安装指南

2026 年 Hermes Agent Mac 版
最新安装清单：周末动手前最该准备什么？

nuzcloud 编辑部 2026-05-23 8 分钟

导读摘要

2026 年第一次在 M 系列 Mac 上装 Hermes Agent，最怕装到一半才发现运行时不对、API key 没备好、权限弹窗没处理，或终端一关服务就停。「安装成功」与「长期稳定运行」是两件事。本文按官方文档整理五段式清单，从第一条 curl 之前到 launchd 常驻与 24 小时观察，帮你把周末安装变成可验证、可恢复、可持续的流程。（核对至 2026-05-23）

只想快速体验，可按官方 Quickstart 走。若希望 Hermes 在 Mac 上长期可用，请先把下面清单勾完再执行安装命令。

一Before you install：硬件、系统与备份

检查项	建议	验证
芯片 / 系统	Apple Silicon 或 Intel Mac；macOS 能跑 Xcode CLT	`uname -m`、`sw_vers`
内存 / 磁盘	建议 ≥16GB RAM；预留 ≥5GB（含 Skills 缓存）	活动监视器 / `df -h ~`
网络	可访问 GitHub raw 与所选 LLM API	`curl -I https://github.com`
账号权限	本机管理员（安装 PATH、Full Disk Access 等）	系统设置 → 用户与群组
备份	Time Machine 或导出 `~/.hermes` 快照	恢复演练一次

二Prepare dependencies：官方只要求 Git

按 Installation，一行安装器会自动处理 uv、Python 3.11、Node.js v22、ripgrep、ffmpeg，无需提前装 Homebrew 版 Python/Node。你只需确认 Git 可用：

→Git：git --version 有输出即可；避免装到一半才装 CLT。
→Shell：默认 zsh；安装后需 source ~/.zshrc 刷新 PATH。
→可选 Nix：用 Nix 的用户走 Nix 文档，与 curl 安装二选一。

三Prepare accounts and secrets

安装结束前会配置 LLM；提前准备可减少中断：

→OpenRouter / Anthropic / OpenAI 等至少一个 provider 的 API key。
→密钥写入 ~/.hermes/.env，执行 chmod 600 ~/.hermes/.env。
→勿把密钥放进项目 Git；Gateway 白名单用 TELEGRAM_ALLOWED_USERS 等，避免 GATEWAY_ALLOW_ALL_USERS=true。

⚠️安全默认：危险命令需人工批准（approvals.mode: manual）。生产环境勿开 YOLO；终端后端优先考虑 docker 隔离。

四Create a safe workspace

官方 per-user 布局：代码在 ~/.hermes/hermes-agent/，数据在 ~/.hermes/（config、logs、pairing、sandboxes）。

→用专用子目录作 agent 工作区，勿直接授权整个用户主目录。
→日志：~/.hermes/logs/（Gateway 用 gateway.log）。
→自定义路径：HERMES_INSTALL_DIR=... 再跑安装脚本（见官方文档）。

五Install & First run

Install（最小可用）：

                    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
                

然后 source ~/.zshrc → hermes 或 hermes setup → hermes model。

First run 验证：

✓which hermes → ~/.local/bin/hermes
✓hermes doctor 无阻塞项（缺 API key 会提示跑 hermes model）
✓发一条真实对话，确认模型回复与工具调用
✓若启用文件/终端工具，在系统设置中按需授予「完全磁盘访问」等权限

六Keep it running：launchd 常驻

CLI 里跑 hermes 只等于当前会话；Messaging Gateway 需守护进程：

1CLI 稳定后：hermes gateway setup（Telegram / Discord / Slack 等按当前支持列表配置）
2hermes gateway install → plist：~/Library/LaunchAgents/ai.hermes.gateway.plist
3hermes gateway start → hermes gateway status
4日志：tail -f ~/.hermes/logs/gateway.log
5之后新装 Homebrew/nvm 工具，需再跑 hermes gateway install 刷新 PATH

💡集成边界：Telegram、Discord、BlueBubbles（iMessage）等是否可用以官方 Messaging 文档为准；iMessage 需另有一台常开 Mac 跑 BlueBubbles Server，本文不承诺一键可用。

七Recovery：装失败先查什么

现象	优先排查
`hermes: command not found`	Shell PATH → `source ~/.zshrc`
API 调用失败	`hermes model` / `hermes config check`
Gateway 起不来	`hermes gateway status`、日志、平台 token 与 allowlist
重启后服务消失	是否只跑了前台 `hermes gateway`，未 `gateway install`
WhatsApp 报 node/ffmpeg 找不到	重跑 `hermes gateway install` 更新 plist PATH
更新后配置异常	`hermes config migrate`、`hermes update`

八24 小时观察清单

①重启 Mac → hermes gateway status 仍为 running
②断网 5 分钟再恢复，看 Gateway 是否自恢复或需手动 start
③抽查 ~/.hermes/logs/ 是否有异常堆栈
④核对 LLM 账单，避免工具循环导致费用飙升
⑤故意触发一次危险命令，确认批准流程仍生效

九在 Mac mini 上，Agent 更适合 7×24 常驻

Hermes 的 Gateway、BlueBubbles 桥接和本地工具链都依赖稳定的 macOS 环境。Mac mini M4 凭借 Apple Silicon 统一内存与约 4W 级待机功耗，适合作为家庭或小团队的静默 Agent 节点：原生 Unix、Homebrew、Docker 与 launchd 无需 WSL；Gatekeeper 与 FileVault 降低长期暴露面的风险；崩溃率低于多数同价位 Windows 主机，更适合无人值守跑 Gateway。

若你计划把本文清单落实为「周末装完、下周一直在线」的 Agent 主机，Mac mini M4 是目前性价比很高的起点——现在即可入手，让 Hermes 跑在真正为长期运行设计的硬件上。

五段式速查

①Before install：硬件、网络、备份
②Install：一行脚本 + hermes doctor
③First run：model、对话、权限
④Keep running：gateway install + launchd
⑤Recovery：PATH → API → Gateway → 日志

nuzcloud · Mac 云服务器

用 Mac mini 跑常驻 Hermes Agent

专属 Mac mini M4 裸机，秒级开通 · 适合 Gateway 7×24、本地 Agent 与远程开发。让安装清单真正长期在线。

立即开通 →

2026 年 Hermes Agent Mac 版最新安装清单：周末动手前最该准备什么？