核心用法
Ultimate Unified Memory System 是一个面向 OpenClaw Agent 的生物启发式记忆系统,采用速度优先的六层架构设计。用户通过 python3 cli.py 命令行工具完成所有操作:
记忆写入:add 命令支持自动重要性检测、情绪标签(8种情绪)、价值追踪(6类奖励);kg add 构建原子化知识图谱。
智能检索:search 默认启用混合模式,按 Ultra-Hot → Hot Cache → Compiled → Mem0 → Parallel Tiers 的优先级链执行,平均响应 ~5ms。支持 --fast(仅缓存)和 --full(全层级)模式切换。
神经科学组件:Hippocampus 计算重要性权重,Amygdala 处理情绪维度(valence/arousal/connection/curiosity/energy),VTA 评估动机驱动,三者的加权融合决定记忆排序。
持续优化:improve 系列命令记录错误、修正和最佳实践;vestige 集成 FSRS-6 间隔重复算法,模拟人脑自然遗忘曲线。
显著优点
- 极致速度:Ultra-Hot 字典(0.1ms)、Redis 热缓存(1ms)、Mem0 首层命中(22ms)、并行查询架构,综合平均 5ms
- 生物逼真:六层存储层级(HOT/WARM/TEMP/COLD/ARCHIVE/COLD-STORAGE)对应神经科学的记忆分级理论
- 零数据丢失:WAL(Write-Ahead Log)协议确保会话状态原子提交,崩溃后可恢复
- 智能自适应:情绪检测器自动识别 query 意图(偏好/错误/重要/近期),动态调整各层级权重
- 知识图谱:Git-Notes 结构化存储支持实体版本管理和事实溯源
- 全自动化:Cron 定时任务处理跨会话消息、平台帖子同步、日记生成,无需人工干预
潜在缺点与局限性
- 依赖复杂:完整功能需部署 ChromaDB、Ollama(bge-m3)、可选 Redis,本地搭建门槛较高
- Mem0 成本:云端事实提取需付费 API,本地模式功能受限
- 存储膨胀:DIARY 和 GIT-NOTES 层级无自动清理,长期运行需手动归档或磁盘监控
- 冷启动问题:新会话首次查询可能因缓存未命中而跌至 ~55ms
- 情绪检测开销:Emotional Detector 虽仅 0.5ms,但在高频短查询场景中累积不可忽视
适合人群
- 需要长程上下文保持的复杂 Agent 开发者(多轮对话、跨会话状态)
- 追求亚毫秒级响应的生产环境部署
- 研究神经计算模型或希望引入生物启发的 AI 架构师
- 需要自动知识沉淀的个人知识管理重度用户
常规风险
1. 隐私泄露:默认本地运行,但启用 Mem0/Supermemory 云备份后,敏感记忆数据将离开本地环境
2. 数据一致性:并行查询多层级时,若 WAL 缓冲区未及时刷盘,极端崩溃场景可能丢失最近 1-2 条记录
3. 模型依赖:情绪分析和语义搜索依赖 Ollama 本地模型,模型版本更迭可能影响结果稳定性
4. 权限风险:Cron 任务需写入用户 home 目录,多用户共享环境需严格隔离 ~/.openclaw/memory/ 权限
5. API 额度:云端功能(Mem0、Supermemory)存在调用频率限制,高并发场景需本地降级策略