MacBook 安装 Hermes Agent 完整指南

一、准备工作

系统要求：

• macOS 12（Monterey）及以上
• 留出至少 2GB 磁盘空间
• 网络畅通（能访问 GitHub）

打开终端：Cmd + 空格 搜"终端"打开

二、安装方式（二选一）

方式 A：Hermes Desktop 安装（推荐，带图形界面）

1. 打开浏览器访问 https://hermes-agent.nousresearch.com/
2. 点击 Download，下载 macOS 版 .dmg 文件
3. 打开 .dmg，把 Hermes 拖进 Applications 文件夹

4. 首次打开可能被 Gatekeeper 拦截：

5. 去 系统设置 → 隐私与安全性 → 仍要打开

6. 或者右键 Hermes.app → 打开
7. 启动后自带 CLI + GUI，一步到位

方式 B：命令行安装（轻量，适合开发者）

在终端里直接运行：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

安装器会自动装好 Python、Node.js、ripgrep、ffmpeg 等依赖，全程自动化。

装完验证：

hermes --version

应该显示类似 Hermes Agent v0.17.0 (2026.6.19) 的版本信息。

三、首次配置

快速配置（推荐）

hermes setup --portal

这个命令会：

1. 在浏览器打开 Nous Portal 登录页面
2. 用 Google / GitHub 账号 OAuth 登录
3. 一次搞定模型提供商和四个工具：Web 搜索、TTS、浏览器、图片生成
4. 全程不用手动填 API Key

手动配置（如果你有自己的 API Key）

hermes setup

交互式向导，选择 Provider（OpenRouter / Anthropic / OpenAI / DeepSeek / Google Gemini 等）和 Model，然后配置 .env 文件里的 API Key。

或者直接用：

hermes model

可视化选择 model 和 provider。

验证配置

hermes doctor

检查所有依赖和配置是否正常。

四、启动使用

# 直接进入交互式对话
hermes

# 单次提问
hermes chat -q "Hello, who are you?"

# 使用 TUI 界面（更帅）
hermes --tui

五、沙箱说明

macOS 的沙箱机制在两方面影响 Hermes：

如果装了 Hermes Desktop（.app）

macOS App Sandbox 会限制文件访问。解决方案：

• 去 系统设置 → 隐私与安全性 → 文件与文件夹 给 Hermes 加权限
• 或者在 Desktop 里用内置终端执行命令（不走沙箱）

如果装的是命令行版本

命令行版本没有 App Sandbox 限制，跑在终端里使用用户完整权限。

如果需要跑在沙箱里

可以用 macOS 的 sandbox-exec 创建一个受限环境：

# 创建沙箱策略文件
cat > ~/hermes.sb << 'EOF'
(version 1)
(deny default)
(allow network*)
(allow file-read* (subpath "/Users/你的用户名"))
(allow file-write* (subpath "/Users/你的用户名/.hermes"))
(allow process*)
(allow sysctl*)
EOF

# 在沙箱里启动 Hermes
sandbox-exec -f ~/hermes.sb hermes

日常使用不需要开沙箱，Hermes 自带的 Tirith 安全扫描器和高危命令审批机制更实用。

六、常见问题

本文由 admin 原创，转载请注明出处。