Hermes Memory 实战:长期记忆适合存什么,不适合存什么
适合谁
想让 Hermes 长期记住项目、偏好和工作方式的用户
建立一套可维护的 Hermes memory 写入策略,让记忆帮助长期协作,而不是污染上下文。
交付物
学完后你会留下什么
一份 memory 写入/跳过/清理规则,以及首次整理 USER.md 和 MEMORY.md 的执行清单。
开始前确认
前置条件
- 已经能启动 Hermes
- 知道自己希望 Agent 长期记住哪些项目或偏好
- 愿意定期整理记忆内容
你会学到
Hermes memory
建立一套可维护的 Hermes memory 写入策略,让记忆帮助长期协作,而不是污染上下文。
教程内搜索
支持桌面与移动端。回车可直接搜索。
Hermes Memory 的价值不在于“什么都记”,而在于知道什么值得长期记住。记忆一旦污染,会让 Agent 后续判断越来越偏。
官方文档说明 Hermes 有 bounded、curated memory,并使用 MEMORY.md 与 USER.md 两类文件来保存长期信息。这两个文件会在会话开始时注入系统提示,因此写入内容必须克制。
两类记忆怎么分
| 目标 | 适合保存 | 不适合保存 |
|---|---|---|
MEMORY.md | 项目路径、工具链、约定、环境事实、踩坑记录 | 临时日志、整段代码、一次性报错 |
USER.md | 用户偏好、沟通风格、长期期待 | API Key、隐私凭据、短期情绪 |
| Session Search | 查过去某段对话或任务 | 代替结构化项目文档 |
推荐写入的内容
适合写入 memory:
- 项目使用 pnpm、Astro、Vercel,构建命令是
npm run build。 - 用户偏好中文简洁回答,代码解释不要太长。
- 某个项目不要用 destructive git 命令。
- 某个部署环境只能使用固定 Node 版本。
- 迁移已在某天完成,后续不要重复执行。
不适合写入 memory:
- “用户今天问了 Python” 这种太模糊的信息。
- 大段错误日志和原始输出。
- 能轻易重新搜索到的通用知识。
- token、密码、私钥、session cookie。
- 尚未验证的一次性猜测。
三个真实场景
场景一:你长期维护一个 Astro 站点。适合写入 memory 的不是“今天改了首页”,而是“这个项目部署在 Vercel,构建前需要跑 build、seo-check、smoke-check,站点偏好中文内容和明确内链”。这类信息会反复影响未来任务。
场景二:你常让 Hermes 帮你写内容。适合写入 USER.md 的不是临时情绪,而是稳定偏好,例如“标题要具体,不写空泛口号,中文段落保持短句”。这样 Agent 后续会更像在延续你的写作标准。
场景三:你让 Hermes 接了消息入口。不要把群聊里的所有临时讨论都写进 memory。只有当某个决定会长期影响项目,例如“生产环境不能自动执行 destructive 命令”,才应该沉淀。
一句话:memory 不是日记本,而是长期协作的操作约定。
Memory 写入规则
建议你给 Hermes 一个明确的约束:
只有当信息会在未来多次影响项目决策、工具调用或沟通偏好时,才写入 memory。
不要保存 secrets,不要保存临时日志,不要保存未验证猜测。
当 memory 接近上限时,先合并旧条目,再写入新条目。
维护节奏
每周或每次大项目完成后,做一次记忆整理:
- 删除过期项目路径。
- 合并重复偏好。
- 把“踩坑”改写成可执行约定。
- 把临时任务记录移出 memory。
- 确认没有 secrets。
记忆失效时先查什么
如果你觉得 Hermes “明明应该记得却没记住”,不要立刻继续追加 memory。先按顺序检查:
- 这条信息是否真的写入了
MEMORY.md或USER.md。 - 写法是否太长、太散,导致模型抓不到关键约束。
- 是否存在相互矛盾的旧记忆。
- 当前 profile 是否和写入 memory 的 profile 一致。
- 这个场景是否更适合 skill、项目 README 或 session search,而不是 memory。
很多 memory 问题不是“记得太少”,而是“记得太杂”。越是长期运行的 Agent,越需要定期把记忆压缩成清晰规则。
和 Skills 的关系
Memory 负责记住事实和偏好,Skills 负责沉淀可复用动作。不要把流程步骤都塞进 memory;一旦某个流程稳定、重复、可审查,就应该考虑写成 skill。
完成检查
- 你能分清
MEMORY.md和USER.md的用途。 - 你知道哪些信息绝不能写入 memory。
- 你已经给 Hermes 一条明确的 memory 写入原则。
- 你知道 session search 不是 memory 的替代品,而是查历史对话的工具。
官方资料
继续深挖时,先看这些官方页面
本页内容已按官方文档和产品能力重写,下面这些链接适合你做版本核对和参数确认。
常见问题
你大概率还会继续搜这几个问题
把高频疑问写在教程页内,既减少跳出,也让这篇内容更适合收藏回看。
Hermes memory 适合保存 API Key 吗?
不适合。长期记忆应该保存偏好、项目约定和环境事实,不应保存 secrets、token、密码或高风险凭据。
memory 和 session search 的区别是什么?
memory 适合少量关键事实,进入会话上下文;session search 更适合查过去对话,不适合把所有历史都塞进 memory。
继续学习
下一步推荐
优先继续当前主题,再给一篇桥接内容,避免学习链路被打断。
Hermes Memory 不生效怎么办:排查长期记忆、USER.md 和 Profile
Hermes memory 不生效时,不要只继续追加记忆。先检查写入位置、profile、记忆冲突、session search 和任务类型边界。
Hermes 应用Hermes Skills 实战:自生成、复用与安全审查
把 Hermes skills 当成可审查的能力资产,而不是把所有临时脚本都沉淀成长期技能。
Hermes 安全Hermes Skills 安全审查清单:上线前必须检查的权限、命令和输入输出
Hermes skills 会进入长期复用,不能只看是否能跑。本文给出命令、依赖、secrets、外部 API、日志和人工确认清单。
关联路径
同 Agent 与同意图内容
多 Agent 站点里,相关内容不只看分类,也要看 Agent 归属和搜索意图。
Hermes Agent 是什么:和 OpenClaw、普通聊天机器人的区别
用应用层视角理解 Hermes Agent:memory、skills、messaging gateway、cron、profiles 和从 OpenClaw 迁移到底意味着什么。
Hermes 安装Hermes Agent 安装与 Quickstart:第一次跑通完整清单
从安装命令、首次启动、模型配置到 gateway 前置检查,整理 Hermes Agent 第一次跑通时最该确认的顺序。
Hermes 迁移从 OpenClaw 迁移到 Hermes:能力映射、风险和回滚
把 OpenClaw 用户最关心的迁移问题拆成预览、配置映射、密钥策略、迁移后验收和回滚清单。
OpenClaw 应用OpenClaw WhatsApp 方案怎么选:专用号码、个人号码、自聊模式
别急着接上 WhatsApp,先选对方案:专用号码、个人号码还是 selfChatMode,后续成本完全不同。
OpenClaw 应用OpenClaw 团队落地手册:共享 Skills、审批、渠道配置与边界
把 OpenClaw 从个人玩具变成团队工具,最先要补的不是更多功能,而是团队协议。
OpenClaw 应用OpenClaw 多渠道助手案例:WhatsApp + Telegram + Dashboard 的最小闭环
真正能长期用的 OpenClaw,不是一个渠道接得很深,而是知道多渠道之间如何分工协作。