MoltBrain
Long-term memory layer for OpenClaw & MoltBook agents that learns and recalls your project context automatically.
Install / Use
/learn @nhevers/MoltBrainAbout this skill
Quality Score
0/100
Category
Development & EngineeringSupported Platforms
Claude Code
Claude Desktop
Cursor
README
<p align="center">
<img width="1344" height="768" alt="Untitled design (32)" src="https://github.com/user-attachments/assets/03483342-0950-4d80-8bd2-423cd644b6ba" />
</p>
<p align="center">
</p>
<p align="center">
<strong>Long-term memory layer for OpenClaw, MoltBook & Claude Code that learns and recalls your project context automatically.</strong>
</p>
<p align="center">
<a href="#-quick-install">Install</a> •
<a href="#-features">Features</a> •
<a href="#-how-it-works">How It Works</a> •
<a href="#-storage-dapp">Storage</a> •
<a href="#-virtuals-protocol-integration">Virtuals</a> •
<a href="#-openclaw-integration">OpenClaw</a> •
<a href="#%EF%B8%8F-configuration">Config</a> •
<a href="#-api">API</a>
</p>
<br>
<br>
<br>
⚡ Quick Install
<p align="center">╔══════════════════════════════════════════════════════════════════════╗
║ ║
║ Step 1 /plugin marketplace add nhevers/moltbrain ║
║ Step 2 /plugin install moltbrain ║
║ ║
╚══════════════════════════════════════════════════════════════════════╝
<br>
🧠 What It Does
╭──────────────────────────────────────────────────────────────────────────────╮
│ │
│ ┌─────────────────┐ ┌─────────────────┐ │
│ │ SESSION #1 │ │ SESSION #47 │ │
│ │─────────────────│ │─────────────────│ │
│ │ │ │ │ │
│ │ "Set up auth │ │ "Add password │ │
│ │ with OAuth" │ │ reset flow" │ │
│ │ │ │ │ │
│ └────────┬────────┘ └────────┬────────┘ │
│ │ │ │
│ │ Claude discovers: │ Claude remembers: │
│ │ • OAuth2 + PKCE flow │ • Your auth setup │
│ │ • JWT with 1hr expiry │ • Token structure │
│ │ • bcrypt cost factor 12 │ • Security choices │
│ │ │ │
│ ▼ ▲ │
│ ┌────────────────┐ ┌────────────────┐ │
│ │ CAPTURE │ ──────────────────► │ INJECT │ │
│ │ & LEARN │ MEMORY │ & RECALL │ │
│ └────────────────┘ └────────────────┘ │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
✨ Features
+-------------------------+-------------------------+-------------------------+
| | | |
| OBSERVATIONS | SMART SEARCH | WEB VIEWER |
| ---------------- | ---------------- | ---------------- |
| Auto-captures | Semantic search | Browse history |
| discoveries, | via MCP tools | at localhost |
| decisions & code | finds context | :37777 |
| | | |
+-------------------------+-------------------------+-------------------------+
| | | |
| ANALYTICS | TAGS & FILTERS | FAVORITES |
| ---------------- | ---------------- | ---------------- |
| Track tokens, | Organize with | Bookmark your |
| sessions, and | custom tags & | most important |
| concept trends | smart filters | observations |
| | | |
+-------------------------+-------------------------+-------------------------+
| | | |
| EXPORT | THEMES | SHORTCUTS |
| ---------------- | ---------------- | ---------------- |
| JSON, CSV, or | Dark & light | Full keyboard |
| Markdown with | mode with | navigation in |
| custom templates | custom themes | the web viewer |
| | | |
+-------------------------+-------------------------+-------------------------+
🔧 How It Works
╔═══════════════════════════════════╗
║ 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 ║
╚════════════════╝ ╚════════════════╝ ╚════════════════╝
⚙️ Configuration
Settings stored in ~/.moltbrain/settings.json:
┌──────────────────────────────────────┬─────────┬────────────────────────────┐
│ SETTING │ DEFAULT │ DESCRIPTION │
├──────────────────────────────────────┼─────────┼────────────────────────────┤
│ MOLTBRAIN_WORKER_PORT │ 37777 │ Worker service port │
├──────────────────────────────────────┼─────────┼────────────────────────────┤
│ MOLTBRAIN_CONTEXT_OBSERVATIONS │ 50 │ Max observations to inject │
├──────────────────────────────────────┼─────────┼────────────────────────────┤
│ MOLTBRAIN_PROVIDER │ claude │ AI provider for summaries │
├──────────────────────────────────────┼─────────┼────────────────────────────┤
│ MOLTBRAIN_PRUNE_DAYS │ 0 │ Auto-prune (0 = disabled) │
├──────────────────────────────────────┼─────────┼────────────────────────────┤
│ MOLTBRAIN_THEME │ system │ UI theme (dark/light/sys) │
├──────────────────────────────────────┼─────────┼────────────────────────────┤
│ MOLTBRAIN_LOG_LEVEL │ info │ Logging verbosity level │
└──────────────────────────────────────┴─────────┴────────────────────────────┘
💻 CLI Commands
moltbrain stats # Show memory statistics
moltbrain export # Export to markdown
moltbrain tag <id> <t> # Tag an observation
moltbrain prune # Manual cleanup
moltbrain search <q> # 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
│ ├
