MoltBrain：给 AI Agent 装上「记忆宫殿」

MoltBrain Logo 图1：MoltBrain 品牌标识

当 AI 忘了你是谁

想象你是一家科技公司的 AI 工程师，今天用 Claude Code 处理了一个 OAuth2 认证的完整实现——包括了 JWT 过期策略、PKCE 流程、bcrypt 加盐等所有细节。四十七次会话之后，当你再次打开 Claude Code 询问「密码重置流程」时，Claude 完全不记得你上次做过什么。它会重新探索一遍你的代码库，重新理解项目结构，重新决定用什么技术方案。

这正是 MoltBrain 要解决的核心问题：AI Agent 的短期记忆困境。

项目起源：OpenClaw 社区的真实痛点

MoltBrain 由独立开发者 nhevers 创建，最初是专为 OpenClaw（曾名 Moltbot、ClaedBot）设计的内存层插件。随着 OpenClaw 生态扩展到 MoltBook（AI 社交网络）和 Claude Code，MoltBrain 也逐步演进为支持多平台的通用记忆方案。

这个痛点并非个例。Mem0 团队在 2025 年也注意到了 OpenClaw 社区对持久记忆的强烈需求，并推出了自己的 Mem0 插件方案。两大方案并存说明市场对「AI 跨会话持久记忆」有真实且紧迫的需求。

技术原理：捕获 → 压缩 → 召回

MoltBrain 的工作流分为三个阶段：

捕获阶段（Capture）：通过 OpenClaw 的 Hook 系统，MoltBrain 监听每一次 Agent 会话中的关键操作——文件创建与修改、Shell 命令执行、API 调用决策。区别于简单记录所有对话，MoltBrain 会智能识别「高价值信息」，如技术选型决策、安全策略选择、业务规则定义等，而非流水账式地记录每一轮对话。

压缩阶段（Compress）：每次会话结束后，MoltBrain 调用 LLM（默认 Claude，可配置 Gemini/OpenRouter）对本次会话进行摘要压缩。这个摘要不是简单的「你今天做了什么」，而是将会话提炼为结构化的项目上下文——哪些库被引入、哪些问题被解决、哪些模式被采用。原始对话被存储，而实际注入 Agent 上下文的是这些压缩后的摘要。

召回阶段（Recall）：当新会话开始时，MoltBrain 根据当前任务自动检索相关的历史上下文，通过向量相似度搜索找到最相关的记忆片段，按相关度排序后注入到 Agent 的上下文中。开发者可以通过 REST API (http://localhost:37777/api/search) 手动查询记忆，也可以让 Claude Code 自动注入（最多50条观察，可配置）。

核心架构：模块化插件系统

MoltBrain 采用 TypeScript 编写，代码结构高度模块化，核心由以下模块组成：

src/
  core/
    engine/
      DatabaseManager.ts    # SQLite 向量数据库管理
      SessionManager.ts     # 会话生命周期管理
      SDKAgent.ts           # Claude Agent SDK 核心集成
      GeminiAgent.ts        # Gemini 模型支持
      OpenRouterAgent.ts    # OpenRouter 聚合支持
      SearchManager.ts      # 语义向量搜索
      TimelineService.ts    # 时间线事件服务
      SSEBroadcaster.ts     # 服务端事件流广播
    servers/
      mcp-server.ts          # MCP 协议服务器
    api/
      Server.ts             # Express HTTP 服务器
    infra/
      ProcessManager.ts     # 进程管理与孤儿清理
      HealthMonitor.ts      # 健康检查与版本验证
      GracefulShutdown.ts   # 优雅停机处理
    vector/                 # 向量嵌入层
    storage/                # 存储抽象（本地/远程）
  plugin/
    hooks/                  # OpenClaw Hook 处理器
    commands/               # CLI 命令扩展
    ui/                     # 插件界面组件
  mcp/                     # MCP Server 实现
  servers/                 # 多协议服务器

技术栈亮点：

核心框架：Node.js >= 18 / Bun >= 1.0 双运行时支持，充分利用 Bun 的极速启动优势
AI 集成：@anthropic-ai/claude-agent-sdk（Claude 官方 SDK）+ MCP SDK（Model Context Protocol 标准实现）
HTTP 服务：Express.js 提供 REST API + Server-Sent Events 实时推送
前端界面：React + ReactDOM，支持插件内嵌 UI
数据存储：SQLite 向量数据库（本地），可选 Postgres（远程 DApp 存储）
构建工具：esbuild 极速打包，TypeScript 完整类型保障

多平台集成：四大 Agent 生态

MoltBrain 不仅仅服务 Claude Code，而是面向整个 AI Agent 生态：

平台	集成方式	说明
OpenClaw	Plugin Hook	通过 `/plugin marketplace add` 安装，Hook 系统拦截会话
MoltBook	Plugin Hook	AI 社交网络平台，记忆跨社交互动
Claude Code	Plugin Hook	直接通过插件系统安装，自动上下文注入
Virtuals Protocol	Game SDK Plugin	AI 游戏 Agent，通过 Vault DApp 实现链上持久化

特别是 Virtuals Protocol 集成，MoltBrain 为 AI 游戏 Agent 提供了持久化记忆能力，存储数据会出现在 app.moltbrain.dev/storage 的 Vault DApp 界面中，让玩家和开发者可以可视化查看 Agent 的记忆状态。

上手体验：30 秒安装

MoltBrain 的安装极其简单，对于已安装 OpenClaw/MoltBook/Claude Code 的用户：

/plugin marketplace add nhevers/moltbrain
/plugin install moltbrain

安装完成后 MoltBrain 自动启动，无需任何配置——这体现了设计者对用户体验的重视。但需要注意的是：

使用门槛：需要先有 OpenClaw/MoltBook/Claude Code 之一，纯新手无法独立使用
依赖外部 Agent：本质是一个插件，不是一个独立可运行的 AI 应用
API 端口：Worker 默认监听 37777 端口，防火墙需放行

REST API：可编程的记忆管理

对于开发者，MoltBrain 暴露了完整的 REST API：

# 健康检查
curl http://localhost:37777/health

# 语义搜索记忆
curl "http://localhost:37777/api/search?q=authentication"

# 查看项目时间线
curl "http://localhost:37777/api/timeline?project=my-app&days=7"

# 导出记忆数据
curl "http://localhost:37777/api/export?format=json" > backup.json

# 获取统计信息
curl "http://localhost:37777/api/stats"

通过 API，开发者可以构建自己的前端界面、CI/CD 集成或其他自动化工作流。

当前局限与争议

MoltBrain 并非完美方案，需要注意以下问题：

数据主权：记忆数据存储在本地 SQLite（~/.moltbrain/），如果使用 Vault DApp 则数据会上传到第三方服务，数据控制权取决于用户选择
隐私考量：所有会话上下文都被记录和压缩存储，对于处理敏感代码的企业用户，需要评估数据合规风险
向量检索精度：基于 embedding 的语义搜索在处理高度技术性的代码片段时，可能出现「看似相关但实际不匹配」的召回结果，需要人工验证
平台依赖性：作为 OpenClaw 插件存在，一旦上游平台停止维护，插件的可用性也会受影响

行业意义：AI Agent 从「单次会话」到「持续学习」

MoltBrain 代表的趋势是 AI Agent 从「每次会话独立」到「跨会话持续学习」的范式转变。传统 AI 助手每次启动都是从零开始，而具备持久记忆的 Agent 可以：

积累对特定代码库的深层理解
记住项目的架构决策历史和理由
在多轮迭代中持续优化解决方案
避免重复踩同样的坑

随着 AI Agent 在软件开发、业务自动化、客服等领域的深入应用，「记忆」将成为这些 Agent 从「工具」进化为「助手」的关键能力。MoltBrain 作为这一趋势的早期实践者，为整个生态提供了有价值的设计参考。

项目地址：https://github.com/nhevers/MoltBrain
许可证：AGPL-3.0
当前版本：v9.0.9
主要语言：TypeScript
Star：251

MoltBrain：给 AI Agent 装上「记忆宫殿」

MoltBrain Logo 图1：MoltBrain 品牌标识

当 AI 忘了你是谁

这正是 MoltBrain 要解决的核心问题：AI Agent 的短期记忆困境。

项目起源：OpenClaw 社区的真实痛点

技术原理：捕获 → 压缩 → 召回

MoltBrain 的工作流分为三个阶段：

核心架构：模块化插件系统

MoltBrain 采用 TypeScript 编写，代码结构高度模块化，核心由以下模块组成：

src/
  core/
    engine/
      DatabaseManager.ts    # SQLite 向量数据库管理
      SessionManager.ts     # 会话生命周期管理
      SDKAgent.ts           # Claude Agent SDK 核心集成
      GeminiAgent.ts        # Gemini 模型支持
      OpenRouterAgent.ts    # OpenRouter 聚合支持
      SearchManager.ts      # 语义向量搜索
      TimelineService.ts    # 时间线事件服务
      SSEBroadcaster.ts     # 服务端事件流广播
    servers/
      mcp-server.ts          # MCP 协议服务器
    api/
      Server.ts             # Express HTTP 服务器
    infra/
      ProcessManager.ts     # 进程管理与孤儿清理
      HealthMonitor.ts      # 健康检查与版本验证
      GracefulShutdown.ts   # 优雅停机处理
    vector/                 # 向量嵌入层
    storage/                # 存储抽象（本地/远程）
  plugin/
    hooks/                  # OpenClaw Hook 处理器
    commands/               # CLI 命令扩展
    ui/                     # 插件界面组件
  mcp/                     # MCP Server 实现
  servers/                 # 多协议服务器

技术栈亮点：

核心框架：Node.js >= 18 / Bun >= 1.0 双运行时支持，充分利用 Bun 的极速启动优势
AI 集成：@anthropic-ai/claude-agent-sdk（Claude 官方 SDK）+ MCP SDK（Model Context Protocol 标准实现）
HTTP 服务：Express.js 提供 REST API + Server-Sent Events 实时推送
前端界面：React + ReactDOM，支持插件内嵌 UI
数据存储：SQLite 向量数据库（本地），可选 Postgres（远程 DApp 存储）
构建工具：esbuild 极速打包，TypeScript 完整类型保障

多平台集成：四大 Agent 生态

MoltBrain 不仅仅服务 Claude Code，而是面向整个 AI Agent 生态：

平台	集成方式	说明
OpenClaw	Plugin Hook	通过 `/plugin marketplace add` 安装，Hook 系统拦截会话
MoltBook	Plugin Hook	AI 社交网络平台，记忆跨社交互动
Claude Code	Plugin Hook	直接通过插件系统安装，自动上下文注入
Virtuals Protocol	Game SDK Plugin	AI 游戏 Agent，通过 Vault DApp 实现链上持久化

上手体验：30 秒安装

MoltBrain 的安装极其简单，对于已安装 OpenClaw/MoltBook/Claude Code 的用户：

/plugin marketplace add nhevers/moltbrain
/plugin install moltbrain

安装完成后 MoltBrain 自动启动，无需任何配置——这体现了设计者对用户体验的重视。但需要注意的是：

使用门槛：需要先有 OpenClaw/MoltBook/Claude Code 之一，纯新手无法独立使用
依赖外部 Agent：本质是一个插件，不是一个独立可运行的 AI 应用
API 端口：Worker 默认监听 37777 端口，防火墙需放行

REST API：可编程的记忆管理

对于开发者，MoltBrain 暴露了完整的 REST API：

# 健康检查
curl http://localhost:37777/health

# 语义搜索记忆
curl "http://localhost:37777/api/search?q=authentication"

# 查看项目时间线
curl "http://localhost:37777/api/timeline?project=my-app&days=7"

# 导出记忆数据
curl "http://localhost:37777/api/export?format=json" > backup.json

# 获取统计信息
curl "http://localhost:37777/api/stats"

通过 API，开发者可以构建自己的前端界面、CI/CD 集成或其他自动化工作流。

当前局限与争议

MoltBrain 并非完美方案，需要注意以下问题：

数据主权：记忆数据存储在本地 SQLite（~/.moltbrain/），如果使用 Vault DApp 则数据会上传到第三方服务，数据控制权取决于用户选择
隐私考量：所有会话上下文都被记录和压缩存储，对于处理敏感代码的企业用户，需要评估数据合规风险
向量检索精度：基于 embedding 的语义搜索在处理高度技术性的代码片段时，可能出现「看似相关但实际不匹配」的召回结果，需要人工验证
平台依赖性：作为 OpenClaw 插件存在，一旦上游平台停止维护，插件的可用性也会受影响

行业意义：AI Agent 从「单次会话」到「持续学习」

积累对特定代码库的深层理解
记住项目的架构决策历史和理由
在多轮迭代中持续优化解决方案
避免重复踩同样的坑

项目地址：https://github.com/nhevers/MoltBrain
许可证：AGPL-3.0
当前版本：v9.0.9
主要语言：TypeScript
Star：251