Long-term memory layer for OpenClaw, MoltBook & Claude Code that learns and recalls your project context automatically.
Install • Features • How It Works • Storage • Virtuals • OpenClaw • Config • API
---``` ╔══════════════════════════════════════════════════════════════════════╗ ║ ║ ║ Step 1 /plugin marketplace add nhevers/moltbrain ║ ║ Step 2 /plugin install moltbrain ║ ║ ║ ╚══════════════════════════════════════════════════════════════════════╝ ```
That's it. MoltBrain starts working automatically.
---# Search observations ```
--- ## 📁 Project Structure ``` moltbrain/ │ ├── 📊 benchmarks/ Performance tests ├── 🎨 contrib/ Community modes & themes ├── 📚 docs/ Documentation ├── 📖 examples/ Usage examples & guides │ ├── 🔌 extension/ │ ├── profiles/ Observation modes │ ├── runtime/ Worker scripts │ ├── themes/ UI themes (dark/light) │ ├── snippets/ Code snippets │ └── templates/ Summary templates │ ├── 🌍 locales/ i18n (en, es, fr) ├── 🗄️ migrations/ Database migrations ├── 📋 schemas/ JSON validation schemas ├── 🛠️ scripts/ Build & utility scripts │ ├── 💻 src/ │ ├── analytics/ Token & session tracking │ ├── cache/ Query & context caching │ ├── core/ Core engine │ ├── export/ JSON/CSV/MD exporters │ ├── favorites/ Bookmark system │ ├── filters/ Date/type/project filters │ ├── formatters/ Output formatters │ ├── mcp/ MCP server for OpenClaw & MoltBook │ ├── shortcuts/ Keyboard shortcuts │ ├── themes/ Theme system │ └── validators/ Input validation │ ├── 🦞 integrations/ │ └── clawd/ Clawd extension & skill │ ├── 📝 templates/ Export templates ├── 🧪 tests/ Test suites └── 🔧 tools/ CLI utilities ```
--- ## 🔌 API The worker exposes a REST API at `http://localhost:37777`: ```bash # Health check curl http://localhost:37777/health # Search observations curl "http://localhost:37777/api/search?q=authentication" # Get timeline curl "http://localhost:37777/api/timeline?project=my-app&days=7" # Export data curl "http://localhost:37777/api/export?format=json" > backup.json # Get statistics curl "http://localhost:37777/api/stats" ```
--- ## 🗄️ Storage Dapp Persistent, Postgres-backed storage for agents and apps. Live at **[app.moltbrain.dev/storage](https://app.moltbrain.dev/storage)**. ``` +-----------------------------------------------------------------------------+ | | | BLOB STORAGE Content-addressed JSON blobs via SHA-256 | | ---------- Store and retrieve data by hash. $0.01 per request. | | | | MEMORY SLOTS Named key-value slots for agent state | | ---------- Allocate, write, read. Persistent across sessions. | | | | AGENT VAULT Per-wallet scoping with label badges | | ---------- Connect the same wallet your agents use. | | Browse, view, and delete what they stored. | | | +-----------------------------------------------------------------------------+ ``` All endpoints are paid via [x402](https://www.x402.org) micropayments ($0.01 USDC on Base). Data is scoped per wallet, backed by Postgres, and survives redeploys. Agents can tag stored data with a `label` (e.g. `"openclaw_session"`, `"virtuals_agent"`) so the vault shows what stored each item. ```bash # Store a blob curl -X POST https://app.moltbrain.dev/api/x402/store \ -H "X-PAYMENT:" \ -d '{"data": {"key": "value"}, "label": "my_agent"}' # List your blobs curl https://app.moltbrain.dev/api/x402/list/blobs \ -H "X-PAYMENT: " # Full catalog curl https://app.moltbrain.dev/api/x402/catalog ```
--- ## 🎮 Virtuals Protocol Integration GAME SDK plugin that gives any [Virtuals Protocol](https://virtuals.io) AI agent persistent memory and storage via MoltBrain. ```bash npm install @moltbrain/game-plugin ``` ```typescript import { GameAgent } from "@virtuals-protocol/game"; import { MoltBrainPlugin } from "@moltbrain/game-plugin"; const moltbrain = new MoltBrainPlugin({ privateKey: process.env.AGENT_PRIVATE_KEY!, // wallet with USDC on Base }); 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 }); ``` 9 functions available: `moltbrain_chat`, `moltbrain_search`, `moltbrain_store`, `moltbrain_retrieve`, `moltbrain_allocate_slot`, `moltbrain_write_slot`, `moltbrain_read_slot`, `moltbrain_stats`, `moltbrain_capacity`. Everything the agent stores shows up in the vault dapp at [app.moltbrain.dev/storage](https://app.moltbrain.dev/storage). Connect the same wallet to browse it. See the full plugin repo: **[github.com/nhevers/Moltbrain-virtuals](https://github.com/nhevers/Moltbrain-virtuals)**
--- ## 🦞 OpenClaw Integration Works with [OpenClaw](https://github.com/openclaw/openclaw) (116k+ stars) - the popular personal AI assistant! ``` +-----------------------------------------------------------------------------+ | | | EXTENSION Add to OpenClaw's extensions/ folder | | ---------- Full lifecycle hooks integration | | | | SKILL Install as an OpenClaw skill | | ---------- recall_context, search_memories, save_memory tools | | | | MCP SERVER Protocol-based integration | | ---------- Works with any MCP-compatible client | | | +-----------------------------------------------------------------------------+ ``` **Quick setup:** ```bash # As OpenClaw extension cd ~/.openclaw/extensions git clone https://github.com/nhevers/moltbrain.git moltbrain cd moltbrain/integrations/openclaw npm install && npm run build # Enable the plugin (required for bundled installations) pnpm openclaw plugins enable moltbrain # Or via MCP npm run mcp:start ``` **Note:** If installing as a bundled extension (in OpenClaw's `extensions/` directory), you must explicitly enable it: `pnpm openclaw plugins enable moltbrain` See [integrations/openclaw/README.md](integrations/openclaw/README.md) for full setup guide.
--- ## 📚 MoltBook Integration Works with [MoltBook](https://moltbook.com) - the social network for AI agents! Share memories, learn from other agents, and build collective knowledge. **Quick setup:** ```bash # Install MoltBook MCP integration npm install --save @moltbrain/moltbook-mcp # Configure in your MoltBrain settings { "MOLTBRAIN_MOLTBOOK_ENABLED": true, "MOLTBRAIN_MOLTBOOK_API_URL": "https://moltbook.com" } ``` See [integrations/moltbook/README.md](integrations/moltbook/README.md) for full setup guide.
--- ## 💻 Claude Code Integration Works with Claude Code via the plugin marketplace: ```bash /plugin marketplace add nhevers/moltbrain /plugin install moltbrain ```
--- ## 📋 Requirements ``` ╔══════════════════════════════════════╗ ║ ║ ║ • Node.js 18+ or Bun 1.0+ ║ ║ • OpenClaw, MoltBook, or Claude Code ║ ║ ║ ╚══════════════════════════════════════╝ ```
--- ## 📄 License AGPL-3.0 ---
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Built with care for the OpenClaw, MoltBook & Claude Code community
App • Storage Dapp • Virtuals Plugin • x402 Protocol
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━