2026年从OpenClaw迁移到Hermes Agent的上手与实践指南

2026-04-15 14:38:03 薛定e的猫咪

概要

很多人用 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 帮你完成安装和配置。

OpenClaw迁移到Hermes Agent

六、把 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，而在于它把长期使用里最麻烦的几件事放到了一个体系里处理：记忆、技能、工具、入口和迁移。

如果你只是想临时跑几个提示词，它未必是唯一选择；但如果你希望 Agent 能越用越顺手，能记住上下文，能沉淀流程，还能把旧系统里的资产带过来继续用，Hermes 确实值得花时间搭起来。

到此这篇关于2026年从OpenClaw迁移到Hermes Agent的上手与实践指南的文章就介绍到这了,更多相关OpenClaw迁移到Hermes Agent内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！