OpenClaw Memory

会话优先的 OpenClaw 记忆管家,保持内存清洁、回忆精准、持久知识安全。

安装

概览

什么是OpenClaw Memory

OpenClaw Memory 是一款专为 OpenClaw 系统设计的会话优先记忆管理系统,其核心使命是确保重要知识在会话压缩(compaction)过程中不会丢失,同时保持上下文窗口的高效利用。该系统采用分层架构,将内存划分为三个逻辑层级:会话内存(RAM)、每日日志文件和长期记忆库(MEMORY.md),通过明确的写入规则和检索机制,实现知识的持久化与精准调用。与传统聊天机器人不同,OpenClaw Memory 不依赖易失性的会话状态来保存关键信息,而是将决策、偏好和事实主动“写盘”,从而构建一个稳定可靠的知识基座。 该系统的设计哲学强调“磁盘即真相,内存即便利”,主张通过结构化存储和智能检索来替代简单的记忆保留。它会在每次会话压缩前自动触发一次“预压缩刷新”流程,自动提取当前对话中的高价值内容,将其分类归档至对应的记忆文件中,避免人工干预的同时防止知识断层。所有写入长期记忆的内容均需遵循统一格式规范,并辅以唯一标识符和标签体系,以支持高效的语义搜索与精准引用。这种机制不仅提升了代理(agent)的连续工作能力,也显著降低了因上下文截断导致的信息遗忘风险。 从用户体验角度看,OpenClaw Memory 提供了清晰的操作指引和自然语言指令接口,例如“Store this as a durable decision.”或“Write this to today’s log.”,使人类用户能够轻松管理机器的记忆生命周期。系统严格禁止存储敏感凭证或原始聊天记录,并内置隐私过滤规则,确保数据安全合规。此外,默认策略倾向于保留而非删除历史记录,仅在确认知识有效性后才允许归档清理,体现了对信息价值的尊重与审慎态度。

核心功能特点

  1. 会话优先的记忆架构,区分短期会话内存与长期磁盘存储,保障关键知识在压缩后仍可恢复
  2. 三层记忆模型:会话内存(易失)、每日工作日志(临时记录)、长期记忆库(MEMORY.md,永久存档)
  3. 预压缩刷新机制,在每次会话结束时自动提取并固化高价值内容,无需人工介入
  4. 结构化记忆格式支持 ID 标记与标签分类(如 DEC/PREF/FACT/POLICY),便于精准检索
  5. 基于 memory_search 和 memory_get 的轻量级检索策略,控制上下文长度并提升准确性
  6. 严格的隐私保护规则,禁止存储密钥等敏感信息,自动忽略 标签内内容

适用场景

OpenClaw Memory 特别适用于需要跨多轮对话维持复杂任务状态的场景,例如长期项目协作、客户支持流程跟踪或研究型问题求解。在这些场景中,代理需反复参考先前做出的技术选型决策、用户明确声明的偏好设置或已验证的业务规则,而传统聊天界面极易因上下文重置造成信息丢失。借助 OpenClaw Memory,代理可在每次交互间隙将关键结论写入 MEMORY.md,并在后续对话中通过语义搜索快速调取,形成连贯的认知链条。 另一个典型应用场景是自动化工作流中的知识沉淀过程。当代理执行代码重构、配置变更或实验性操作时,系统会生成大量临时性工作痕迹。OpenClaw Memory 允许将这些操作细节记录到当日日志文件(memory/YYYY-MM-DD.md)中,作为调试依据或复盘资料;而真正具有普适意义的结论——如架构调整原因、性能优化策略或安全约束条件——则被提炼为结构化条目存入长期记忆库。这种分离式记录方式既满足了审计追踪需求,又避免了将无关噪音污染核心知识体系。 对于企业级 AI 代理部署而言,OpenClaw Memory 还承担着标准化记忆治理的责任。它强制要求所有代理遵循统一的记忆写入规范,杜绝随意复制粘贴聊天记录或假设信息会自动留存的问题。通过预设的反模式检测(anti-patterns)和隐私过滤器,系统有效防范了数据泄露风险,并确保记忆内容始终符合最小必要原则。无论是个人开发者调试复杂提示工程,还是团队协作维护多代理系统的一致性,该工具都能提供稳定、可预测且易于审计的记忆基础设施。