核心用法
Claw Brain 是专为 OpenClaw 和 ClawDBot 设计的个人AI记忆中枢，通过 get_full_context() 接口为每次对话注入完整上下文。安装后自动监听 gateway:startup 和 command:new 事件，实现无感知的记忆刷新与会话归档。
典型集成流程：
1. 调用 get_full_context(session_key, user_id, agent_id, message) 获取完整上下文包
2. 利用返回的 user_profile、mood、memories、personality 生成个性化回复
3. 通过 learn_user_preference() 沉淀交互洞察
4. 关机时调用 close() 安全释放连接
存储策略： 优先 PostgreSQL + Redis 生产级架构，无配置时零依赖 fallback 到 SQLite。
---
显著优点
- 真正的人格系统：6维动态特质（幽默、共情、好奇、创意、助人、诚实）随交互演化，非静态提示词
- 全栈上下文感知：情绪检测、意图识别、记忆检索、人格指导、建议回复五合一输出
- 零配置启动：SQLite 模式开箱即用，生产环境仅需环境变量切换
- 安全设计：API密钥等敏感信息支持加密存储，避免明文泄露
- 生态深度整合：专为 OpenClaw/ClawDBot 事件体系设计，非通用外挂
---
潜在局限
- 平台锁定：事件钩子（
gateway:startup、command:new）为 OpenClaw/ClawDBot 专属，无法直接移植到其他框架 - 情绪检测精度：基于规则/关键词的轻量实现，非LLM级深度语义理解，复杂 sarcasm 或隐喻可能误判
- 记忆检索机制未明示：文档未说明向量相似度 vs 关键词匹配，大规模记忆下的召回质量存疑
- 缺乏记忆过期/衰减策略：长期记忆累积可能导致上下文膨胀，未提及自动清理或重要性打分
- 生产依赖较重：PostgreSQL + Redis 双组件运维成本高于纯SQLite方案
---
适合人群
- OpenClaw/ClawDBot 用户：生态原生适配，无需改造即获得记忆能力
- 追求"有灵魂"AI的开发者：厌倦千篇一律的回复，希望AI展现持续进化的个性
- 隐私敏感场景：需要本地部署、加密存储的用户数据场景
- 渐进式扩容项目：从SQLite快速验证，平滑迁移至PostgreSQL生产集群
---
常规风险
| 风险点 | 说明 | 缓解建议 |
|--------|------|----------|
| 远程安装脚本 | `curl | bash` 模式存在供应链攻击面 | 校验checksum后执行，或改用手动安装 |
| 环境变量泄露 | `BRAIN_POSTGRES_PASSWORD` 等敏感配置可能入shell history | 使用 systemd drop-in 或 secret 管理服务 |
| 记忆数据持久化 | SQLite 默认本地存储，容器场景需挂载卷 | 明确数据目录，配置备份策略 |
| 版本兼容性 | 3.0.0 重大版本升级可能破坏旧记忆格式 | 升级前导出备份，阅读changelog |