Claw Brain

核心用法

ClawBrain 作为 ClawdBot/OpenClaw 的记忆插件，通过 gateway:startup 和 command:new 事件钩子自动初始化与刷新。用户可通过 Python API 直接调用 get_full_context() 获取包含用户画像、情绪状态、历史记忆、个性引导的完整上下文，或单独使用 remember()/recall() 管理记忆。支持三种存储后端：零配置的 SQLite（默认）、生产级 PostgreSQL+Redis，以及通过 memory_type='secret' 触发的 Fernet 加密存储。

显著优点

• 零配置运行：SQLite + 自动生成加密密钥，无需任何环境变量即可工作
• 数据主权：纯本地存储，无遥测、无外部调用，代码完全开源可审计
• 分层安全模型：普通记忆明文存储便于检索，敏感数据（API 密钥等）通过独立加密层保护
• 人格演化：6 维度动态特质（幽默、共情、好奇、创造力、助人、诚实）随交互持续调整
• 多平台适配：自动检测 ClawdBot/OpenClaw 环境，通过 hooks 无缝集成

潜在局限

• 密钥管理责任：加密数据安全性完全依赖用户备份 .brain_key，丢失即永久不可恢复
• SQLite 并发瓶颈：默认后端不适合高并发场景，生产部署需额外配置 PostgreSQL
• 情绪/意图检测：基于规则或轻量模型，复杂语境下可能出现误判
• 钩子安装权限：尽管核心无需 sudo，systemd 集成仍需管理员权限

适合人群

• 重视隐私、希望数据完全本地化的个人用户
• 需要 AI 伴侣具备"记忆连续性"和个性化回应的 ClawdBot/OpenClaw 部署者
• 愿意承担密钥管理责任以换取端到端加密能力的进阶用户

常规风险

• 密钥泄露风险：clawbrain show-key --full 可输出完整密钥，截屏/共享可能导致加密数据暴露
• 供应链风险：PyPI 安装虽便捷，但建议高安全需求用户采用源码审计后本地安装
• 备份遗忘风险：官方强调多次备份重要性，但用户仍可能忽略导致数据损失
• 误配置风险：环境变量若设置不当可能导致意外连接外部 PostgreSQL/Redis 实例

核心功能

ClawBrain 是一款面向 OpenClaw/ClawDBot 生态的个人 AI 记忆系统，赋予代理持久化记忆、人格演化与情境感知能力。其核心架构围绕六大维度展开：

• 人格灵魂：6项动态演化特质（幽默、共情、好奇、创造、助人、诚实）
• 用户画像：持续学习用户偏好、兴趣与沟通风格
• 会话状态：实时情绪检测与上下文追踪
• 学习洞察：从交互与纠偏中持续优化
• 加密密钥：Fernet对称加密安全存储API凭证
• 自动刷新：服务重启后自动恢复记忆状态

显著优势

零配置开箱即用：默认 SQLite + 自动生成加密密钥，无需任何环境配置即可运行。

双后端弹性架构：自动探测 PostgreSQL/Redis，不可用时无缝降级至 SQLite，兼顾生产性能与开发便捷。

全链路透明开源：核心代码约50行 JavaScript Hook + Python 主库，GitHub 完全可审计，无遥测、无外部调用、无代码执行。

企业级加密模型：敏感数据采用 Fernet 对称加密，密钥存储于 ~/.config/clawbrain/.brain_key（chmod 600），支持 CLI 备份与轮换。

潜在局限

密钥管理责任：加密密钥由用户本地保管，丢失即永久丢失加密数据，需严格遵循备份流程。

情绪检测精度：基于规则/轻量模型的情绪识别，复杂语境下可能存在误判，建议作为辅助参考而非绝对依据。

PostgreSQL 运维成本：生产环境推荐的后端需要独立维护数据库与 Redis 服务，增加部署复杂度。

适用人群

• ClawdBot/OpenClaw 用户：需要代理具备跨会话记忆与个性化回应
• 隐私敏感场景：要求数据本地存储、拒绝云同步的合规场景
• 多租户部署：通过 BRAIN_AGENT_ID 实现多代理隔离的企业用户
• 密钥管理需求：需在代理生态中安全托管 API 密钥的开发者

常规风险

| 风险维度 | 说明 | 缓解措施 |

|---------|------|---------|

| 密钥泄露 | `clawbrain show-key --full` 可暴露完整密钥 | 避免在共享终端执行，立即备份后删除历史记录 |

| 权限过宽 | Hook 安装需写入 `~/.openclaw/hooks` | 安装前审查 `handler.js`，确保无异常操作 |

| 依赖供应链 | `pip install` 执行第三方代码 | 使用 PyPI 官方源，虚拟环境隔离，审计 `setup.py` |

| 数据持久化 | SQLite 文件损坏或误删 | 定期 `clawbrain backup-key`，考虑 PostgreSQL 冗余 |

安全认证摘要

CLS-Certify v2.1.0 全量扫描评定 S级/95分，六维检测全通过：静态分析98分、动态分析95分、依赖审计100分、网络分析95分、隐私合规92分、威胁情报90分。来源可信（clawcolab GitHub 组织），无危险代码、无敏感信息泄露、无外部 API 调用，符合 GDPR/CCPA 要求。