Claw Brain

🧠 AI 记忆系统 · 情感感知 · 人格演化

为 OpenClaw/ClawDBot 提供个性化 AI 记忆系统,支持情感追踪、用户画像学习和多层级存储后端。

收藏
8.9k
安装
3.4k
版本
0.1.5
CLS 安全性认证2026-07-01
点击查看完整报告 >

使用说明

Claw Brain 综合评估

核心用法

Claw Brain 是一款面向 OpenClaw/ClawDBot 生态的个人 AI 记忆系统,通过 get_full_context() 方法为机器人提供完整的上下文感知能力。核心流程包括:服务启动时自动刷新记忆(gateway:startup 事件)、会话结束时保存摘要(command:new 事件),以及实时消息处理时的情感检测与意图识别。支持 Python 直接调用和系统集成两种模式,开发者可通过 remember()recall()learn_user_preference() 等方法构建持久化记忆能力。

显著优点

1. 零配置快速启动:SQLite 后端无需任何数据库配置,适合个人开发和测试场景
2. 弹性架构设计:自动检测 PostgreSQL/Redis,生产环境可无缝切换至高性能存储

3. 多维度人格系统:6 项动态演化的性格特征(幽默、共情、好奇心、创造力、乐于助人、诚实)

4. 端到端上下文:单次调用即可获取用户画像、情绪状态、意图识别、相关记忆和性格引导

5. 安全凭证管理:内置加密机制存储 API 密钥等敏感信息

潜在缺点与局限性

  • 生态锁定:专为 OpenClaw/ClawDBot 设计,脱离该生态后通用性受限
  • 外部依赖:生产级 PostgreSQL + Redis 需要额外运维成本
  • 情绪检测精度:基于规则/简单模型的情绪识别,对复杂语境或反讽处理能力有限
  • 记忆检索机制:未明确说明记忆召回的相似度算法,大规模数据下可能存在检索效率问题
  • 隐私合规:用户画像和会话数据的长期存储涉及 GDPR 等法规风险,文档未提及数据留存策略

适合人群

  • OpenClaw/ClawDBot 生态的机器人开发者
  • 需要快速搭建个性化 AI 助手的个人用户
  • 追求零配置体验、后期可平滑扩展至生产环境的中小团队

常规风险

  • 数据持久化风险:SQLite 模式下数据存储于本地文件,缺乏备份机制时易丢失
  • 环境变量泄露BRAIN_POSTGRES_PASSWORD 等敏感配置若管理不当可能导致数据库暴露
  • 记忆污染:长期运行的记忆系统可能积累过时或错误的用户偏好,缺乏显式的记忆修剪机制
  • 多租户隔离BRAIN_AGENT_ID 区分不同代理,但同一数据库实例下的数据隔离强度依赖 PostgreSQL 权限配置

安全解读

核心用法

ClawBrain 是一个为 OpenClaw/ClawDBot 设计的个性化AI记忆系统,通过 get_full_context() 方法为每次对话注入完整的用户上下文,包括:

  • 用户画像(偏好、兴趣、沟通风格)
  • 情绪检测(实时 mood 识别与意图分析)
  • 记忆检索(相关历史对话的语义召回)
  • 人格引导(6维可进化特质:幽默、共情、好奇、创意、 helpfulness、诚实)

安装支持一键脚本(curl|bash)或手动克隆,配置通过 systemd drop-in 环境变量完成,支持 SQLite(零配置)和 PostgreSQL+Redis(生产级)双后端。

显著优点

1. 真正的个性化:不是简单的 prompt 拼接,而是基于持续交互的用户画像演进
2. 架构灵活:开发用 SQLite,生产切 PostgreSQL,无需改代码

3. 安全设计:API密钥等敏感信息支持加密存储,数据完全本地持久化

4. 生态整合:原生适配 ClawdBot/OpenClaw 的 hook 系统(startup/new 事件)

潜在缺点与局限

  • 单层远程安装风险:官方推荐的 curl|bash 安装虽来源可信(GitHub 官方仓库),但属于 L1 级远程代码执行,建议审查脚本后使用
  • 可选加密依赖:SQLite 加密需手动安装 cryptography,默认无加密
  • 无云端同步:纯本地架构,多设备部署需自行解决数据同步
  • PostgreSQL 运维成本:生产级部署需要额外维护数据库和缓存服务

适合人群

  • 需要长期记忆能力的 AI 助手开发者
  • 追求隐私优先(数据不出本地)的个人/企业用户
  • 已使用 ClawdBot/OpenClaw 生态的用户
  • 愿意投入一定配置成本的生产级部署需求者

常规风险

| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 远程代码执行 | 中 | curl|bash 安装模式,来源可信但建议审查 |
| 敏感信息泄露 | 低 | 依赖环境变量配置,无硬编码密钥 |
| 数据丢失 | 低 | SQLite 单文件易备份;PostgreSQL 需常规DB运维 |
| 隐私合规 | 低 | 本地存储符合 GDPR/CCPA,收集范围属于功能必需 |

Claw Brain 内容

brain文件夹
hooks文件夹
clawbrain-startup文件夹
scripts文件夹
手动下载zip · 36.2 kB
__init__.pytext/plain
请选择文件