如何在 Mac 上安装 Hermes Agent

在 macOS 12（Monterey）及以上运行 Hermes Agent 有两种方式：官方终端安装，或一键安装器。下面如实讲解两种方式，包括 Mac 特有的坑。

系统要求

macOS 12 及以上（Apple Silicon 和 Intel 都支持），约 5 GB 可用空间和网络连接。如果缺少 Xcode 命令行工具，macOS 会提示安装——同意后装完再重新运行。

方法一——官方手动安装（终端）

打开终端（聚焦搜索 →“Terminal”），运行：curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash——Python、Node.js、ripgrep 和 ffmpeg 会在 10–20 分钟内自动安装。之后英文设置向导会询问 AI 提供商；免费的 Nous Portal 无需 API 密钥。

Mac 特有问题与解决

Gatekeeper 警告（“无法验证的开发者”）：不要双击，右键点击文件选“打开”。“hermes: command not found”：打开新的终端窗口，或运行 export PATH="$HOME/.local/bin:$PATH"。弹出 Xcode 工具安装：同意并等待完成后再次运行安装器。

方法二——一键安装（无需终端）

Hermes Easy Installer 把一切装进一个可双击的文件：6 种语言的向导检查您的 Mac、静默执行官方安装、配置免费 Nous Portal 登录、装好 5 个即用型商务助手，并在桌面放置启动器。约 10 分钟，零命令。

安装之后

通过桌面启动器或 hermes --tui 启动 Hermes。常用命令：hermes doctor（诊断）、hermes model（更换提供商）、hermes gateway setup（连接 Telegram/WhatsApp）。