Mac上 10 分钟快速安装Hermes

Mac 安装 Hermes Agent 详细教程

前置条件

你的 Mac 需要有：

Git（macOS 自带，或通过 Xcode Command Line Tools 安装）
网络连接（安装脚本会自动下载所有依赖）

安装脚本会自动处理所有依赖：Python 3.11、Node.js 22、ripgrep、ffmpeg，无需手动安装。

第一步：一键安装

打开终端（Terminal），运行以下命令：

bash 复制代码

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

⚠️ 注意：不要用 sudo 运行安装命令。Hermes 安装在用户目录 ~/.hermes/ 下，不需要 root 权限。

这是在问你是否要从 OpenClaw（另一个 AI Agent）导入已有的配置数据。
如果你之前用过 OpenClaw：输入 Y 查看可以导入哪些内容（对话历史、配置、技能等），预览后再决定要不要导入，不会立即修改任何东西。
如果你没用过 OpenClaw / 不需要迁移：输入 n 跳过，直接全新配置。

大概率你是第一次用，直接输入：

bash 复制代码

然后回车，继续后面的 LLM 提供商配置。

Quick Setup（推荐）

通过 OAuth 直接登录 Nous Portal 账号，自动完成所有配置。

无需准备任何 API Key
自动分配模型（Nous 托管）
支持 300+ 模型，含 Web 搜索、图像生成、TTS 等工具
适合新手，3 步内完成
需要注册 Nous Portal 账号（免费）

Full Setup

手动逐项配置所有内容，完全自主控制。

配置项	说明
LLM 提供商	OpenAI / Anthropic / Gemini / Ollama 本地模型等
API Key	填入你自己的 key，用自己的额度
工具开关	Web 搜索、代码执行、浏览器、文件系统等逐一控制
消息网关	Telegram / Discord / Slack 机器人
内存与技能	Agent 记忆和自学习行为

适合有现成 API Key 的用户
适合想用本地模型（Ollama）的用户
适合不想注册第三方账号的用户
配置步骤较多，但更灵活

怎么选？

没有 API Key，想快速跑起来 → Quick Setup
有 OpenAI / Anthropic / Claude 的 Key → Full Setup
想完全本地运行不联网 → Full Setup + Ollama

如果选择Quick Setup ，这是 Nous Portal 的订阅套餐选择页面。这是 Quick Setup 的 OAuth 登录流程跳转过来的。

各套餐对比：

套餐	价格	说明
Free	$0/mo	免费模型访问，按量付费使用 300+ 模型
Plus	$20/mo	300+ 模型 + 工具托管 + 高速率限制 + $22 月度积分
Super	$100/mo	同上 + 更高速率限制 + $110 月度积分
Ultra	$200/mo	同上 + 最高速率限制 + $220 月度积分

建议选 Free 先试用，功能已经够用，之后觉得速率不够或想要托管工具再升级。

Free 套餐点击后会要求你注册/登录账号，完成后回到终端继续配置即可。

这是选择 终端执行环境，即 Hermes Agent 在哪里运行命令和代码。

选项	说明
Local	直接在本机运行（默认）
Docker	隔离容器，资源可配置，更安全
Modal	无服务器云沙盒，按需运行
SSH	在远程服务器上运行
Daytona	持久化云开发环境
Keep current	保持当前设置（本机）

直接回车选 Keep current (local) 即可，就是在你的 Mac 本机运行，最简单也最常用。其他选项适合有隔离需求或远程部署场景。

这是问你是否要连接消息平台，让 Hermes 通过 Telegram、Discord 等 App 来接收指令和回复。

选项	说明
Set up messaging now	现在配置，可通过手机 App 随时控制 Agent
Skip	跳过，之后运行 `hermes setup gateway` 再配置

建议先跳过，选第二项回车。消息平台配置相对复杂（需要创建 Bot、填 Token），先把 Agent 跑起来验证可用，之后再按需接入 Telegram/Discord。

第二步：安装位置说明

普通用户安装后：

代码位于：~/.hermes/hermes-agent/
hermes 命令：~/.local/bin/hermes（符号链接）
数据目录：~/.hermes/

第三步：重载 Shell 并启动

安装完成后，运行：

bash 复制代码

source ~/.zshrc    # macOS 默认是 zsh
hermes             # 启动对话！

Hermes Agent 已成功安装并运行！

从界面可以看到：

版本：v0.15.1 (2026.5.29)
模型：claude-opus-4.6（通过 Nous Research）
工具：26 个工具集，包括浏览器、代码执行、定时任务、Discord 等
技能：90 个技能，涵盖 Apple 生态、GitHub、Spotify、Obsidian、研究工具等

现在直接在 ❯ 后面输入你想让它做的事就可以了，比如：

bash 复制代码

帮我写一段 Python 代码

另外有两条提示建议处理：

运行 hermes claw migrate 可以把旧的 OpenClaw 配置迁移过来
运行 /help 查看所有可用命令

如果出现 No inference provider configured. Run 'hermes model' to choose a provider and model, or set an API key ，说明还没配置 LLM 提供商，运行以下命令配置：

bash 复制代码

hermes model

提供商	费用	说明
Nous Portal	免费起	官方推荐，OAuth 登录无需 Key，300+ 模型 + 工具托管，Free 套餐有额度限制
OpenRouter	按量付费	聚合平台，一个 Key 访问几乎所有模型（GPT、Claude、Gemini 等），价格透明
NovitaAI	按量付费	云端模型 API + Agent 沙盒 + GPU 云，适合需要算力的场景
LM Studio	免费	本地桌面应用，下载模型到本地运行，完全离线，无需 Key，需要较好 GPU/内存
Anthropic	按量付费	Claude 系列模型，直接填 `ANTHROPIC_API_KEY`，也支持 Claude Code
OpenAI	按量付费	GPT 系列，支持 Codex CLI 或直接 API，填 `OPENAI_API_KEY`
Qwen / DashScope	按量付费	阿里通义千问，国内访问稳定，支持多提供商聚合
xAI Grok	付费	马斯克的 Grok 模型，支持直接 API 或 SuperGrok/Premium+ OAuth
Xiaomi MiMo	按量付费	小米 MiMo 模型，V2.5/V2，有 pro/omni/flash 多档
Tencent TokenHub	按量付费	腾讯混元 Hy3 Preview，国内访问
NVIDIA NIM	按量付费	NVIDIA Nemotron 模型，支持云端或本地 NIM 部署
GitHub Copilot	订阅制	用 GitHub Token 或 Copilot ACP 进程，需有 Copilot 订阅
Hugging Face	免费/付费	HF 推理 API，访问开源模型，免费额度有限
Google Gemini	按量付费	Gemini 系列，支持 AI Studio API Key 或 OAuth + Code Assist
DeepSeek	按量付费	V3/R1/Coder，价格极低，效果出色，直接 API
Z.AI / GLM	按量付费	智谱 GLM 系列，国内直接 API
Kimi / Moonshot	按量付费	月之暗面 Kimi，支持全球和国内端点，有 Coding Plan
StepFun	按量付费	阶跃星辰，Agent/coding 专用模型
MiniMax	按量付费	MiniMax 模型，支持全球/国内/OAuth Coding Plan
Ollama Cloud	按量付费	云端托管的开源模型，ollama.com
Arcee AI	按量付费	Trinity 系列模型，直接 API
GMI Cloud	按量付费	多模型直接 API
Kilo Code	按量付费	Kilo Gateway API
OpenCode	免费/订阅	Zen 按量或 Go 订阅制
AWS Bedrock	按量付费	AWS 托管的 Claude/Nova/Llama/DeepSeek，IAM 或 API Key
Azure Foundry	按量付费	Azure 上部署的 OpenAI 或 Anthropic 模型，企业常用
Qwen OAuth	免费/付费	复用本地 Qwen CLI 登录，无需额外配置
Alibaba Coding Plan	订阅制	阿里云专属 Coding 套餐
Custom / 自定义	自定	手动填入任意兼容 OpenAI 格式的 API 端点 URL

按场景推荐：

零成本快速上手 → Nous Portal 或 LM Studio
国内用户性价比最高 → DeepSeek
有 Claude Key → Anthropic
企业/团队部署 → AWS Bedrock 或 Azure Foundry
完全离线本地 → LM Studio

这里我选择使用Nous Portal认证后的免费模型

这是说你Nous Portal 免费套餐不支持付费模型，目前只有一个免费模型可用：

stepfun/step-3.7-flash:free --- 阶跃星辰的免费模型，够日常使用

建议先选第一个 stepfun/step-3.7-flash:free 回车，把 Agent 跑起来验证可用，之后再考虑升级或换 Key。

执行命令： 帮我查询一下深圳市当日天气

如果出现 Dangerous Command ：

bash 复制代码

│ ⚠️  Dangerous Command                                            │
│                                                                  │
│ curl -s "wttr.in/Shenzhen?format=3&lang=zh"                      │
│                                                                  │
│ ❯ 1. Allow once                                                  │
│   2. Allow for this session                                      │
│   3. Deny                                                        │
│                                                                  │
│ Security scan --- [MEDIUM] Schemeless URL in sink context: URL     │
│ without explicit scheme passed to a command that                 │
│ downloads/executes content                                       │

Hermes Agent 正在运行，它想执行一条 curl 命令来查询天气，系统检测到安全风险提示你确认。

这条命令是安全的，选 2. Allow for this session （本次会话内全部允许），以后同类命令不再询问，按 ↓ 选到 2 然后回车即可。

选项	说明	建议
1. Allow once	只允许这一次，下次还会再问	适合不确定的命令
2. Allow for this session	本次会话内不再询问	✅ 推荐，日常使用最方便
3. Deny	拒绝执行	命令可疑时选择

需要注意，如果以前没有授权过终端权限，可能会弹此提醒，需要手动在mac 上的设置里面配置一下。

执行结果：

第四步：配置 LLM 提供商

首次启动会引导你配置，也可以之后单独配置：

bash 复制代码

hermes model      # 选择 LLM 提供商和模型
hermes tools      # 配置启用哪些工具
hermes setup      # 运行完整配置向导

支持 300+ 个模型，以及 Web 搜索、图像生成、TTS、云端浏览器等工具网关，无需逐一配置 API key。

可选：Homebrew 安装方式

如果你更喜欢用 Homebrew：

bash 复制代码

brew install nousresearch/tap/hermes-agent
hermes start
open http://127.0.0.1:7777   # 打开 Web UI

macOS 权限配置（桌面自动化功能）

如果 Hermes 需要控制桌面或截屏，macOS 可能会阻止操作，需要手动授权。

打开「系统设置 → 隐私与安全性」，为终端或 Hermes 应用开启以下权限：

辅助功能（Accessibility）：允许与 UI 元素交互
屏幕录制（Screen Recording）：允许检查桌面布局

常见问题排查

问题	解决方案
命令找不到 `hermes`	执行 `source ~/.zshrc` 重载 Shell
用了 sudo 导致权限混乱	`sudo rm -rf ~/.hermes/ /root/.hermes/` 然后以普通用户重新安装
Node.js 安装失败	`brew install node` 手动安装后重试
Python 版本过低	安装脚本会通过 `uv` 自动管理 Python 3.11，一般无需手动处理

官方文档：https://hermes-agent.nousresearch.com/docs/getting-started/installation