核心用法
ClawBrain 是为 OpenClaw/ClawDBot 设计的个人AI记忆系统，提供完整的记忆、人格、情感联结和学习能力。核心功能围绕 get_full_context() 展开，整合用户画像、情绪状态、对话意图、历史记忆和个性指引，生成高度个性化的AI响应。
安装与初始化：通过 pip install clawbrain[all] 安装，运行 clawbrain setup 自动检测平台、生成加密密钥并安装启动钩子。支持服务重启时自动刷新记忆，无需手动干预。
记忆管理：remember() 存储记忆，recall() 检索记忆，支持按类型筛选（包括加密secret类型）。learn_user_preference() 持续学习用户偏好，构建动态用户画像。
智能感知：内置 detect_user_mood() 情绪检测和 detect_user_intent() 意图识别，实时理解对话上下文。六维人格特质（幽默、共情、好奇、创造、助人、诚实）随交互动态演进。
存储后端：零配置SQLite默认运行，生产环境自动升级至PostgreSQL+Redis架构，通过环境变量灵活配置。
显著优点
- 开箱即用：SQLite零配置启动，自动检测并升级至生产级存储
- 安全加密：Fernet加密保护API密钥等敏感数据，支持多方式密钥备份
- 情感智能：6维 evolving 人格+实时情绪检测，创造有"灵魂"的交互体验
- 生态整合：深度集成ClawdBot/OpenClaw事件系统，自动处理启动和会话重置
- 渐进扩展：从个人测试到企业部署，同一套API无缝扩展
潜在局限
- 平台绑定：主要设计用于ClawdBot/OpenClaw生态，独立Python API功能完整但缺少周边工具链
- 加密风险：密钥丢失导致加密数据永久不可恢复，依赖用户备份意识
- 依赖外部NLP：情绪/意图检测可能依赖外部模型，离线场景能力受限
- PostgreSQL复杂度：生产部署需额外维护数据库和Redis，增加运维负担
适合人群
- ClawdBot/OpenClaw 用户寻求记忆增强和人格化AI
- 需要安全存储API密钥的AI应用开发者
- 从原型到生产希望统一技术栈的技术团队
- 追求情感化、个性化AI交互体验的产品构建者
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 密钥丢失 | 加密密钥未备份导致secret类型记忆永久丢失 | setup后强制提示 `backup-key --all` |
| 数据泄露 | 环境变量或SQLite文件权限配置不当 | 使用PostgreSQL生产部署，严格文件权限 |
| 情绪误判 | 自动情绪检测错误影响响应策略 | 保留用户反馈修正机制 |
| 记忆污染 | 长期学习积累偏见或错误信息 | 定期审计记忆内容，支持 `/new` 会话重置 |