Claw Brain

核心用法

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 自动降级能力 |

核心用法

ClawBrain 是为 OpenClaw/ClawdBot 设计的个人 AI 记忆系统，提供六大核心能力：Soul/人格特质（幽默、共情、好奇、创意、助人、诚实）、用户画像学习、对话状态追踪、持续学习洞察、全上下文获取及加密密钥存储。安装方式灵活，支持一键远程安装（curl|bash）或手动克隆，配置通过环境变量完成，支持 SQLite（零配置）和 PostgreSQL+Redis（生产级）两种存储后端。

显著优点

1. 功能完整度高：涵盖记忆存储、情绪检测（detect_user_mood）、意图识别（detect_user_intent）、人格生成等完整链路，API 设计清晰易用
2. 存储灵活：自动检测后端，开发用 SQLite 零配置，生产环境可切 PostgreSQL+Redis
3. 安全设计合理：数据本地存储无外流，使用参数化查询防注入，加密存储敏感凭证
4. 隐私友好：符合 GDPR 数据最小化原则，无外部数据上传
5. 集成便捷：通过 Hook 机制自动刷新记忆，支持 get_full_context() 一键获取完整上下文

潜在缺点与局限性

1. 来源可信度限制：GitHub 账号创建于 2026 年，项目历史仅 4-5 个月，26 stars/4 forks，属 T3 级别个人/社区项目
2. 远程安装风险：curl | bash 模式虽为单层远程加载（L1）且来源可验证，但仍存在供应链攻击面
3. 可选依赖较重：生产级功能依赖 psycopg2、redis、sentence-transformers 等，增加部署复杂度
4. 跨语言调用开销：JavaScript Hook 通过 spawn 调用 Python 桥接脚本，存在进程启动开销
5. 无内置备份机制：用户需自行制定 SQLite 文件或 PostgreSQL 的备份策略

适合人群

• 需要为 AI 助手添加长期记忆能力的 OpenClaw/ClawdBot 用户
• 注重隐私、希望数据本地存储的个人开发者
• 愿意承担社区项目维护风险的技术用户

常规风险

• 供应链风险：远程安装脚本从 GitHub 拉取代码，建议手动克隆审查后安装
• 数据持久化风险：SQLite 单文件易受磁盘故障影响，生产环境务必切 PostgreSQL 并配置备份
• 环境变量泄露：数据库密码通过环境变量传递，需确保日志不记录敏感信息
• 项目持续性风险：新账号维护，需关注更新频率和社区反馈

评估结论

功能实现扎实，代码质量良好，适合对隐私敏感且能接受社区项目风险的用户部署。建议生产环境使用 PostgreSQL 后端并建立监控机制。