gbrain：让 AI 代理记住上次会话的检索层，但先看清安装陷阱

它解决什么问题：代理的失忆症

AI 编码代理在每次会话后都会忘记之前的工作。gbrain 的定位是给这些代理加一层长期笔记，让它们能在后续会话中检索到之前的对话、会议记录和人物关系。作者 Garry Tan 声称用它在自己的 OpenClaw 和 Hermes 部署中管理了 155,795 个页面、24,589 个人和 5,340 家公司。这不是一个给终端用户用的搜索工具，而是给代理用的记忆层。它面向两类人：一类是已经用 Codex 或 Claude Code 写代码、希望代理记住项目历史的开发者；另一类是运行 24/7 代理、希望自动摄取邮件和语音通话的个人用户。

机制：合成层加知识图谱，零 LLM 调用建边

gbrain 的核心是两个组件。第一个是合成层：当用户查询时，它不返回页面列表，而是生成一段带引用的散文答案，并明确标注大脑不知道的部分。README 里给出的例子是，问「和 Alice 开会前需要知道什么」，返回的是 Alice 的职位、上次谈话时间、三个未决事项，以及一个提醒：六周内没有新数据。第二个组件是自建知识图谱：每次写入页面时，它提取实体引用并创建类型化边，比如 `attended`、`works_at`、`invested_in`，这个过程不需要调用 LLM。这意味着图遍历可以回答「谁在 Acme 工作」这类向量搜索难以直接处理的问题。作者提供了基准：在 240 页的语料上，P@5 为 49.1%，R@5 为 97.9%，比关闭图功能的变体高 31.4 个百分点。但注意，这些数字来自作者自己的 evals 仓库，不是独立测试。

安装：只有 GitHub 路径，npm 包是陷阱

README 用警告框强调，gbrain 不在 npm 上分发。npm 上的 `gbrain` 包是无关项目，运行 `npm install -g gbrain` 会装错东西，甚至遮蔽真正的二进制。官方安装方式是 `bun install -g github:garrytan/gbrain`，或者 `git clone` 后执行 `bun install && bun link`。如果误装了 npm 包，需要先卸载再重装，`gbrain doctor` 命令可以检测遮蔽问题并打印修复方法。推荐路径是先用 Codex，因为它基于已有的 ChatGPT 订阅，约 15 分钟完成；OpenClaw 或 Hermes 的常驻设置约 30 分钟。数据库用 PGLite，两秒即可就绪，无需服务器。这些具体命令和流程都来自 README，我没有实际运行过，所以无法验证安装时间。

团队大脑的权限边界：作者声称零泄漏，但需自行验证

gbrain 也定位为团队共享记忆，每个成员按登录身份获得自己的数据切片，查询时只能看到被允许的内容。README 说他们针对搜索、列表、查找和多源读取做了模糊测试，结果是零泄漏。这个说法听起来很吸引人，但它是作者自己的测试，不是安全审计。对于团队部署，权限隔离是核心风险点，任何检索层一旦漏数据，后果比搜索不准确严重得多。文档没有提供如何配置这些权限的具体细节，只提到了 `company-brain` 教程链接。如果你想用于团队，第一步应该是在自己的数据上复现那个模糊测试，而不是直接信任「零泄漏」的声明。

限制：不适合简单搜索，依赖代理自动运行

gbrain 的设计假设是代理会持续写入笔记。如果你不运行常驻的 OpenClaw 或 Hermes，只是偶尔用 Claude Code 问几个问题，那它可能只是一个大材小用的检索层。README 明确说，合成层和知识图谱的价值在于「大脑」持续摄取数据，如果数据不更新，gap analysis 只会告诉你「六周没有新内容」。另一个限制是，它不做代码搜索，它处理的是笔记、人物、公司这类非代码信息。对于需要 grep 代码库的开发者，它毫无帮助。此外，它依赖 PGLite 作为默认数据库，虽然无需服务器，但可能不适合已有 Postgres 基础设施的团队。

替代方案：向量数据库加 RAG 与图数据库

gbrain 的替代方案有两类。第一类是纯向量检索加 RAG，比如用 pgvector 加 OpenAI 嵌入，配合 LangChain 做检索增强生成。这种方案没有图遍历，回答「谁投资了 Bob」这类关系查询会很吃力，但胜在组件成熟、可控。第二类是图数据库，比如 Neo4j 加向量索引，它天然支持关系遍历，但需要自己实现实体提取和边构建，通常要调用 LLM 来抽取三元组，成本高且容易出错。gbrain 的差异点在于它把图构建做成了零 LLM 调用，并且把合成和 gap analysis 打包进一个工具。如果你已经有现成的 RAG 管道，迁移到 gbrain 可能不值得；如果你从零开始，gbrain 省去了自己拼装的功夫。

维护与许可证：MIT 但升级路径单一

gbrain 使用 MIT 许可证，意味着你可以自由修改和商用，但没有义务贡献回上游。维护方面，最近一次推送是 2026-08-29，版本号 v0.47.5.0，更新频繁，几乎每天都有新版本。但升级只能通过 GitHub 路径，不能走 npm，这意味着你需要手动管理 `bun update` 或重新 clone。频繁的版本迭代也可能带来 API 变化，文档没有提到迁移指南，所以升级前最好查看 CHANGELOG 或 release notes。另外，README 提到 `llms.txt` 和 `AGENTS.md` 文件，说明项目为代理提供了文档入口，这对自动化安装有帮助，但也意味着你需要定期拉取这些文件以保持代理配置最新。

编辑结论

gbrain 适合已经依赖 OpenClaw、Hermes 或 Claude Code 的开发者，尤其是愿意让代理自动摄取会议、邮件和推文的个人用户。它不适合只想要简单关键词搜索的人，也不适合对 npm 包名敏感、不愿从 GitHub 源码安装的团队。安装前必须验证 PATH 上没有被 npm 上的同名无关包遮蔽，运行 `gbrain doctor` 检查。在投入数据之前，先测试多用户权限隔离，因为 README 声称零泄漏，但那是作者自己的 fuzz 测试，不是第三方审计。最后，确认你接受 PGLite 作为默认数据库，以及所有数据都存储在你自己的硬件上。

官方来源

1. Official README
2. Project repository
3. Release notes