OpenClaw Memory

核心用法

openclaw-mem 是专为 OpenClaw 设计的会话优先内存管理技能，核心目标是让重要知识在会话压缩后依然存活，同时避免上下文窗口膨胀。

三层存储架构

1. Session Memory (RAM)：当前会话临时存储，自动压缩，不可靠长期留存
2. Daily Logs (memory/YYYY-MM-DD.md)：仅记录当日工作，类似工作日志
3. Long-Term Memory (MEMORY.md)：精选高价值知识，小体积、高信号、可检索

关键操作流程

• 写入规则：决策/偏好/不变量写入 MEMORY.md；临时工作写入当日日志
• 预压缩刷新：会话压缩前自动触发，将持久化知识写入磁盘，防止丢失
• 检索策略：memory_search → 筛选1-2条 → memory_get 精确提取，最小化上下文占用

显著优点

• 防知识丢失：利用预压缩钩子作为"存档点"，解决 LLM 会话截断痛点
• 上下文精简：分层设计确保只有高价值信息进入长期存储，避免 Token 浪费
• 检索效率：结构化 ID 前缀（DEC/PREF/FACT/POLICY）+ 标签系统，支持精准召回
• 隐私意识：内置规则禁止存储密钥、自动忽略 <private> 内容

潜在缺点与局限

• 依赖实验性功能：必须手动启用 sessionMemory 配置，非开箱即用
• 人工判断成本：需用户区分"持久知识"vs"临时记录"，规则执行依赖自律
• 无自动清理：默认不删除旧数据，长期可能累积大量日志（虽建议归档）
• 生态锁定：专为 OpenClaw 设计，无法迁移至其他 Agent 框架

适合人群

• 使用 OpenClaw 进行长期项目开发的开发者
• 需要跨会话保持决策记录和偏好设置的 AI 辅助工作流用户
• 对上下文窗口敏感、追求 Token 效率的高级用户

常规风险

• 配置遗漏风险：未启用 sessionMemory 时技能功能失效，静默失败
• 误分类风险：将临时信息写入 MEMORY.md 会导致长期记忆膨胀、检索噪声增加
• 隐私泄露风险：虽有规则，但用户主动违规存储敏感信息仍可能发生

核心用法

openclaw-mem 是一套为 OpenClaw 生态设计的会话优先内存管理方法论，而非可执行工具。其核心目标是解决大模型会话中"重要知识在会话压缩时丢失"的痛点。

三层记忆架构

1. Session Memory（RAM） — 当前对话的临时工作空间，自动压缩、检索友好但不可靠长期保存
2. Daily Logs（`memory/YYYY-MM-DD.md`） — 每日工作流水账，记录命令、编辑、临时阻塞事项
3. Long-Term Memory（`MEMORY.md`） — 经人工筛选的高信号知识库，存储决策、偏好、策略等持久信息

写入策略（关键决策规则）

• 下周仍成立的事实 → MEMORY.md
• 仅限今天有用的信息 → 当日日志
• 不确定时 → 先写日志，后续再晋升

预压缩刷新机制

OpenClaw 在会话压缩前触发静默提醒，此 skill 作为"存档点"自动将持久知识写入磁盘，防止丢失。

---

显著优点

1. 架构清晰：用物理存储隐喻（RAM vs Disk）化解抽象概念，降低认知负荷
2. 预防性设计：在数据丢失发生前介入，而非事后补救
3. 隐私优先：明确禁止存储密钥、密码，强制使用 <private> 标签隔离敏感信息
4. 纯文档安全：无可执行代码，零供应链攻击面，获得 S 级安全认证
5. 检索优化：提供 ID 前缀规范（DEC/PREF/FACT/POLICY）和精确检索策略（搜索→筛选→最小注入）

---

局限性与注意事项

1. 非自动化工具：仅为最佳实践指南，依赖用户/Agent 主动执行写入操作
2. 生态绑定：专为 OpenClaw 设计，其他平台（如原生 Claude、GPT）无直接适用性
3. T3 来源：个人开发者维护，无顶级开源基金会背书，需自行评估作者信誉
4. 无版本治理：未检测到开源许可证，知识产权状态不明确

---

适合人群

• 使用 OpenClaw 进行长期项目开发的开发者
• 需要跨会话保持项目决策、代码偏好、架构约定的技术团队
• 关注上下文窗口效率、希望减少重复沟通的高级用户

---

常规风险

| 风险类型 | 说明 | 缓解措施 |

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

| 误将临时信息写入长期记忆 | 导致 MEMORY.md 膨胀、信号稀释 | 遵循"先日志后晋升"原则 |

| 敏感信息泄露 | 用户可能意外粘贴密钥到非 private 区域 | 严格使用 `<private>` 标签，定期审计 |

| 过度依赖会话检索 | 未启用 `sessionMemory` 实验功能时检索失效 | 按文档配置 `clawdbot config` |

| 作者停止维护 | T3 来源无组织保障 | 锁定版本，关注社区 Fork |

---

综合评价

这是一个设计理念先于工程实现的 skill，其价值不在于代码复杂度，而在于提供了一套经过深思熟虑的"人机协作记忆协议"。对于需要与 AI 进行多轮、多会话深度协作的 OpenClaw 用户，遵循这些规范能显著降低信息丢失和重复沟通成本。纯文档形态使其成为安全敏感环境下的理想选择。