OpenClaw, but it remembers.
Stop letting context compaction destroy your agent's memory. Swap fragile Markdown files for an enterprise-grade MongoDB brain. Featuring Hybrid Search, Knowledge Graphs, and Event-Sourcing-ClawMongo surgically retrieves context, eliminates token bloat, and scales from personal assistants to multi-agent Company OS architectures.
CAPABILITIES
26 powerful MongoDB native features integrated into OpenClaw.
Automated Embeddings
Native mongot + Voyage AI handles all embedding generation via autoEmbed.
Hybrid Search
Combine Vector and Full-Text recall with $rankFusion for surgically precise context retrieval.
Knowledge Graph
$graphLookup driven entity relationships. Map how your data points connect across conversations.
Change Streams
Real-time reactive triggers across instances to keep multiple gateways strictly in sync.
Scalable Persistence
From single-node local dev with MongoDB Atlas Local to global Atlas clusters. ClawMongo ensures your agent's history is durable, isolated for multi-tenants, and auditable across deployment cycles.
ACID Compliance
No more corrupt JSON files. Idempotent upserts and schema validation keep state consistent.
Tiered Retrieval
Stop burning API tokens. IDs-only projection mode reduces context window bloat by 10x for massive memory spaces.
EVOLUTION OF STORAGE
Why move from flat files to a neural database?
| Feature | OpenClaw Default | ClawMongo |
|---|---|---|
| Storage Backend | SQLite file + Markdown files | MongoDB Atlas Local (Local & Free) |
| Vector Search | sqlite-vec or LanceDB | Auto Embeddings with Voyage SOTA model |
| Knowledge Graph | None | $graphLookup with entities + relations |
| Retrieval Paths | 1 (search) | 8 paths with planner-driven selection |
| Corruption Risk | High (File locking issues) | Zero (ACID Transactions) |
| Reactivity | None (Manual/Polling) | Change Streams (Real-time Triggers) |
ARCHITECTURE
A canonical-truth-first architecture. Events are the single source of truth.
Write Path
Canonical Events
Messages & tool outputs logged as immutable events.
Projection & Extraction
Chunks, entities, temporal concepts (dates/times), and relations are derived and saved. A mutation audit trail protects data integrity.
Auto-Materialization
Refined episodes are materialized from event windows seamlessly.
Retrieval Path
Semantic Query
Two-tier query cache handles exact matches and vector similarity first.
Planner Execution
Scores 8 pathways (active-critical, graph, hybrid, kb, etc.) for best context.
Rerank & Deduplicate
Voyage cross-encoder precision boosts results before delivery to the agent.
READY TO DEPLOY?
# Start bundled MongoDB preview
$ ./docker/mongodb/start-preview.sh
# Install ClawMongo
$ npm install -g @romiluz/clawmongo@latest
# Initialize agent
$ clawmongo onboard --install-daemon
Requires Node.js 22+, Docker, Voyage AI API Key, and Anthropic API Key.
Omni-Channel Support
Connect to 22+ platforms instantly (WhatsApp, Discord, Slack, Matrix...). ClawMongo handles the persistence layer, allowing your agents to be everywhere at once without losing context.
Companion Apps
Manage your agent's memory brain from any device. Complete with Canvas UI and Voice Wake.