核心功能
Mema Brain 是一套为个人 AI 助手设计的标准化记忆系统,通过双层架构解决长期知识存储与短期上下文传递的平衡问题。
长期记忆层(SQLite) 以 ~/.openclaw/memory/main.sqlite 为核心,提供基于标签的 Markdown 文档索引能力。用户可通过 index 命令将工作区文档纳入可搜索的知识库,并通过 list 命令按标签或更新时间检索,实现个人知识库的渐进式构建。
短期记忆层(Redis) 以 mema:mental:* 为命名空间隔离,支持键值对的临时状态存储,默认 6 小时 TTL 自动过期。mental set/get 命令允许跨会话传递上下文意图,例如保持多轮对话中的用户偏好或待办事项。
显著优点
- 架构清晰:冷热数据分离,SQLite 保证持久性,Redis 提供低延迟访问
- 工作流原生:命令行接口直接集成于 OpenClaw 技能框架,无需额外客户端
- 命名空间隔离:Redis 操作严格限定在
mema:mental前缀下,避免键冲突 - 确定性路径:使用绝对路径(
$WORKSPACE或~)确保多实例环境下数据库一致性
潜在局限
- 单用户设计:SQLite 文件锁机制限制并发写入,不适合团队协作场景
- Redis 依赖:需本地或可信 Redis 实例,远程部署增加网络延迟和安全暴露面
- 无内容检索:仅支持标签和时间维度的元数据索引,不支持全文搜索
- TTL 硬编码:默认 6 小时过期策略无法按 key 灵活调整
适合人群
- 需要维护个人知识库的独立开发者或研究者
- 使用 OpenClaw 框架构建长期运行 AI 助手的用户
- 对数据主权敏感、偏好本地优先存储方案的技术用户
常规风险
- 数据丢失:SQLite 文件损坏或误删将导致长期记忆不可逆丢失,建议定期备份
- Redis 暴露:若配置远程 Redis 且未启用 TLS/认证,存在中间人攻击和数据泄露风险
- 路径遍历:
index命令若未对<path>做严格校验,可能意外索引敏感系统文件 - 依赖漂移:Python 依赖通过 pip 安装,需锁定版本以防止供应链攻击