braindb
Persistent, semantic memory for AI agents. Gives your AI long-term recall that survives compaction and session resets — 98% accuracy, 20ms latency.
- License 许可
- MIT
- 最近更新
- 2026-05-17
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- braindb
- author
- Oaiken LLC
- license
- MIT
- version
- 0.5.0
- homepage
- https://github.com/Chair4ce/braindb
- metadata
- { "openclaw": { "emoji": "🧠", "install": [ { "id": "release-download", "url": "https://github.com/Chair4ce/braindb/releases/download/v0.5.0/braindb-v0.5.0.zip", "kind": "download", "label": "Download BrainDB v0.5.0", "archive": "zip", "extract": true, "targetDir": "~/.openclaw/plugins/braindb", "postInstall": "cd ~/.openclaw/plugins/braindb && bash install.sh", "stripComponents": 1 } ], "requires": { "env": [], "bins": [ "docker", "node" ], "configPaths": [ "~/.openclaw/openclaw.json" ] }, "uninstall": "cd ~/.openclaw/plugins/braindb && bash uninstall.sh", "permissions": { "configWrite": true, "workspaceRead": true, "networkOptional": "Migration with --swarm sends file contents to Google Gemini API. Default migration is fully local." } } }
- description
- Persistent, semantic memory for AI agents. Gives your AI long-term recall that survives compaction and session resets — 98% accuracy, 20ms latency.
02 资源文件 13
- 参考文档_meta.json446 B
- 脚本auto-capture.js9.7 KB
- 参考文档config.json475 B
- 参考文档docker-compose.yml2.1 KB
- 脚本embedder.py4.7 KB
- 脚本execution-awareness.js16.2 KB
- 脚本gateway.js67.7 KB
- 脚本install.sh7.8 KB
- 脚本migrate.cjs26.0 KB
- 参考文档package.json147 B
- 参考文档README.md10.5 KB
- 脚本setup.sh3.2 KB
- 脚本uninstall.sh8.6 KB
03 SKILL.md 正文
BrainDB
Persistent, semantic memory for AI agents. Built for OpenClaw.
What It Does
Your AI forgets everything between sessions. BrainDB fixes that.
It gives your assistant a memory system that automatically captures important context from conversations and recalls it when relevant — who you are, what you're working on, what you've told it before. Memories persist across compaction, session resets, and restarts.
How it works:
You say something → OpenClaw captures important facts → BrainDB stores them
You ask something → OpenClaw recalls relevant memories → AI has context
No commands. No manual saving. It just works.
Install
Requires Docker and ~4 GB RAM.
openclaw plugin install braindb
Or manually:
git clone https://github.com/Chair4ce/braindb.git ~/.openclaw/plugins/braindb
cd ~/.openclaw/plugins/braindb
bash install.sh
First run: 3–5 minutes (downloads embedding model). After that: ~10 seconds.
What the installer does:
- Backs up your existing memory files to
~/.openclaw/braindb-backup/ - Builds and starts 3 Docker containers (Neo4j, embedder, gateway)
- Patches your OpenClaw config (
~/.openclaw/openclaw.json) to enable the plugin - Optionally offers to migrate existing workspace files into BrainDB
Review install.sh before running if you want to understand each step.
What You Get
- 768-dim semantic search — finds conceptually related memories, not just keyword matches
- 4 memory types — episodic (events), semantic (facts), procedural (skills), association (links)
- Tiered ranking — semantic similarity always beats keyword match
- Auto-dedup — won't store near-duplicate memories
- Hebbian reinforcement — memories strengthen with use, decay without it
- Query expansion — understands colloquial phrases
- 98% recall accuracy on a 50-test benchmark suite
- 12–20 ms average query latency
Security & Privacy
Core operation is fully local:
- Gateway binds to localhost only — not exposed to your network
- Neo4j and embedder are not accessible from the host (isolated Docker network)
- Neo4j password is auto-generated (24-char random)
- Optional API key authentication via
BRAINDB_API_KEY - Containers run as non-root users
- All embedding, search, and storage runs locally — no external API calls during normal operation
What the installer reads/writes:
- Reads your OpenClaw config (
~/.openclaw/openclaw.json) to add the plugin entry - Reads workspace files during optional migration (preview with
--scanfirst) - Writes
.envwith generated Neo4j credentials - Creates Docker volumes for persistent storage
Migration privacy notice:
- Default migration (
--no-swarm): Fully local. File contents never leave your machine. - Migration with swarm: Sends file contents to Google's Gemini API for intelligent fact extraction. This is opt-in only — you must have swarm installed and explicitly allow it. Use
--no-swarmto guarantee local-only processing. - Always run
node migrate.cjs --scanor--dry-runfirst to see exactly what would be processed.
Migrating Existing Memories
Already have MEMORY.md, daily notes, or other workspace files? Import them:
node migrate.cjs --scan /path/to/workspace # Preview files (no data sent anywhere)
node migrate.cjs --dry-run /path/to/workspace # Extract facts locally, don't encode
node migrate.cjs --no-swarm /path/to/workspace # Import, fully local
node migrate.cjs /path/to/workspace # Import (uses swarm if available)
Your files are never modified. BrainDB copies facts from them — it doesn't replace anything.
Failover
BrainDB fails gracefully:
- Gateway down: OpenClaw works normally — the memory block is simply absent from prompts. Your AI still has
MEMORY.mdand workspace files. - Neo4j down: Gateway returns empty results. No errors, just no memories.
- Embedder down: Falls back to text-only search (less accurate but functional).
Your workspace files are the safety net. BrainDB is additive — remove it and you're back to defaults with zero data loss.
Uninstall
openclaw plugin remove braindb
The uninstaller exports all memories (JSON + readable markdown), stops containers, removes the plugin config from OpenClaw, and leaves your workspace files untouched. Docker volumes are preserved until you explicitly delete them.
Performance
| Metric | Value |
|---|---|
| Recall accuracy | 98% (50-test suite) |
| Avg latency | 12–20 ms |
| Cold query | ~60 ms |
| Capacity | 10K+ memories |
| Storage | ~3 GB |
| RAM | ~2.5 GB |
Links
MIT — Oaiken LLC
04 同仓库更多 Skills
zvukogram
Text-to-Speech via Zvukogram API with SSML support. Use when you need to generate speech from text, create podcasts, voice notifications, or work with audio. Supports speed control, stress marks, English word transcription, and audio fragment merging.
zohomail
Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels. Use this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-recruit
Zoho Recruit API integration with managed OAuth. Manage candidates, job openings, interviews, and recruitment workflows. Use this skill when users want to read, create, update, or search recruitment data like candidates, job openings, interviews, and applications in Zoho Recruit. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-people
Zoho People API integration with managed OAuth. Manage employees, departments, designations, attendance, and leave. Use this skill when users want to read, create, update, or query HR data like employees, departments, designations, and forms in Zoho People. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-mail
Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels. Use this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-inventory
Zoho Inventory API integration with managed OAuth. Manage items, sales orders, invoices, purchase orders, bills, contacts, and shipments. Use this skill when users want to read, create, update, or delete inventory items, sales orders, invoices, purchase orders, bills, or other inventory records in Zoho Inventory. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.