Hermes Agent 上手与迁移实践:一个能沉淀技能和记忆的开源 Agent 平台

Hermes Agent 上手与迁移实践:一个能沉淀技能和记忆的开源 Agent 平台svg xmlns http www w3 org 2000 svg style display none svg

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



 
  
    
     
      
     

很多人用 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 官方已经明确支持的能力。

官方资料里给出的迁移方式有两种:

  1. 首次安装后执行 hermes setup,安装向导会自动检测 ~/.openclaw,并询问是否迁移。
  2. 安装完成后手动执行 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。这个分层非常重要,后续排错基本都绕不开。

实际操作顺序可以概括成这样:

  1. 在 OpenRouter 后台创建 API Key;
  2. 在 Hermes 里把模型提供方切到 OpenRouter;
  3. 先给主模型填入一个可用的免费模型;
  4. 再按任务类型,把辅助模型也配置成 OpenRouter 的免费模型或低成本模型。

这样做的好处很直接:先统一供应商,再慢慢细分槽位,配置和排错都更简单。

官方配置文档中,Hermes 把很多侧任务独立成了可配置槽位,比如 visionweb_extractapprovalcompressiondelegation。真正用起来,主模型决定上限,辅助模型决定成本和稳定性。

openrouter 地址

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

使用 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 确实值得花时间搭起来。

  • GitHub 仓库:https://github.com/NousResearch/hermes-agent
  • 官方文档首页:https://hermes-agent.nousresearch.com/docs
  • Quickstart:https://hermes-agent.nousresearch.com/docs/getting-started/quickstart/
  • Configuration:https://hermes-agent.nousresearch.com/docs/user-guide/configuration/
  • SOUL.md 指南:https://hermes-agent.nousresearch.com/docs/guides/use-soul-with-hermes/
  • CLI Commands Reference:https://hermes-agent.nousresearch.com/docs/reference/cli-commands/
  • API Server:https://hermes-agent.nousresearch.com/docs/user-guide/features/api-server/

小讯
上一篇 2026-04-14 17:18
下一篇 2026-04-14 17:16

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/260641.html