{
  "schemaVersion": "1.0",
  "item": {
    "slug": "braindb",
    "name": "BrainDB",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/Chair4ce/braindb",
    "canonicalUrl": "https://clawhub.ai/Chair4ce/braindb",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/braindb",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=braindb",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "auto-capture.js",
      "config.json",
      "docker-compose.yml",
      "embedder.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/braindb"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/braindb",
    "agentPageUrl": "https://openagent3.xyz/skills/braindb/agent",
    "manifestUrl": "https://openagent3.xyz/skills/braindb/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/braindb/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "BrainDB",
        "body": "Persistent, semantic memory for AI agents. Built for OpenClaw."
      },
      {
        "title": "What It Does",
        "body": "Your AI forgets everything between sessions. BrainDB fixes that.\n\nIt 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.\n\nHow it works:\n\nYou say something → OpenClaw captures important facts → BrainDB stores them\nYou ask something → OpenClaw recalls relevant memories → AI has context\n\nNo commands. No manual saving. It just works."
      },
      {
        "title": "Install",
        "body": "Requires Docker and ~4 GB RAM.\n\nopenclaw plugin install braindb\n\nOr manually:\n\ngit clone https://github.com/Chair4ce/braindb.git ~/.openclaw/plugins/braindb\ncd ~/.openclaw/plugins/braindb\nbash install.sh\n\nFirst run: 3–5 minutes (downloads embedding model). After that: ~10 seconds.\n\nWhat the installer does:\n\nBacks up your existing memory files to ~/.openclaw/braindb-backup/\nBuilds and starts 3 Docker containers (Neo4j, embedder, gateway)\nPatches your OpenClaw config (~/.openclaw/openclaw.json) to enable the plugin\nOptionally offers to migrate existing workspace files into BrainDB\n\nReview install.sh before running if you want to understand each step."
      },
      {
        "title": "What You Get",
        "body": "768-dim semantic search — finds conceptually related memories, not just keyword matches\n4 memory types — episodic (events), semantic (facts), procedural (skills), association (links)\nTiered ranking — semantic similarity always beats keyword match\nAuto-dedup — won't store near-duplicate memories\nHebbian reinforcement — memories strengthen with use, decay without it\nQuery expansion — understands colloquial phrases\n98% recall accuracy on a 50-test benchmark suite\n12–20 ms average query latency"
      },
      {
        "title": "Security & Privacy",
        "body": "Core operation is fully local:\n\nGateway binds to localhost only — not exposed to your network\nNeo4j and embedder are not accessible from the host (isolated Docker network)\nNeo4j password is auto-generated (24-char random)\nOptional API key authentication via BRAINDB_API_KEY\nContainers run as non-root users\nAll embedding, search, and storage runs locally — no external API calls during normal operation\n\nWhat the installer reads/writes:\n\nReads your OpenClaw config (~/.openclaw/openclaw.json) to add the plugin entry\nReads workspace files during optional migration (preview with --scan first)\nWrites .env with generated Neo4j credentials\nCreates Docker volumes for persistent storage\n\nMigration privacy notice:\n\nDefault migration (--no-swarm): Fully local. File contents never leave your machine.\nMigration 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.\nAlways run node migrate.cjs --scan or --dry-run first to see exactly what would be processed."
      },
      {
        "title": "Migrating Existing Memories",
        "body": "Already have MEMORY.md, daily notes, or other workspace files? Import them:\n\nnode migrate.cjs --scan /path/to/workspace   # Preview files (no data sent anywhere)\nnode migrate.cjs --dry-run /path/to/workspace # Extract facts locally, don't encode\nnode migrate.cjs --no-swarm /path/to/workspace # Import, fully local\nnode migrate.cjs /path/to/workspace           # Import (uses swarm if available)\n\nYour files are never modified. BrainDB copies facts from them — it doesn't replace anything."
      },
      {
        "title": "Failover",
        "body": "BrainDB fails gracefully:\n\nGateway down: OpenClaw works normally — the memory block is simply absent from prompts. Your AI still has MEMORY.md and workspace files.\nNeo4j down: Gateway returns empty results. No errors, just no memories.\nEmbedder down: Falls back to text-only search (less accurate but functional).\n\nYour workspace files are the safety net. BrainDB is additive — remove it and you're back to defaults with zero data loss."
      },
      {
        "title": "Uninstall",
        "body": "openclaw plugin remove braindb\n\nThe 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."
      },
      {
        "title": "Performance",
        "body": "MetricValueRecall accuracy98% (50-test suite)Avg latency12–20 msCold query~60 msCapacity10K+ memoriesStorage~3 GBRAM~2.5 GB"
      },
      {
        "title": "Links",
        "body": "Documentation\nOpenClaw\n\nMIT — Oaiken LLC"
      }
    ],
    "body": "BrainDB\n\nPersistent, semantic memory for AI agents. Built for OpenClaw.\n\nWhat It Does\n\nYour AI forgets everything between sessions. BrainDB fixes that.\n\nIt 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.\n\nHow it works:\n\nYou say something → OpenClaw captures important facts → BrainDB stores them\nYou ask something → OpenClaw recalls relevant memories → AI has context\n\n\nNo commands. No manual saving. It just works.\n\nInstall\n\nRequires Docker and ~4 GB RAM.\n\nopenclaw plugin install braindb\n\n\nOr manually:\n\ngit clone https://github.com/Chair4ce/braindb.git ~/.openclaw/plugins/braindb\ncd ~/.openclaw/plugins/braindb\nbash install.sh\n\n\nFirst run: 3–5 minutes (downloads embedding model). After that: ~10 seconds.\n\nWhat the installer does:\n\nBacks up your existing memory files to ~/.openclaw/braindb-backup/\nBuilds and starts 3 Docker containers (Neo4j, embedder, gateway)\nPatches your OpenClaw config (~/.openclaw/openclaw.json) to enable the plugin\nOptionally offers to migrate existing workspace files into BrainDB\n\nReview install.sh before running if you want to understand each step.\n\nWhat You Get\n768-dim semantic search — finds conceptually related memories, not just keyword matches\n4 memory types — episodic (events), semantic (facts), procedural (skills), association (links)\nTiered ranking — semantic similarity always beats keyword match\nAuto-dedup — won't store near-duplicate memories\nHebbian reinforcement — memories strengthen with use, decay without it\nQuery expansion — understands colloquial phrases\n98% recall accuracy on a 50-test benchmark suite\n12–20 ms average query latency\nSecurity & Privacy\n\nCore operation is fully local:\n\nGateway binds to localhost only — not exposed to your network\nNeo4j and embedder are not accessible from the host (isolated Docker network)\nNeo4j password is auto-generated (24-char random)\nOptional API key authentication via BRAINDB_API_KEY\nContainers run as non-root users\nAll embedding, search, and storage runs locally — no external API calls during normal operation\n\nWhat the installer reads/writes:\n\nReads your OpenClaw config (~/.openclaw/openclaw.json) to add the plugin entry\nReads workspace files during optional migration (preview with --scan first)\nWrites .env with generated Neo4j credentials\nCreates Docker volumes for persistent storage\n\nMigration privacy notice:\n\nDefault migration (--no-swarm): Fully local. File contents never leave your machine.\nMigration 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.\nAlways run node migrate.cjs --scan or --dry-run first to see exactly what would be processed.\nMigrating Existing Memories\n\nAlready have MEMORY.md, daily notes, or other workspace files? Import them:\n\nnode migrate.cjs --scan /path/to/workspace   # Preview files (no data sent anywhere)\nnode migrate.cjs --dry-run /path/to/workspace # Extract facts locally, don't encode\nnode migrate.cjs --no-swarm /path/to/workspace # Import, fully local\nnode migrate.cjs /path/to/workspace           # Import (uses swarm if available)\n\n\nYour files are never modified. BrainDB copies facts from them — it doesn't replace anything.\n\nFailover\n\nBrainDB fails gracefully:\n\nGateway down: OpenClaw works normally — the memory block is simply absent from prompts. Your AI still has MEMORY.md and workspace files.\nNeo4j down: Gateway returns empty results. No errors, just no memories.\nEmbedder down: Falls back to text-only search (less accurate but functional).\n\nYour workspace files are the safety net. BrainDB is additive — remove it and you're back to defaults with zero data loss.\n\nUninstall\nopenclaw plugin remove braindb\n\n\nThe 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.\n\nPerformance\nMetric\tValue\nRecall accuracy\t98% (50-test suite)\nAvg latency\t12–20 ms\nCold query\t~60 ms\nCapacity\t10K+ memories\nStorage\t~3 GB\nRAM\t~2.5 GB\nLinks\nDocumentation\nOpenClaw\n\nMIT — Oaiken LLC"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/Chair4ce/braindb",
    "publisherUrl": "https://clawhub.ai/Chair4ce/braindb",
    "owner": "Chair4ce",
    "version": "0.5.2",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/braindb",
    "downloadUrl": "https://openagent3.xyz/downloads/braindb",
    "agentUrl": "https://openagent3.xyz/skills/braindb/agent",
    "manifestUrl": "https://openagent3.xyz/skills/braindb/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/braindb/agent.md"
  }
}