核心用法
OpenClaw Memory Librarian 是一款后台内存管理技能,专为长期运行的 AI 会话设计。其工作流程分为三步:读取当日日志 → 提炼关键信息写入月度期刊 → 删除 14 天前的原始日志。用户通过 cron 定时任务在凌晨自动执行,或手动触发完整周期或仅总结模式。
关键配置:必须先启用 sessionMemory 实验性功能,否则无法访问历史会话上下文。
显著优点
- Token 效率:用结构化摘要替代冗长原始对话,显著降低上下文窗口压力
- 信号提取:明确的噪声过滤规则(忽略问候、瞬时错误),保留决策、架构变更、安全相关修改
- 持久记忆:月度期刊格式清晰,支持快速检索历史决策与经验教训
- 自动化友好:提供标准 cron 配置,可与每日
/reset命令配合实现"夜间清理、晨间焕新"
潜在缺点与局限
- 硬依赖实验性功能:
sessionMemory若被移除或变更 API,技能将失效 - 14 天窗口风险:原始日志删除后无法恢复,若摘要遗漏关键细节则永久丢失
- 无冲突处理:多会话同时写入同一期刊文件可能引发竞态条件(文档未提及锁机制)
- 摘要质量不可控:依赖模型自身的"信号提取"判断,可能出现过度压缩或保留噪声
- 无版本控制:删除的日志直接进入文件系统回收站或永久删除,无内置备份机制
适合人群
- 长期运行同一项目的开发者,需维护跨周/跨月的上下文连续性
- 高频使用 OpenClaw 且受限于上下文长度限制的专业用户
- 有自动化运维习惯、能接受"删除原始数据"换取效率的技术团队
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据丢失 | 自动删除机制若配置错误或摘要失败,可能导致重要对话永久消失 |
| 配置漂移 | `sessionMemory` 为实验性功能,未来版本可能不兼容 |
| 权限问题 | 需确保运行用户对 `memory/` 目录有读写删权限 |
| 时区/调度 | cron 配置依赖服务器时区,跨时区团队需额外注意 |
使用建议
建议在正式启用前手动运行「仅总结模式」一周,验证摘要质量符合预期后再开启自动删除。