核心用法
ClawBrain 是为 OpenClaw/ClawDBot 设计的个人AI记忆系统，通过 get_full_context() 方法为智能体提供完整的个性化上下文。系统监听 gateway:startup 和 command:new 事件，在服务启动时自动刷新记忆，在会话重置时保存当前会话摘要。
主要工作流程：
1. 安装后配置 BRAIN_AGENT_ID 环境变量
2. 系统启动时自动检测存储后端（PostgreSQL → SQLite 自动降级）
3. 通过 get_full_context() 获取用户画像、情绪状态、意图识别、相关记忆和人格引导
4. 交互后调用 learn_user_preference() 持续学习用户偏好
人格系统：包含6个可演化特质（幽默、共情、好奇、创造、助人、诚实），随交互动态调整。
显著优点
- 零配置开箱即用：SQLite 作为默认后端，无需任何数据库设置即可运行
- 生产级扩展：支持 PostgreSQL + Redis 组合，满足高并发多用户场景
- 自动生命周期管理：服务重启自动刷新记忆，
/new命令自动归档会话 - 深度个性化：整合用户画像、实时情绪检测（9种基础情绪）、意图分类（问题/命令/闲聊）
- 安全凭证存储：内置加密机制存储API密钥等敏感信息
潜在缺点与局限性
- 生态锁定：专为 OpenClaw/ClawDBot 设计，跨平台迁移需适配工作
- 学习冷启动：新用户需要一定交互量才能建立准确画像
- 情绪检测准确性：基于规则/关键词的情绪分析，对复杂语境或反讽识别有限
- 数据隐私：持久化记忆涉及用户数据存储，需明确合规边界
- PostgreSQL 依赖较重：生产环境需额外维护数据库和Redis基础设施
适合人群
- ClawdBot/OpenClaw 用户：需要为个人助手添加长期记忆能力
- AI 伴侣开发者：构建具有持续人格演化能力的对话代理
- 多会话场景：需要跨会话保持上下文的生产级部署
- 隐私敏感用户：希望数据自持，而非依赖云端记忆服务
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 数据持久化风险 | SQLite 单文件可能损坏或丢失 | 定期备份；生产环境切换 PostgreSQL |
| 记忆膨胀 | 长期运行后记忆库体积过大 | 实现记忆衰减/归档机制（需自定义） |
| 隐私泄露 | 敏感对话内容被持久化 | 配置加密存储；定期审计记忆内容 |
| 人格漂移 | 自动学习可能导致意外行为变化 | 设置学习边界；定期人工校准 |
| 依赖服务故障 | PostgreSQL/Redis 宕机影响服务 | 利用 SQLite 自动降级能力 |