核心用法
BrainDB 是专为 OpenClaw 设计的持久化语义记忆插件，解决 AI 助手"会话失忆"问题。安装后自动捕获对话中的重要事实，在后续交互中智能召回相关上下文——无需手动命令或保存。
工作流程：
- 捕获阶段：OpenClaw 自动识别并提取对话中的关键信息
- 存储阶段：BrainDB 将信息编码为 768 维向量，分类为四种记忆类型（情景/语义/程序/关联）
- 召回阶段：语义搜索找到概念相关记忆，按赫布学习强化高频记忆
安装要求：Docker + ~4GB RAM，首次运行需 3-5 分钟下载嵌入模型。提供三种迁移方式：仅扫描预览、完全本地处理、或可选调用 Google Gemini API 进行智能提取（需显式授权）。
---
显著优点
| 特性 | 说明 |
|------|------|
| 真·语义搜索 | 768 维向量匹配，理解概念关联而非关键词 |
| 零配置运行 | 安装后自动集成，无手动维护成本 |
| 优雅降级 | 任一组件故障时自动回退到文本搜索或空结果，不阻断主流程 |
| 隐私优先 | 核心功能完全本地，网络隔离架构 |
| 自我优化 | 记忆随使用强化、随闲置衰减，自动去重 |
---
局限性与风险
资源开销：持续运行需 ~2.5GB RAM + ~3GB 存储，对轻薄设备不友好。
冷启动延迟：首次查询约 60ms，后续降至 12-20ms。
迁移陷阱：默认迁移本地安全，但若误用 --swarm 模式会将文件内容发送至 Google Gemini API。虽有 --no-swarm 兜底，但命令行界面增加了误操作风险。
供应商锁定：深度绑定 OpenClaw 生态，无法独立运行或移植到其他 AI 框架。
容量上限：官方标称 10K+ 记忆，超量后性能与去重策略未明确。
---
适合人群
- 重度 OpenClaw 用户：需要跨项目、跨会话保持长期上下文
- 隐私敏感型开发者：偏好本地优先、拒绝云端记忆服务
- 复杂工作流从业者：处理多步骤任务需 AI 记住中途状态
---
常规风险
- Docker 依赖：容器逃逸或镜像漏洞可能波及主机
- 配置篡改：安装脚本需写权限修改
~/.openclaw/openclaw.json - API 密钥泄露：若设置
BRAINDB_API_KEY，需确保.env文件权限正确 - 卸载残留：Docker volumes 需手动清理，可能遗留敏感数据