Hermes Agent 搭建教程:从 macOS 安装到第一次让它真正干活

把 AI Agent 装上电脑，不等于它已经能稳定工作。真正容易卡住的是：模型没配对、工具权限过大、记忆没有边界、网关暴露在公网，最后连“它到底有没有正常运行”都说不清。Hermes Agent 的最短闭环其实很明确：安装 → 选择模型 → 配置工具 → doctor 验证 → 完成一次真实任务。下面按这个顺序搭起来。

问题升级｜你缺的不是聊天窗口，而是一套长期运行的 Agent

大多数 AI 工具把一次对话做得很好，却不负责下一次对话。你需要自己重复解释项目背景、重新打开工具、手动整理结果，定时任务更只能靠外部脚本拼接。

Hermes Agent 的定位不同。它把 CLI/TUI、模型 provider、终端工具、技能、记忆、子代理和消息网关放进同一套 Agent Core。你可以先在终端里使用，稳定后再让它通过 Telegram、Discord、Slack、WhatsApp 或 Signal 接收任务。

先给判断：Hermes 适合想把 Agent 当作长期工作伙伴的人；如果你只想偶尔问几个问题，一个普通聊天产品更省事。

关键发现｜先跑通四个组件，再谈自动化

Hermes 的搭建不是“装完输入 API Key”这么简单，至少有四层需要分开看：

模型层决定它能不能理解和规划。Hermes 支持 Nous Portal、OpenRouter、OpenAI、自定义端点等 provider，可以用 hermes model 切换，不需要改代码。

工具层决定它能做什么。终端、文件、浏览器、搜索、代码执行等工具越多，能力越强，误操作面也越大，所以先用默认或最小工具集跑通。

记忆与技能层决定它会不会越用越顺。Hermes 支持持久记忆、技能创建和跨会话搜索，但“会学习”不等于应该保存所有私密内容，存储范围仍要由你设定。

入口层决定你在哪里使用它。hermes 是 CLI；hermes gateway 才是 Telegram、Discord 等消息平台的入口。不要一开始就把入口暴露出去，先在本机验证前三层。

实测路径｜macOS 的最短安装闭环

本文按官方仓库在 2026-08-07 的 main 提交 71dc211 编写。安装器会处理 uv、Python 3.11、Node.js 22、ripgrep、ffmpeg 等依赖；这也是它比手动拼 Python 环境更省事的地方。

第一步，先看清脚本再执行。官方提供的命令是：

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

这条命令会把远程脚本直接交给 shell。个人测试可以使用，但在公司机器或长期服务器上，建议先下载脚本、检查安装目录与参数，再运行；还可以用 --commit 71dc211b9e7846dcd55144b7f92bde5fe23c1c1a 固定版本，避免教程和实际代码漂移。

第二步，重新加载 zsh 环境：

source ~/.zshrchermes --help

如果命令不存在，先检查 ~/.hermes/bin 是否在 PATH，再运行 hermes doctor。不要先重复安装，重复安装会让问题更难定位。

第三步，运行设置向导：

hermes setup

如果你使用 Nous Portal，希望少维护几套模型、搜索、TTS 和云浏览器密钥，可以选择：

hermes setup --portal

Portal 通过 OAuth 登录，属于外部账号授权；确认页面和账号无误后再批准。若你更倾向自带 Key，就在向导中选择对应 provider，并把密钥只放在 Hermes 的配置路径或系统密钥管理中，不要写进仓库、截图或教程正文。

第四步，选择模型并打开必要工具：

hermes modelhermes toolshermes config gethermes doctor

doctor 通过后，再启动：

hermes

第一次不要问“帮我管理所有项目”。先给一个可验收任务，例如“读取当前目录的 README，列出三条可以核验的改进建议，不修改文件”。任务完成后检查终端输出、文件变更和会话记录，这才算最小闭环跑通。

步骤拆解｜从 CLI 到消息网关的安全扩展

CLI 稳定后，再考虑消息入口。消息网关的价值是让 Agent 不必绑定在 Mac 前台：你可以从 Telegram 或 Discord 发任务，让它在本机或 VPS 上执行。

先做平台连接和允许用户配置，再启动网关：

hermes gateway

具体的 gateway setup、gateway start 和平台 Token 选项以当前官方消息网关文档为准。不要把机器人 Token 发进群聊，也不要把网关端口直接暴露给公网；启用 DM 配对、允许名单和命令审批，先用一个测试账号验证。

需要定时任务时，先从低风险动作开始，例如每天生成一份只读报告。Hermes 自带 cron 调度能力，但定时执行意味着权限会脱离你的即时确认，任务里要写清工作目录、输出位置、失败处理和通知渠道。

如果你来自 OpenClaw，不要直接覆盖迁移。先预览：

hermes claw migrate --dry-run

确认清单后，再决定迁移用户数据或完整配置。记忆、技能、工作区指令和 API Key 的影响范围不同，最好分批迁移。

结果与限制｜能长期运行，不等于可以放任运行

Hermes 的优势是把一次性对话变成可持续的工作流：模型可切换，技能可以沉淀，记忆可以跨会话检索，子代理可以并行，cron 可以把重复任务固定下来。

但它也有明确边界。第一，模型和 Portal 不是免费的魔法，云端推理、搜索、图像、TTS 和浏览器服务可能按订阅或调用计费。第二，Agent 能执行命令就意味着有破坏性操作风险，工具集和工作目录必须最小化。第三，消息网关扩大了入口面，账号配对、Token 保管和日志脱敏不能省。

还有一个容易被忽略的事实：官方安装器会持续更新依赖和代码。长期部署应记录安装提交、配置备份和升级回滚方式；升级后重新跑 hermes doctor，并用一个只读任务做冒烟测试。

行动建议｜先用一个小项目验证，而不是一次配满所有能力

我的建议是分三天搭建。第一天只做 hermes、模型和 doctor；第二天添加一个真实但低风险的文件任务；第三天再接一个消息平台或定时任务。每一步都记录耗时、权限、失败点和人工介入次数。

当你能回答这四个问题时，Hermes 才算搭好：它现在使用哪个模型？启用了哪些工具？它会把什么写入记忆？出了错你如何停止和回滚？

Hermes Agent 的价值不在“装好后替你做一切”，而在于把模型、工具、记忆和入口组织成一个可以持续维护的个人系统。先让它在本机可靠地完成一件小事，再让它拥有更长的时间跨度和更远的消息入口。

你想把 Hermes 接到哪种场景：本地代码助手、Telegram 远程工作台，还是每天自动生成行业监控报告？评论区告诉我，我会继续写对应的权限配置和实战流程。

参考来源

Hermes Agent 官方仓库：https://github.com/NousResearch/hermes-agent
官方文档：https://hermes-agent.nousresearch.com/docs/
官方安装脚本：https://hermes-agent.nousresearch.com/install.sh
Hermes Agent 中文 README：https://github.com/NousResearch/hermes-agent/blob/main/README.zh-CN.md
Hermes Agent AGENTS.md：https://github.com/NousResearch/hermes-agent/blob/main/AGENTS.md