OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

会话与记忆

记忆概览

OpenClaw 通过在智能体的工作区（默认 ~/.openclaw/workspace）中写入纯 Markdown 文件来记住信息。模型只会记住保存到磁盘的内容；不存在隐藏状态。

工作原理

你的智能体有三个与记忆相关的文件：

  • MEMORY.md — 长期记忆。持久保存的事实、偏好和决定。在会话开始时加载。
  • memory/YYYY-MM-DD.md（或 memory/YYYY-MM-DD-<slug>.md）— 每日笔记。持续记录的上下文和观察结果。在不带额外说明的 /new 或 /reset 中，今天和昨天的日期笔记会自动加载；带别名的变体（例如内置 session-memory 钩子写入的变体）也会与仅含日期的文件一同加载。
  • DREAMS.md（可选）— 供人工审核的梦境日记和 Dreaming 扫描摘要，包括有事实依据的历史回填条目。

各类内容的存放位置

MEMORY.md 是精简且经过整理的层：包含应在会话开始时可用的持久事实、偏好、长期决定和简短摘要。它不是原始对话记录、每日日志或完整归档。

memory/YYYY-MM-DD.md 文件是工作层：包含详细的每日笔记、观察结果、会话摘要，以及之后可能仍有用的原始上下文。这些内容会编入索引，供 memory_search 和 memory_get 使用，但不会在每轮对话中注入引导提示词。

随着时间推移，智能体会将每日笔记中的有用内容提炼到 MEMORY.md 中，并移除过时的长期条目。生成的工作区指令和 Heartbeat 流程会定期执行此操作；无需为每个细节手动编辑 MEMORY.md。

如果 MEMORY.md 超出引导文件预算，OpenClaw 会完整保留磁盘上的文件，但截断注入上下文的副本。应将此视为一个信号：把详细内容移至 memory/*.md，仅在 MEMORY.md 中保留持久摘要；或者，如果愿意消耗更多提示词预算，则提高引导限制。使用 /context list、/context detail 或 openclaw doctor 可查看原始大小、注入大小和截断状态。

从编码助手导入

Control UI 可以从 Codex 和 Claude Code 导入现有的本地记忆。打开 Settings → Import Memory，选择目标智能体，检查检测到的文件，然后确认导入。OpenClaw 仅复制 Markdown 记忆：

  • Codex：位于 ~/.codex/memories（或 CODEX_HOME/memories）下的汇总 MEMORY.md 和 memory_summary.md 文件。不导入原始 rollout 和对话记录文件。
  • Claude Code：每个项目在 ~/.claude/projects/*/memory 下的自动记忆目录中的 Markdown 文件，以及存在时由用户配置的 autoMemoryDirectory。项目指令、会话、设置和凭据不属于这项仅导入记忆的操作。

导入的文件分别保存在所选智能体工作区内的 memory/imports/codex/ 和 memory/imports/claude-code/ 下。它们会编入索引，供 memory_search 使用，并可通过 memory_get 访问；它们不会合并到智能体的引导文件 MEMORY.md 中。源文件保持不变。

预览会标记目标冲突。启用 Replace existing imports 可替换这些文件；应用导入时会创建经过验证的导入前备份，并在迁移报告中保留被覆盖文件的逐项副本。

对操作有影响的记忆

大多数记忆都是普通 Markdown 笔记。有些记忆会影响智能体之后应该执行的操作；对于这些记忆，不仅要记录事实本身，还要记录何时可以安全地根据该笔记采取行动。

当笔记涉及以下内容时，应记录这一操作边界：

  • 审批或权限要求，
  • 临时限制，
  • 移交给另一个会话、线程或人员，
  • 失效条件，
  • 可安全操作的时机，
  • 来源或所有者的权限，
  • 避免执行某个看似诱人操作的指令。

一条有用的操作敏感型记忆会明确说明：

  • 哪些内容会改变未来的行为，
  • 它在何时或什么条件下适用，
  • 它何时失效，或什么条件会解锁操作，
  • 智能体应避免执行什么操作，
  • 来源或所有者是谁（如果这会影响信任或权限）。

记忆可以保留审批上下文，但不会强制执行策略。应使用 OpenClaw 的审批设置、沙箱隔离和定时任务来实施严格的操作控制。

示例：

md
API 迁移正在另一个会话中设计。后续轮次不应从此线程编辑 API 实现；在迁移计划确定之前，此处的发现仅可作为设计输入。

另一个示例：

md
来自不可信来源的报告需要经过审核才能推广。后续轮次应仅将其视为证据；在可信审核者确认内容之前，不要将其存储为持久记忆。

这并非每条记忆都必须遵循的模式；简单事实可以保持简洁。当丢失时机、权限、失效条件或可安全操作的上下文可能导致智能体日后执行错误操作时，应使用操作敏感型边界。

对于推断出的短期跟进事项，请使用跟进承诺。对于精确提醒、定时检查和重复工作，请使用定时任务。记忆仍可概述任一路径周围的持久上下文。

推断式跟进承诺

某些未来的跟进事项并非持久事实。如果你提到明天有一场面试，有用的记忆可能是“面试后询问情况”，而不是“将此内容永久存储在 MEMORY.md 中”。

跟进承诺是适用于这种情况的可选短期跟进记忆。OpenClaw 会在隐藏的后台轮次中推断这些记忆，将其限定在同一智能体和渠道中，并通过 Heartbeat 发送到期的问候。明确设置的提醒仍使用定时任务。

记忆工具

智能体有两个用于处理记忆的工具：

  • memory_search — 使用语义搜索查找相关笔记，即使措辞与原文不同也能找到。
  • memory_get — 读取特定的记忆文件或行范围。

这两个工具均由当前启用的记忆插件提供（默认：memory-core）。

记忆搜索

配置嵌入提供商后，memory_search 会使用混合搜索：将向量相似度（语义含义）与关键词匹配（ID 和代码符号等精确词语）结合使用。只需任一受支持提供商的 API key，即可直接使用此功能。

有关搜索工作方式、调优选项和提供商设置，请参阅记忆搜索。

记忆后端

内置（默认）

基于 SQLite。开箱即用，支持关键词搜索、向量相似度和混合搜索。无需额外依赖项。
QMD

本地优先的 sidecar，支持重排序、查询扩展，并能为工作区之外的目录编制索引。
Honcho

AI 原生的跨会话记忆，支持用户建模、语义搜索和多智能体感知。需安装插件。
LanceDB

由 LanceDB 支持的记忆，具有 OpenAI 兼容嵌入、自动回忆、自动捕获和本地 Ollama 嵌入支持。需安装插件。

知识 wiki 层

如果希望持久记忆更像经过维护的知识库，而不是原始笔记，请使用内置的 memory-wiki 插件。它将持久知识编译到 wiki 保险库中，提供确定性的页面结构、结构化声明和证据、矛盾与新鲜度跟踪、生成的仪表板、编译摘要，以及 wiki 原生工具（wiki_status、wiki_search、wiki_get、wiki_apply、wiki_lint）。

memory-wiki 不会取代当前启用的记忆插件；当前启用的记忆插件仍负责回忆、推广和 Dreaming。memory-wiki 会在其旁边添加一个富含来源信息的知识层。

Memory Wiki

将持久记忆编译到富含来源信息的 wiki 保险库中，支持声明、仪表板、桥接模式和适合 Obsidian 的工作流。

自动刷新记忆

在压缩汇总对话之前，OpenClaw 会运行一个静默轮次，提醒智能体将重要上下文保存到记忆文件。此功能默认启用；设置 agents.defaults.compaction.memoryFlush.enabled: false 可将其关闭。

若要让此维护轮次使用本地模型，请设置仅应用于记忆刷新轮次的精确覆盖项（它不会继承当前会话的模型回退链）：

json
{  "agents": {    "defaults": {      "compaction": {        "memoryFlush": {          "model": "ollama/qwen3:8b"        }      }    }  }}

Dreaming

Dreaming 是可选的后台记忆整合过程。它会收集短期回忆信号、为候选项评分，并且仅将符合条件的项目推广到长期记忆（MEMORY.md）：

  • 可选启用：默认禁用。
  • 定时执行：启用后，memory-core 会自动管理一个重复执行完整 Dreaming 扫描的 cron 作业。
  • 阈值控制：推广必须通过分数、回忆频率和查询多样性门槛。
  • 可审核：阶段摘要和日记条目会写入 DREAMS.md，供人工审核。

有关阶段行为、评分信号和梦境日记的详细信息，请参阅Dreaming。

有事实依据的回填和实时推广

Dreaming 系统有两个相关的审核路径：

  • 实时 Dreaming 使用 memory/.dreams/ 下的短期 Dreaming 存储；常规深度阶段会利用它来决定哪些内容应进入 MEMORY.md。
  • 有事实依据的回填 将历史 memory/YYYY-MM-DD.md 笔记作为独立的每日文件读取，并将结构化审核输出写入 DREAMS.md。

有事实依据的回填适用于重放较旧的笔记，并在不手动编辑 MEMORY.md 的情况下检查系统认定哪些内容具有持久价值。

bash
openclaw memory rem-backfill --path ./memory --stage-short-term

--stage-short-term 标志会将有事实依据的持久候选项暂存到常规深度阶段已经使用的同一个短期 Dreaming 存储中；它不会直接推广这些候选项。因此：

  • DREAMS.md 仍是供人工审核的界面。
  • 短期存储仍是面向机器的排序界面。
  • MEMORY.md 仍只由深度推广写入。

如需撤销某次重放且不影响普通日记条目或常规回忆状态：

bash
openclaw memory rem-backfill --rollbackopenclaw memory rem-backfill --rollback-short-term

CLI

bash
openclaw memory status          # 检查索引状态和提供商openclaw memory search "query"  # 从命令行搜索openclaw memory index --force   # 重建索引

延伸阅读

Was this useful?
On this page

On this page