文章目录
目录
- 概要
- 一、Hermes Agent 到底是什么
- 二、Hermes 为什么值得关注
- 三、从 OpenClaw 迁移，这件事是官方支持的
- 四、安装前先知道 3 个事实
- 五、安装流程
- 六、把 OpenRouter 免费模型配起来
- 七、图形化前端
- 八、结语
很多人用 Agent 一段时间后，遇到的都不是“模型不够强”，而是另外三类问题：记忆留不住，流程复用不起来，换一套系统就得从头配置。
Hermes Agent 值得看的地方，就在于它不是单纯把大模型包上一层 CLI，而是试图把 技能沉淀、长期记忆、工具调用、消息入口和迁移能力 放进同一套系统里。对已经用过 OpenClaw、或者准备长期养一个 Agent 的用户来说，这比“会不会聊天”更重要。
截至 2026 年 4 月 13 日，Nous Research 的 hermes-agent GitHub 仓库显示为 69.1k Star / 9.2k Fork。
Hermes 官方给自己的定位很直接：它是一个 self-improving AI agent。核心不是“会不会聊天”，而是有没有一条持续学习、持续复用的闭环。
官方 README 里强调了几件很关键的事：
- 它会从经验中生成和改进 Skill，而不是每轮都从零开始。
- 它会持续沉淀用户画像和长期记忆，而不是只靠一次会话上下文。
- 它既能跑在本地，也能跑在云端或低成本 VPS 上，不绑定单一终端。
- 它支持多种模型来源，包括 Nous Portal、OpenRouter、Codex、OpenAI 兼容接口等。
这意味着 Hermes 的定位更接近“长期在线的 Agent 操作系统”，而不是单纯的命令行聊天工具。
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 里积累了记忆、技能、模型配置和 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 体系里积累过配置和数据的用户来说，这一点很实际：不用重新养一套记忆和技能。
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。原因很直接：模型选择多，切换方便，而且能直接使用免费模型做入门测试。
如果只是先把 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，而在于它把长期使用里最麻烦的几件事放到了一个体系里处理：记忆、技能、工具、入口和迁移。
如果你只是想临时跑几个提示词，它未必是唯一选择；但如果你希望 Agent 能越用越顺手，能记住上下文，能沉淀流程，还能把旧系统里的资产带过来继续用，Hermes 确实值得花时间搭起来。
到此这篇关于2026年从OpenClaw迁移到Hermes Agent的上手与实践指南的文章就介绍到这了,更多相关OpenClaw迁移到Hermes Agent内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！