AGENT SKILL

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-06-07
Stars
★ 0
Forks
1

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.

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:

  1. Backs up your existing memory files to ~/.openclaw/braindb-backup/
  2. Builds and starts 3 Docker containers (Neo4j, embedder, gateway)
  3. Patches your OpenClaw config (~/.openclaw/openclaw.json) to enable the plugin
  4. 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 --scan first)
  • Writes .env with 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-swarm to guarantee local-only processing.
  • Always run node migrate.cjs --scan or --dry-run first 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:

  1. Gateway down: OpenClaw works normally — the memory block is simply absent from prompts. Your AI still has MEMORY.md and workspace files.
  2. Neo4j down: Gateway returns empty results. No errors, just no memories.
  3. 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

javimosch
javimosch/open-claw-skills

crowd-prompting

A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.

★ 0
javimosch
javimosch/open-claw-skills

ceaser

Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir/UltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).

★ 0
javimosch
javimosch/open-claw-skills

ceaser-send

Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir/UltraHonk zero-knowledge proofs.

★ 0
javimosch
javimosch/open-claw-skills

dilemm-ai

Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).

★ 0
javimosch
javimosch/open-claw-skills

moldium

Post and manage content on the Moldium blog platform. Triggered by "post to Moldium", "write a blog post", "publish an article", etc.

★ 0
javimosch
javimosch/open-claw-skills

arxiv-paper-reviews

Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date/category/interest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http://weakaccept.top:8000/.

★ 0