Memory

​

记忆

OpenClaw 记忆是 代理工作区中的纯 Markdown。文件是 事实来源；模型仅“记住”写入磁盘的内容。

记忆搜索工具由活动的记忆插件提供（默认为： memory-core）。使用 plugins.slots.memory = "none" 禁用记忆插件。

​

Memory files (Markdown)

默认工作区布局使用两层内存：

• memory/YYYY-MM-DD.md
  • 每日日志（仅追加）。
  • 在会话开始时读取今天 + 昨天的记录。
• MEMORY.md（可选）
  • 精选长期记忆。
  • 如果工作区根目录下同时存在 MEMORY.md 和 memory.md，OpenClaw 会加载两者（通过 realpath 去重，因此指向同一文件的符号链接不会被重复注入）。
  • 仅在主私有会话中加载（切勿在群组上下文中加载）。

这些文件位于工作区之下（agents.defaults.workspace，默认为 ~/.openclaw/workspace）。有关完整布局，请参阅 Agent workspace。

​

Memory 工具

OpenClaw 针对这些 Markdown 文件提供了两个面向模型的工具：

• memory_search — 对索引片段进行语义召回。
• memory_get — 针对特定 Markdown 文件/行范围进行定向读取。

memory_get 现在在文件不存在时能够优雅降级（例如，首次写入之前的今日日志）。内置管理器和 QMD 后端均返回 { text: "", path } 而非抛出 ENOENT，因此模型可以处理“尚未记录任何内容”的情况，并继续其工作流程，而无需将工具调用包裹在 try/catch 逻辑中。

​

何时写入 Memory

• 决策、偏好和持久性事实存入 MEMORY.md。
• 日常笔记和运行上下文存入 memory/YYYY-MM-DD.md。
• 如果有人说“记住这个”，请将其写下来（不要仅保留在 RAM 中）。
• 该领域仍在不断发展。提醒模型存储记忆会有所帮助；它知道该怎么做。
• 如果您希望某些信息被保留，请要求机器人将其写入 memory。

​

自动 Memory 刷新（预压缩 ping）

当会话接近自动压缩时，OpenClaw 会触发一次静默的、智能体的轮次，提醒模型在上下文被压缩之前写入持久性 Memory。默认提示词明确说明模型可能会回复，但通常 NO_REPLY 是正确的响应，因此用户永远不会看到此轮次。

这由 agents.defaults.compaction.memoryFlush 控制：

{
  agents: {
    defaults: {
      compaction: {
        reserveTokensFloor: 20000,
        memoryFlush: {
          enabled: true,
          softThresholdTokens: 4000,
          systemPrompt: "Session nearing compaction. Store durable memories now.",
          prompt: "Write any lasting notes to memory/YYYY-MM-DD.md; reply with NO_REPLY if nothing to store.",
        },
      },
    },
  },
}

详细信息：

• 软阈值：当会话 token 估算值超过 contextWindow - reserveTokensFloor - softThresholdTokens 时触发刷新。
• 默认静默：提示词包含 NO_REPLY，因此不会传递任何内容。
• 两个提示词：一个用户提示词加上一个系统提示词，用于追加提醒。
• 每个压缩周期执行一次清理（在 sessions.json 中跟踪）。
• 工作区必须可写：如果会话在 workspaceAccess: "ro" 或 "none" 中以沙箱隔离方式运行，则跳过清理。

有关完整的压缩生命周期，请参阅 会话管理 + 压缩。

​

向量记忆搜索

OpenClaw 可以在 MEMORY.md 和 memory/*.md 上构建小型向量索引，以便 语义查询即使在措辞不同的情况下也能找到相关笔记。混合搜索 （BM25 + 向量）可用于将语义匹配与精确关键字 查找相结合。

记忆搜索支持多个嵌入提供商（OpenAI、Gemini、Voyage、 Mistral、Ollama 和本地 GGUF 模型）、用于高级检索的可选 QMD 附属后端，以及 MMR 多样性重排序 和时间衰减等后处理功能。

有关完整的配置参考——包括嵌入提供商设置、QMD 后端、混合搜索调整、多模态记忆和所有配置选项——请参阅 记忆配置参考。

---

本页面源自 openclaw/openclaw，由 BeaversLab 翻译，遵循 MIT 协议 发布。