很多刚上手Hermes Agent的朋友都会遇到同一个问题：明明已经跟它聊过好几次了，可每次打开新会话，它就像失忆了一样，什么都不记得。项目路径、代码风格偏好、调试技巧……这些你反复交代的“老本”，每次都得从头再来一遍。

要解决这个问题，靠的不是简单堆叠历史对话，而是Hermes Agent内置的一套分层记忆架构和精准检索机制。说白了，你得教会它“记住该记住的，忘掉该忘掉的”。

启用并验证SQLite长期记忆模块

先说第一个前提：SQLite长期记忆模块必须正确开启。默认情况下Hermes Agent已经开启了SQLite后端，但如果你第一次运行时手动关闭过它，或者配置文件出了什么问题，那么跨会话记忆的能力就彻底没了。

动手检查一下：

第一，打开终端，输入cat ~/.hermes/config.yaml | grep -A 3 "memory:"，确认输出中包含enable: true和backend: sqlite这两行。

第二，如果哪一项是false或者直接缺失了，那就用编辑器打开配置文件，手动补全成这个结构：

memory:
  enable: true
  backend: sqlite

第三，保存之后，执行sudo systemctl restart hermes-agent重启服务。接着检查一下~/.hermes/state.db这个文件是否存在，并且大小不为0。这里要特别提醒：如果这个文件是空的或者根本不存在，说明后端没有真正加载，后续所有记忆检索都是空谈。

向MEMORY.md和USER.md写入关键记忆

验证通过之后，就要往记忆文件里写东西了。Hermes Agent有两份核心记忆文件——MEMORY.md负责存放环境事实，USER.md记录用户画像。两者都有严格的容量上限，超出的内容会被自动截断丢弃，这一点需要格外注意。

往里面写记忆有两种方式：

第一种，用内置的memory工具。比如你希望Agent记住“用户拒绝使用Markdown表格，所有输出必须用纯文本分段”，可以这样操作：

memory(action="add", target="user", content="用户拒绝使用Markdown表格，所有输出必须用纯文本分段")

第二种，直接编辑文件，这种方法一般只在紧急修正时才用。用nano ~/.hermes/memories/USER.md打开文件，手动追加一行偏好描述。保存之前，务必确认全文字符数不超过1375——一旦超过限制，文件会被截断，丢失末尾内容，而且这个过程不可逆。

这一步操作起来其实很简单，直接把文件拖进去就行。

触发跨会话记忆召回

配置正确、记忆也写进去了，那么在新会话启动时，Hermes Agent会自动把MEMORY.md和USER.md的内容注入到系统提示词前缀里，不需要你额外再做什么指令。

怎么验证它有没有生效？很简单。新开一个CLI会话，直接问它：“我上次让你用什么格式生成API文档？”如果Agent准确回答“纯文本分段，不用Markdown表格”，那就说明USER.md已经成功召回了。

如果它回答得含糊不清，或者又把你的偏好问一遍，那就说明USER.md没有被注入。这时候需要回溯检查：config.yaml里memory.enable是不是true？文件路径~/.hermes/memories/USER.md是否存在，内容是否可读？

通过FTS5全文检索调取历史会话

有些时候，你要找的不是固定的偏好信息，而是某次具体对话中的技术细节——比如“上周查到的PostgreSQL连接超时参数”。这种情况下，MEMORY.md那种静态快照就派不上用场了，得调动SQLite里完整的全量历史记录。

操作方法很简单：在任意会话中输入/search PostgreSQL connection timeout。

Agent会立刻从state.db里匹配关键词，返回最相关的3条会话摘要。每条摘要都包含时间戳、平台来源（比如Telegram），以及上下文片段。

实测下来，检索响应时间稳定在20毫秒以内，而且整个过程完全不调用LLM——这就意味着，即使模型服务暂时离线，历史信息也能瞬间定位到。这一点在紧急排查问题时尤其实用。