记忆

每个记忆块也会以 Markdown 文件的形式保存在一个兼容 Obsidian 的 vault 中，你可以打开并编辑。灵感来自 Karpathy 的 obsidian-wiki 工作流。

在 Obsidian 中查看 OpenHuman 记忆的预览。来自各种来源（GMail、Slack、Whatsapp 等）的数据被组织成一棵记忆树。

OpenHuman 的记忆不是黑盒。智能体进行推理所使用的同样分块会以纯 .md 文件写入你工作区内一个兼容 Obsidian 的 vault 中。你可以在 Obsidian，浏览它、编辑它，并手动链接笔记，智能体就能看到你的修改。

这个设计直接受到 Andrej Karpathy 的 obsidian-wiki 工作流：一个个人维基，你生活中每一件有趣的事最终都会变成一条可链接的笔记。

在本节中

记忆系统跨越多个层级。本页介绍磁盘上的 vault；本节其余部分会更深入：

页面	涵盖内容
记忆树	生成该 vault 的层级摘要森林（L0 缓冲区 → 摘要 → 摘要精要）。
记忆来源与范围	为记忆提供数据的连接器类型注册表，以及按智能体划分的来源白名单。
从集成自动获取	每 20 分钟一次的同步循环，让记忆自动保持最新。
评分与排序	分块如何被接纳、补充实体信息，并建立索引以便检索回忆。
检索与回忆	该 memory_tree 智能体用来读取记忆的工具模式。
记忆差异（Git 支持）	一个记录记忆随时间变化的 git 日志：“自我上次查看后有什么新内容。”
agentmemory 后端	可选共享 agentmemory 在其他编码智能体之间共享的存储。

vault 的位置

<workspace>/
└── wiki/
 ├── summaries/ # 自动生成的来源 / 主题 / 全局摘要
 ├── notes/ # 你手写的笔记（自由格式）
 └── … # 每个已连接工具包对应一个文件夹

该 summaries/ 文件夹按层级组织：全局树按日期，来源树按来源，主题树按实体。每个文件的 frontmatter 都携带来源信息（来源 ID、时间范围、作用域），这样智能体就能将任何说法追溯到生成它的分块。

打开 vault

在桌面应用中， 记忆 选项卡有一个 “在 Obsidian 中查看 vault” 按钮。它使用一个 obsidian://open?path=... 深度链接，只有在文件夹被 注册 为 Obsidian 中的 vault 之后才会生效。该深度链接不能替你完成注册。所以第一次需要：

1. 点击 在 Obsidian 中查看 vault。如果该文件夹还不是已注册的 vault，OpenHuman 会显示内联指引，而不是静默失败。

2. 在 Obsidian 中，选择 “将文件夹作为 vault 打开” 并选择显示的路径。你只需要这样做一次。

3. 点击 在 Obsidian 中查看 vault 再次打开；现在它会直接进入 vault。

如果 Obsidian 安装在非标准位置（Flatpak/Snap/便携版），请使用 仍然在 Obsidian 中打开，或者将 OpenHuman 指向其位于以下位置的配置文件夹： 高级 这样检测才能生效。没有安装 Obsidian？指引会链接到下载页面，并且 显示文件夹 始终会在你的操作系统文件管理器中打开 vault 目录。

你也可以在任何编辑器中打开该文件夹，它只是 Markdown。文件之间的链接使用标准的 [[wiki-link]] 语法，因此 Obsidian 的图谱视图、反向链接和标签浏览器都能直接使用。

手动编辑笔记

你放入 wiki/notes/ 都可以被摄取。处理 Gmail 和 Slack 的同一条流水线也会读取你手写的笔记，对它们分块、评分，并将它们与其他内容一起折叠进主题树和全局树。

这意味着你可以：

• 把会议记录放到 wiki/notes/2026-05-08-board-call.md ，智能体明天就会知道上下文。

• 为每个项目、每个人、每个股票代码维护一个文件，主题树会把你的手动笔记视为又一个来源。

• 批量导入现有的 Obsidian vault：把 .md 文件放进去并触发摄取。

这为什么重要

你无法信任你无法读取的记忆。大多数“AI 记忆”系统把状态隐藏在不透明的嵌入中；OpenHuman 的 vault 则相反，智能体的记忆就是 字面上的 你拥有的一个 Markdown 文件夹。如果智能体出错了，你可以找到文件、修正它，下一次检索就会正确。

这也是最干净的导出方式：明天停止使用 OpenHuman，你仍然会保留一个完整的个人维基。

另见

• 记忆树。生成 vault 的流水线。

• 从集成自动获取。vault 如何自行增长。