核心用法
memU-lite 是基于 Markdown + OpenClaw 原生工具实现的轻量级结构化记忆系统,灵感源自 memU 但去除所有外部依赖。采用三层架构设计:顶层 MEMORY.md 作为概览索引,中间层 items/ 按五类(preferences/knowledge/relationships/tasks/skills)存储原子化记忆单元,底层 raw/ 保留原始对话记录。
安装与初始化:支持 ClawHub 一键安装或手动克隆,通过 init.sh 脚本自动创建目录结构。记忆文件采用规范化的 YAML-like 前置元数据格式,包含类型、来源、日期、置信度、标签等字段,便于机器解析。
创建与检索:提供 memu-add.sh 交互式工具自动生成 ID 并更新索引;检索支持 MEMORY.md 快速概览、memory_search 语义搜索、memory_get 精确读取三种模式。配套 memu-tags.sh 生成标签索引,memu-backup.sh 实现备份恢复。
显著优点
零部署成本:纯文件系统实现,无需 Postgres、向量数据库或 API 密钥,降低中小企业和个人开发者准入门槛。
结构清晰可审计:五分类体系(偏好/知识/关系/任务/技能)+ 标签双索引,比简单 key-value 记忆更具语义表达能力;Markdown 格式人类可读,便于手动修正和版本控制。
迁移友好:目录结构与 memU 完全兼容,未来可平滑升级至完整版,避免重复建设。
自动化工具链:新增 memu-add/search/backup/tags/clean 五件套脚本,覆盖日常运维 90% 场景,减少人工维护负担。
潜在缺点与局限
被动依赖 AI:无自动提取和后台预判能力,记忆质量完全取决于 AI 主动记录意识,存在遗漏风险。
检索能力受限:无原生向量索引,语义搜索依赖 OpenClaw memory_search 工具实现,大规模数据下性能与召回率不确定。
无分布式能力:单用户本地文件存储,不支持多 Agent 共享、实时同步或高并发写入。
Token 压缩不可控:70%+ 压缩率为 memU 专属优化,lite 版依赖模型上下文管理,无硬约束。
适合人群
- 个人开发者构建专属 Agent,追求极简部署
- 中小规模项目(<10k 记忆条目)需结构化长期记忆
- 团队原型验证阶段,快速验证记忆增强 Agent 效果
- 计划未来迁移至完整 memU 的过渡用户
常规风险
1. 数据丢失风险:本地文件无自动容灾,需配合 memu-backup.sh 定期备份
2. 隐私泄露风险:记忆以明文 Markdown 存储,共享工作区时需注意权限隔离
3. ID 冲突风险:并发写入场景下手动编号可能产生重复,建议接入文件锁或改用 UUID
4. 过期记忆堆积:未运行定期 clean 脚本可能导致活跃记忆膨胀,检索效率下降