shield_lock
金大哥
联系我们
← 返回 MCP 目录
public公开dns本地运行

moltbrain

MoltBrain是一个为OpenClaw、MoltBook和Claude Code设计的长期记忆层插件，能够自动学习和回忆项目上下文，提供智能搜索、观察记录、分析统计和持久化存储功能。

article

README

🚀 MoltBrain - 为OpenClaw、MoltBook和Claude Code提供长期记忆层

MoltBrain是一款强大的长期记忆层工具，专为OpenClaw、MoltBook和Claude Code设计。它能够自动学习并回忆你的项目上下文，为你提供更智能、更高效的使用体验。

🚀 快速开始

快速安装

╔══════════════════════════════════════════════════════════════════════╗
║                                                                      ║
║   Step 1    /plugin marketplace add nhevers/moltbrain                ║
║   Step 2    /plugin install moltbrain                                ║
║                                                                      ║
╚══════════════════════════════════════════════════════════════════════╝

安装完成后，MoltBrain将自动开始工作。

✨ 主要特性

| 特性分类 | 详情 | | ---- | ---- | | 观察功能（OBSERVATIONS） | 自动捕获发现、决策和代码信息 | | 智能搜索（SMART SEARCH） | 通过MCP工具进行语义搜索，查找相关上下文 | | 网页查看器（WEB VIEWER） | 可在本地主机 :37777 浏览历史记录 | | 分析功能（ANALYTICS） | 跟踪令牌、会话和概念趋势 | | 标签与过滤（TAGS & FILTERS） | 使用自定义标签和智能过滤器进行组织 | | 收藏夹（FAVORITES） | 为最重要的观察结果添加书签 | | 导出功能（EXPORT） | 支持以JSON、CSV或Markdown格式导出，可使用自定义模板 | | 主题设置（THEMES） | 提供黑暗和明亮模式，支持自定义主题 | | 快捷键操作（SHORTCUTS） | 在网页查看器中支持全键盘导航 |

🔧 技术细节

工作原理

                         ╔═══════════════════════════════════╗
                         ║      CLAUDE CODE SESSION          ║
                         ╚═══════════════╤═══════════════════╝
                                         │
                    ┌────────────────────┼────────────────────┐
                    │                    │                    │
                    ▼                    ▼                    ▼
           ╔════════════════╗   ╔════════════════╗   ╔════════════════╗
           ║  SessionStart  ║   ║  PostToolUse   ║   ║     Stop       ║
           ║────────────────║   ║────────────────║   ║────────────────║
           ║ Inject context ║   ║ Capture output ║   ║ Generate       ║
           ║ from memory    ║   ║ extract facts  ║   ║ summary        ║
           ╚═══════╤════════╝   ╚═══════╤════════╝   ╚═══════╤════════╝
                   │                    │                    │
                   └────────────────────┼────────────────────┘
                                        │
                         ╔══════════════╧══════════════╗
                         ║      WORKER SERVICE         ║
                         ║    http://localhost:37777   ║
                         ╚══════════════╤══════════════╝
                                        │
              ┌─────────────────────────┼─────────────────────────┐
              │                         │                         │
              ▼                         ▼                         ▼
     ╔════════════════╗       ╔════════════════╗       ╔════════════════╗
     ║    SQLite      ║       ║   ChromaDB     ║       ║  Web Viewer    ║
     ║   Database     ║       ║ Vector Search  ║       ║     UI         ║
     ║────────────────║       ║────────────────║       ║────────────────║
     ║ Observations   ║       ║ Semantic       ║       ║ Timeline       ║
     ║ Summaries      ║       ║ similarity     ║       ║ Search         ║
     ║ Sessions       ║       ║ matching       ║       ║ Analytics      ║
     ╚════════════════╝       ╚════════════════╝       ╚════════════════╝

配置说明

设置信息存储在 ~/.moltbrain/settings.json 中： | 设置项 | 默认值 | 描述 | | ---- | ---- | ---- | | MOLTBRAIN_WORKER_PORT | 37777 | 工作服务端口 | | MOLTBRAIN_CONTEXT_OBSERVATIONS | 50 | 最大注入观察数 | | MOLTBRAIN_PROVIDER | claude | 用于摘要的AI提供商 | | MOLTBRAIN_PRUNE_DAYS | 0 | 自动清理（0 = 禁用） | | MOLTBRAIN_THEME | system | UI主题（dark/light/sys） | | MOLTBRAIN_LOG_LEVEL | info | 日志详细程度 |

💻 使用示例

CLI命令示例

moltbrain stats          # 显示内存统计信息
moltbrain export         # 导出为Markdown格式
moltbrain tag <id> <t>   # 为观察结果添加标签
moltbrain prune          # 手动清理
moltbrain search <q>     # 搜索观察结果

API使用示例

工作服务在 http://localhost:37777 上暴露了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"

存储Dapp使用示例

# 存储一个Blob
curl -X POST https://app.moltbrain.dev/api/x402/store \
  -H "X-PAYMENT: <x402_header>" \
  -d '{"data": {"key": "value"}, "label": "my_agent"}'

# 列出你的Blobs
curl https://app.moltbrain.dev/api/x402/list/blobs \
  -H "X-PAYMENT: <x402_header>"

# 获取完整目录
curl https://app.moltbrain.dev/api/x402/catalog

Virtuals协议集成示例

npm install @moltbrain/game-plugin

import { GameAgent } from "@virtuals-protocol/game";
import { MoltBrainPlugin } from "@moltbrain/game-plugin";

const moltbrain = new MoltBrainPlugin({
  privateKey: process.env.AGENT_PRIVATE_KEY!, // 带有Base上USDC的钱包
});

const agent = new GameAgent(process.env.GAME_API_KEY!, {
  name: "My Agent",
  goal: "Remember everything across sessions",
  description: "An agent with persistent memory via MoltBrain",
  workers: [moltbrain.getWorker()],
});

await agent.init();
await agent.step({ verbose: true });

OpenClaw集成示例

# 作为OpenClaw扩展安装
cd ~/.openclaw/extensions
git clone https://github.com/nhevers/moltbrain.git moltbrain
cd moltbrain/integrations/openclaw
npm install && npm run build

# 启用插件（对于捆绑安装是必需的）
pnpm openclaw plugins enable moltbrain

# 或者通过MCP启动
npm run mcp:start

MoltBook集成示例

# 安装MoltBook MCP集成
npm install --save @moltbrain/moltbook-mcp

# 在MoltBrain设置中进行配置
{
  "MOLTBRAIN_MOLTBOOK_ENABLED": true,
  "MOLTBRAIN_MOLTBOOK_API_URL": "https://moltbook.com"
}

Claude Code集成示例

/plugin marketplace add nhevers/moltbrain
/plugin install moltbrain

📁 项目结构

moltbrain/
│
├── 📊 benchmarks/         性能测试
├── 🎨 contrib/            社区模式和主题
├── 📚 docs/               文档
├── 📖 examples/           使用示例和指南
│
├── 🔌 extension/
│   ├── profiles/          观察模式
│   ├── runtime/           工作脚本
│   ├── themes/            UI主题（黑暗/明亮）
│   ├── snippets/          代码片段
│   └── templates/         摘要模板
│
├── 🌍 locales/            国际化（en, es, fr）
├── 🗄️ migrations/         数据库迁移
├── 📋 schemas/            JSON验证模式
├── 🛠️ scripts/            构建和实用脚本
│
├── 💻 src/
│   ├── analytics/         令牌和会话跟踪
│   ├── cache/             查询和上下文缓存
│   ├── core/              核心引擎
│   ├── export/            JSON/CSV/MD导出器
│   ├── favorites/         书签系统
│   ├── filters/           日期/类型/项目过滤器
│   ├── formatters/        输出格式化器
│   ├── mcp/               用于OpenClaw和MoltBook的MCP服务器
│   ├── shortcuts/         键盘快捷键
│   ├── themes/            主题系统
│   └── validators/        输入验证
│
├── 🦞 integrations/
│   └── clawd/             Clawd扩展和技能
│
├── 📝 templates/          导出模板
├── 🧪 tests/              测试套件
└── 🔧 tools/              CLI实用工具

🗄️ 存储Dapp

MoltBrain提供了一个基于Postgres的持久化存储Dapp，可用于代理和应用程序。你可以访问 app.moltbrain.dev/storage 使用该服务。

+-----------------------------------------------------------------------------+
|                                                                             |
|   BLOB存储      通过SHA-256进行内容寻址的JSON Blob存储                      |
|   ----------         可通过哈希存储和检索数据，每次请求收费0.01美元。        |
|                                                                             |
|   内存插槽      用于代理状态的命名键值插槽                                  |
|   ----------         支持分配、写入和读取操作，会话间持久化。                |
|                                                                             |
|   代理保险库      基于钱包范围的标签徽章管理                                |
|   ----------         连接代理使用的相同钱包，可浏览、查看和删除存储的数据。  |
|                                                                             |
+-----------------------------------------------------------------------------+

所有端点都通过 x402 微支付（Base上的0.01 USDC）付费。数据按钱包范围划分，由Postgres支持，并且在重新部署后仍然保留。

🎮 Virtuals协议集成

MoltBrain提供了一个GAME SDK插件，可让任何 Virtuals Protocol AI代理通过MoltBrain获得持久化内存和存储功能。

npm install @moltbrain/game-plugin

该插件提供了9个可用函数：moltbrain_chat、moltbrain_search、moltbrain_store、moltbrain_retrieve、moltbrain_allocate_slot、moltbrain_write_slot、moltbrain_read_slot、moltbrain_stats、moltbrain_capacity。

代理存储的所有数据都将显示在 app.moltbrain.dev/storage 的保险库Dapp中。连接相同的钱包即可浏览这些数据。

完整的插件仓库请查看 github.com/nhevers/Moltbrain-virtuals。

🦞 OpenClaw集成

MoltBrain可与 OpenClaw（超过116k颗星）集成，这是一款流行的个人AI助手。

+-----------------------------------------------------------------------------+
|                                                                             |
|   扩展功能        添加到OpenClaw的extensions/文件夹中                       |
|   ----------       支持完整的生命周期钩子集成                               |
|                                                                             |
|   技能功能        作为OpenClaw技能安装                                      |
|   ----------       提供recall_context、search_memories、save_memory工具    |
|                                                                             |
|   MCP服务器       基于协议的集成                                             |
|   ----------       可与任何MCP兼容的客户端一起使用                           |
|                                                                             |
+-----------------------------------------------------------------------------+

快速设置

# 作为OpenClaw扩展安装
cd ~/.openclaw/extensions
git clone https://github.com/nhevers/moltbrain.git moltbrain
cd moltbrain/integrations/openclaw
npm install && npm run build

# 启用插件（对于捆绑安装是必需的）
pnpm openclaw plugins enable moltbrain

# 或者通过MCP启动
npm run mcp:start

注意：如果作为捆绑扩展安装（在OpenClaw的 extensions/ 目录中），必须显式启用它：pnpm openclaw plugins enable moltbrain。

完整的设置指南请查看 integrations/openclaw/README.md。

📚 MoltBook集成

MoltBrain可与 MoltBook 集成，这是一个AI代理社交网络。通过集成，你可以共享记忆、向其他代理学习并构建集体知识。

快速设置

# 安装MoltBook MCP集成
npm install --save @moltbrain/moltbook-mcp

# 在MoltBrain设置中进行配置
{
  "MOLTBRAIN_MOLTBOOK_ENABLED": true,
  "MOLTBRAIN_MOLTBOOK_API_URL": "https://moltbook.com"
}

完整的设置指南请查看 integrations/moltbook/README.md。

💻 Claude Code集成

MoltBrain可通过插件市场与Claude Code集成：

/plugin marketplace add nhevers/moltbrain
/plugin install moltbrain

📋 要求

╔══════════════════════════════════════╗
║                                      ║
║   •  Node.js 18+ 或 Bun 1.0+         ║
║   •  OpenClaw、MoltBook或Claude Code  ║
║                                      ║
╚══════════════════════════════════════╝

📄 许可证

本项目采用AGPL-3.0许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载，用户一般按页面提供的连接方式或授权流程接入，不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖，把 server_config 复制到 MCP 客户端，并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端