概要
使用过Agent的用户大多会体会到，真正限制效率的往往不是“模型不够强大”，而是三类更现实的问题：记忆无法持久保留、流程难以复用、更换系统后需要从头配置。
Hermes Agent真正值得关注的地方在于，它并非简单地将大模型封装成CLI工具，而是试图将技能沉淀、长期记忆、工具调用、消息入口与系统迁移能力整合到同一套体系内。对于已经使用过OpenClaw或计划长期维护一个Agent的用户而言，这些能力比“是否会聊天”重要得多。
截至2026年4月13日，Nous Research的hermes-agent GitHub仓库数据显示为 69.1k Star / 9.2k Fork。
一、Hermes Agent究竟是什么
Hermes官方对其定位非常明确：它是一个 self-improving AI agent。其核心并非“是否会聊天”，而是能否构建一个持续学习、持续复用的闭环机制。
官方README中强调了几个关键特性：
- 它能够从过往经验中生成并改进Skill，而非每轮对话从零开始。
- 它持续沉淀用户画像和长期记忆，而不是仅依赖单次会话上下文。
- 它支持在本地、云端或低成本VPS上运行，不绑定特定终端。
- 它兼容多种模型来源，包括Nous Portal、OpenRouter、Codex、OpenAI兼容接口等。
换言之，Hermes的定位更接近于“长期在线的Agent操作系统”，而非单一的命令行聊天工具。
二、Hermes为何值得关注
Hermes最具辨识度的能力在于，能将“完成过一次的任务”逐步固化为Skill。官方文档对Skills的定义十分清晰：它们是可按需加载的知识文档，采用渐进披露（progressive disclosure）方式，以减少上下文开销。
如果将其理解为“带版本管理的流程模板 + 可被Agent复用的经验表述”，则更贴近真实使用体验。一个只有模型而无技能沉淀的Agent，长期使用体验往往会愈发不稳定；而Hermes的设计目标恰好相反。
持久记忆并非单一文件，而是一整套分层机制
Hermes的记忆系统并非仅“记住聊天记录”，而是将不同层级的信息分开处理：
SOUL.md：定义Agent的身份、说话方式、行为边界。USER.md：记录用户偏好、沟通风格、长期习惯。MEMORY.md：记录稳定事实、环境信息及长期约定。skills/：沉淀可复用的流程。
官方配置文档还给出了默认字符限制，例如 MEMORY.md 默认约2200字符、USER.md 默认约1375字符。这种“有限记忆 + 选择性写入”的方式，通常比无限堆叠聊天记录更加实用。
它不仅支持CLI，还提供多入口能力
Hermes官方提供两类主要入口：
- 终端入口：
hermes - 网关入口：
hermes gateway
此外，官方文档还提供了API Server，通过OpenAI兼容接口将Hermes暴露给Open WebUI、LobeChat、LibreChat、NextChat、ChatBox等前端。换句话说，Hermes本质上是后端Agent内核，而不仅仅是TUI工具。
三、从OpenClaw迁移，官方已提供支持
如果你之前在OpenClaw中积累了记忆、技能、模型配置和API Key，那么迁移并非“社区技巧”，而是Hermes官方明确支持的功能。
官方资料中给出了两种迁移方式：
- 首次安装后执行
hermes setup，安装向导会自动检测~/.openclaw，并询问是否迁移。 - 安装完成后手动执行
hermes claw migrate。
CLI参考文档还提供了更详细的参数，例如：
hermes claw migrate --dry-run hermes claw migrate --yes
文档说明该迁移会覆盖30多类内容，包括：
- settings / persona
- memories / skills
- model providers
- messaging platforms
- MCP servers
- API keys 与其他 secrets
对于已在旧Agent体系中积累过配置和数据的用户来说，这一功能非常实用：无需重新培养一套记忆和技能。
四、安装前需了解的3个事实
Windows原生并非官方推荐路径
官方Quickstart和README均明确说明：Windows用户需先安装WSL2，再在WSL2内运行安装命令。如果直接在原生Windows终端中操作，很多问题并非Hermes本身存在bug，而是环境路径、依赖及shell语义不一致所致。
官方安装命令
Quickstart给出的安装方式为：
# Linux / macOS / WSL2 curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
安装完成后，官方建议的下一步操作是：
source ~/.bashrc hermes
如果中途跳过了引导配置，可再次手动执行：
hermes setup
安装完毕后，最好先执行以下命令确认环境状态：
hermes model hermes tools hermes doctor
其中 hermes doctor 对新手尤其有用，许多模型未配置、网关未接通、依赖不完整的问题都能提前暴露出来。
五、安装流程
上述是Hermes官方推荐的安装路径，即在 Linux / macOS / WSL2 中按官方脚本执行。
如果你习惯将安装和配置工作交给AI助手，也可以直接将以下提示词发送给Codex，让其按官方文档执行：
阅读Hermes官方文档中的安装和配置说明，并严格按照步骤为我在本地安装：https://github.com/NousResearch/hermes-agent
下面这组截图展示的并非官方文档中的纯命令行安装流程，而是在Windows环境中通过Codex辅助安装Hermes的实际过程。两者共同点是都遵循官方文档；区别在于，一个是你手动执行命令，另一个是由Codex帮你完成安装和配置。
六、配置OpenRouter免费模型
本文这套配置中，主模型选择的是 OpenRouter。理由很简单：模型种类多、切换方便，且可直接使用免费模型进行入门测试。
如果只是想先让Hermes跑通，OpenRouter通常是最省事的路径。
Hermes会将密钥类信息写入 .env，而普通配置写入 config.yaml。这个分层非常重要，后续排错基本都离不开它。
实际操作顺序可概括如下：
- 在OpenRouter后台创建API Key；
- 在Hermes中将模型提供方切换为OpenRouter；
- 先为主模型填入一个可用的免费模型；
- 再按任务类型，将辅助模型也配置为OpenRouter的免费或低成本模型。
这样做的好处很明显：先统一供应商，再逐步细分槽位，配置和排错都更加简单。
官方配置文档中，Hermes将许多侧任务独立为可配置槽位，例如 vision、web_extract、approval、compression、delegation。实际使用中，主模型决定上限，辅助模型决定成本和稳定性。
使用codex app配置模型
结合官方配置项和本文的OpenRouter配置思路，可将辅助模型理解为下表：
| 槽位 | 官方用途 | 对体验的影响 | 建议策略 | 备注 |
|---|---|---|---|---|
vision | 图像分析、截图理解、浏览器截图解读 | 中 | 优先选OpenRouter中具备视觉能力的模型 | 适合查看页面、截图、图片 |
web_extract | 网页提炼、页面文本抽取与总结 | 中 | 优先选OpenRouter中的低成本或免费模型 | 高频脏活，最容易消耗成本 |
approval | 危险命令审批分类 | 低 | 使用OpenRouter的便宜模型即可 | 偏安全，非主要体验来源 |
compression | 长上下文压缩摘要 | 高 | 选OpenRouter中稳定性更好的模型 | 直接影响长对话是否顺畅 |
delegation | 子Agent委派任务 | 中高 | 可先用OpenRouter免费模型起步，不够再升级 | 适合拆分子任务并行处理 |
补充：SOUL.md、记忆文件和会话库的分工
根据Hermes官方文档，文件的正确名称为：
~/.hermes/SOUL.md
它与 AGENTS.md 的职责并不相同：
SOUL.md管理“你是谁、如何说话、风格及边界”。AGENTS.md管理“项目中如何做事、代码规范及工作约定”。
对于长期使用，更值得记住的是下面的分工表：
| 文件 / 机制 | 作用 | 谁维护 | 是否会自动更新 | 何时被用到 |
|---|---|---|---|---|
SOUL.md | 定义Hermes的人格、语气、身份感和风格边界 | 主要由用户 | 通常不会自动重写 | 构建系统提示时加载 |
USER.md | 存储用户长期画像，如沟通方式、习惯、偏好 | 用户 + Hermes | 会 | 每轮注入，用于持续个性化 |
MEMORY.md | 存储稳定事实、环境信息、长期约定 | 用户 + Hermes | 会 | 每轮注入，用于减少重复解释 |
skills/ | 存储可复用的方法、流程和经验总结 | 用户 + Hermes | 会 | 遇到相似任务时直接复用 |
| 会话库 / 检索索引 | 存储会话元数据与检索索引，支撑历史检索和上下文恢复 | Hermes | 会 | session_search、恢复上下文、回顾历史 |
从使用成本来看，真正需要你主动维护的通常只有两样：
SOUL.md- 项目中的
AGENTS.md
其他内容更适合让Hermes自己逐步沉淀，而非手工“养数据库”。
七、图形化前端
借助开源项目部署图形化界面：hermes-webui github地址
以下是图形化入口的相关截图：
八、结语
Hermes Agent的价值，不在于它是否是“最新最火”的智能体，而在于它将长期使用中最棘手的几件事整合到一个体系中处理：记忆、技能、工具、入口和迁移。
如果你只是想临时跑几个提示词，它未必是唯一选择；但如果你希望Agent能越用越顺手，能记住上下文，能沉淀流程，还能将旧系统中的资产迁移过来继续使用，Hermes确实值得花时间搭建起来。
