HermesAgent如何开启长期记忆功能

Hermes Agent 的长期记忆并非神秘黑箱，而是以清晰、透明、完全可控的方式明文存储在你本地电脑的 ~/.hermes/memories/ 目录下——只需几行命令就能直接打开 MEMORY.md 和 USER.md 查看AI记住的项目上下文与你的个人偏好；还能在对话中实时语义检索、用 SQLite 深度验证记忆快照，甚至一键检查配置确保记忆功能真正启用——这不仅是技术细节的揭秘，更是对用户数据主权的郑重承诺：你的记忆，始终由你掌控，看得见、读得懂、查得到。

如果您希望查看 Hermes Agent 中 AI 所保存的长期记忆内容，这些信息并非存储在模型内部或远程服务器中，而是以明文文件形式持久化在本地磁盘上。以下是直接访问和读取这些记忆文件的具体方法：

一、定位并打开 MEMORY.md 与 USER.md 文件

长期情景记忆被拆分为两类结构化文本文件，分别记录环境事实与用户偏好，均存放在 ~/.hermes/memories/ 目录下。MEMORY.md 存储项目上下文、工具使用习惯、技术栈约定等；USER.md 记录沟通风格、格式偏好、工作流习惯等个人画像信息。

1、打开终端（Linux/macOS）或 PowerShell（Windows + WSL2）。

2、执行命令 ls -la ~/.hermes/memories/，确认 MEMORY.md 和 USER.md 文件存在。

3、使用文本编辑器打开对应文件，例如运行 cat ~/.hermes/memories/MEMORY.md 或 code ~/.hermes/memories/USER.md（需已安装 VS Code CLI）。

二、通过会话内工具调用检索记忆条目

Hermes Agent 提供了内置的 memory_search 工具，可在任意对话中触发全文语义检索，无需离开当前交互界面。该工具基于 FTS5 虚拟表对 MEMORY.md 和 USER.md 的全部内容建立索引，支持关键词、短语及布尔逻辑查询。

1、在 Hermes Agent 会话中输入类似指令：“列出所有关于 Next.js 的记忆条目”。

2、Agent 将自动调用 memory_search 工具，并返回匹配的原始记忆段落（以 § 分隔符为边界）。

3、若需精确匹配，可使用双引号包裹短语，例如：““禁用破折号/分号””。

三、使用 SQLite 命令行直接查询会话数据库中的记忆快照

虽然 MEMORY.md 和 USER.md 是主记忆源，但每次会话启动时，系统会将它们的内容注入到会话元数据中，并写入 ~/.hermes/state.db 的 sessions 表。该数据库可被直接读取，用于验证记忆是否成功加载。

1、运行命令 sqlite3 ~/.hermes/state.db 进入交互式 shell。

2、执行 SQL 查询：SELECT memory_snapshot, user_snapshot FROM sessions ORDER BY created_at DESC LIMIT 1;

3、结果中 memory_snapshot 字段即为当前会话所加载的 MEMORY.md 内容快照（已截断至字符限制），user_snapshot 对应 USER.md 快照。

四、检查配置文件确认记忆功能启用状态

若无法查找到预期的记忆内容，需首先确认记忆系统未被禁用。相关开关由配置文件控制，其启用状态直接影响文件读写与快照注入行为。

1、运行 cat ~/.hermes/config.yaml 查看配置。

2、确认以下字段值均为 true：memory_enabled 与 user_profile_enabled。

3、同时核对 memory_char_limit（默认 2200）与 user_char_limit（默认 1375）是否过小导致内容被截断。

今天带大家了解了的相关知识，希望对你有所帮助；关于科技周边的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~