OpenClaw Memory

核心用法

OpenClaw Memory Librarian 是一款后台内存管理技能，专为长期运行的 AI 会话设计。其工作流程分为三步：读取当日日志 → 提炼关键信息写入月度期刊 → 删除 14 天前的原始日志。用户通过 cron 定时任务在凌晨自动执行，或手动触发完整周期或仅总结模式。

关键配置：必须先启用 sessionMemory 实验性功能，否则无法访问历史会话上下文。

显著优点

• Token 效率：用结构化摘要替代冗长原始对话，显著降低上下文窗口压力
• 信号提取：明确的噪声过滤规则（忽略问候、瞬时错误），保留决策、架构变更、安全相关修改
• 持久记忆：月度期刊格式清晰，支持快速检索历史决策与经验教训
• 自动化友好：提供标准 cron 配置，可与每日 /reset 命令配合实现"夜间清理、晨间焕新"

潜在缺点与局限

• 硬依赖实验性功能：sessionMemory 若被移除或变更 API，技能将失效
• 14 天窗口风险：原始日志删除后无法恢复，若摘要遗漏关键细节则永久丢失
• 无冲突处理：多会话同时写入同一期刊文件可能引发竞态条件（文档未提及锁机制）
• 摘要质量不可控：依赖模型自身的"信号提取"判断，可能出现过度压缩或保留噪声
• 无版本控制：删除的日志直接进入文件系统回收站或永久删除，无内置备份机制

适合人群

• 长期运行同一项目的开发者，需维护跨周/跨月的上下文连续性
• 高频使用 OpenClaw 且受限于上下文长度限制的专业用户
• 有自动化运维习惯、能接受"删除原始数据"换取效率的技术团队

常规风险

| 风险类型 | 说明 |

|---------|------|

| 数据丢失 | 自动删除机制若配置错误或摘要失败，可能导致重要对话永久消失 |

| 配置漂移 | `sessionMemory` 为实验性功能，未来版本可能不兼容 |

| 权限问题 | 需确保运行用户对 `memory/` 目录有读写删权限 |

| 时区/调度 | cron 配置依赖服务器时区，跨时区团队需额外注意 |

使用建议

建议在正式启用前手动运行「仅总结模式」一周，验证摘要质量符合预期后再开启自动删除。

核心用法

OpenClaw Memory Librarian 是一款面向 Agent 会话管理的背景任务型 skill，通过结构化提示词指导 Agent 执行记忆整理工作流。用户启用 sessionMemory 配置后，该 skill 可按需或定时运行：读取近期日志（memory/YYYY-MM-DD.md），提炼关键信息并归档至月度期刊（memory/journal/YYYY-MM.md），最后删除超过 14 天的原始日志释放上下文空间。

显著优点

1. 零代码安全风险：纯 Markdown 提示词实现，无可执行代码、无外部依赖、无网络请求，彻底杜绝传统软件供应链攻击向量。
2. Token 效率优化：将冗长原始对话压缩为结构化摘要（决策、变更、障碍、洞察），显著降低长期会话的上下文窗口占用。
3. 自动化运维友好：支持 Cron 定时触发，配合 /reset 命令可实现"夜间整理 + 晨间刷新"的无感内存管理。
4. 信号提取策略：内置噪声过滤规则（忽略问候/临时错误，保留架构决策、安全变更），避免信息过载。

潜在缺点与局限性

1. 配置门槛：必须手动启用实验性 sessionMemory 开关，配置错误将导致功能失效。
2. T3 来源限制：个人开发者维护，无组织背书，更新可持续性与长期支持存不确定性。
3. 依赖 Agent 执行力：功能完全依赖底层 Agent 对提示词的遵循程度，不同模型/版本的行为一致性未经验证。
4. 数据不可逆：14 天自动删除策略一旦执行无法恢复，误删风险由用户承担。

适合人群

• 高频使用 OpenClaw 进行长期项目开发的技术用户
• 受上下文长度限制困扰、需精细化 Token 管理的进阶玩家
• 偏好自动化工作流、能接受实验性功能的早期采用者

常规风险

• 配置依赖风险：未启用 sessionMemory 时静默失效，用户可能误以为功能正常运行。
• 提示词注入敏感：虽无代码执行，但若 Agent 被恶意引导，理论上可能篡改归档内容或删除策略。
• 版本漂移：SKILL.md 与 _meta.json 版本号不一致（1.2.0 vs 1.2.1），反映维护流程待规范。

综合评估

该 skill 是典型的"提示词工程"安全样本——用自然语言替代代码实现功能，在保留实用价值的同时将攻击面压缩至理论最小。对于能理解其配置要求的技术用户，是高效管理 Agent 记忆的经济之选；但对稳定性与商业支持有要求的场景，建议观望或自行 fork 维护。