跳转至

Dreaming

Dreaming 是 memory-core 中的后台记忆整合系统。它将强短期信号移入持久记忆,同时保持流程可解释且可审查。

Note

Dreaming 默认启用。设置 plugins.entries.memory-core.config.dreaming.enabled: false 可将其禁用。 禁用的 Dreaming 不会检查心跳系统事件队列。

当 cron 调度器被禁用(cron.enabled: false 或 OPENCLAW_SKIP_CRON=1)时,Dreaming 会延迟自动任务创建和更新,同时 保留现有任务。启动时清理历史 Dreaming 产物会在运行前等待每个 agent 的待处理数据库准备,包括 重启或升级后的托管后台清理。数据库准备失败会附带修复指导进行报告。如果准备后某个 agent 数据库仍不存在, 清理会完成而不创建它;并发首次创建不算清理失败。 现有数据库在清理期间仍受保护,不会被替换。 显式禁用 Dreaming 会移除活动 cron 存储中携带 其规范声明键的任务。

Dreaming 写入的内容

  • 机器状态 位于 SQLite 支持的插件状态中(召回存储、阶段信号、摄取检查点、锁)。
  • 重写前镜像 位于 SQLite 支持的插件状态中,在已接受的 MEMORY.md 重写之前。
  • 人类可读输出 位于 DREAMS.md(或现有的 dreams.md)以及 memory/dreaming/<phase>/YYYY-MM-DD.md 下的可选阶段报告文件中。

内置 SQLite 存储仅读取所选工作区的状态用于查找 和清理。其他工作区中的损坏 JSON 不会阻止这些操作; 所选工作区中活动记录里的损坏 JSON 仍会报告存储错误。

长期提升仍只写入 MEMORY.md。 深度报告总结排名候选项未被提升的原因,使用按拒绝类别统计的数量,而不复制被拒绝的片段或源标识符。 这些数量涵盖达到提升阶段的候选项;它们不描述 在排名期间被排除的条目。在最终 应用检查期间发生变化的候选项会保留一个通用变更原因,而不是推断出的原因。 空扫描会在插件状态中记录完成,而不创建记忆或 Dreaming 文件,因此不会完成新工作区的首次运行设置。 现有每日笔记仍可以接收托管的阶段块更新。 每个新提升的条目都会携带从候选项派生的尾部召回元数据:最多三个概念标签,位于 <!-- trigger: phrase one, phrase two --> 中,以及一个从 1 到 10 的有界 <!-- importance: N --> 值。整合会逐字节保留 现有注释条目,除非它明确合并或 取代它们。

阶段模型

Dreaming 每次扫描按顺序运行三个协作阶段:light -> REM -> deep。这些是内部实现阶段,不是单独的用户配置模式。

阶段 目的 持久化写入
Light 整理并暂存近期短期材料 否
REM 反思主题和反复出现的想法 否
Deep 对持久候选项进行评分并提升 是(MEMORY.md)
Light 阶段
  • 读取近期短期召回状态、每日记忆文件,以及在可用时读取脱敏后的会话转录。
  • 对信号去重并暂存候选行。
  • 当存储包含内联输出时,写入托管的 ## Light Sleep 块。
  • 记录用于后续深度排名的强化信号。
  • 从不写入 MEMORY.md。
REM 阶段
  • 从近期短期痕迹构建主题和反思摘要。
  • 当存储包含内联输出时,写入托管的 ## REM Sleep 块。
  • 记录用于深度排名的 REM 强化信号。
  • 从不写入 MEMORY.md。
Deep 阶段
  • 使用加权评分和阈值门槛对候选项进行排名(minScore、minRecallCount、minUniqueQueries 必须全部通过)。
  • 在写入前从活动每日文件中重新水合片段,因此过期/已删除的片段会被跳过。
  • 将通过门槛的 owner 和 agent 派生候选项传递给一个无工具补全,该补全会针对当前 MEMORY.md 选择新增、合并和取代。
  • 从经过验证的源证据组合 MEMORY.md,在先前条目丢失限制和 bootstrap 预算内保留无关条目和候选项源引用。
  • 当模型不可用或重写未通过验证时,回退到先前的仅追加提升路径。
  • 将 ## Deep Sleep 摘要写入 DREAMS.md,并可选写入 memory/dreaming/deep/YYYY-MM-DD.md。

会话转录摄取

Dreaming 可以将脱敏后的会话转录摄取到 Dreaming 语料库中。只有交互式会话符合条件。Cron、heartbeat、subagent 和未知会话不会进入持久候选项摄取。个人和敏感内容在摄取前会被脱敏,运行时标记的召回上下文会被移除,因此召回的片段不会再次作为新记忆被学习。

两个操作员控制项会将会话排除在自动摄取之外,每项都有记录的原因:记忆准入策略 匹配保留的 hook-source、channel 或 chat-type 元数据,而 memory forget 将选定的会话 ID 记录为 forgotten,用于未来扫描。策略更改不会删除现有候选项,也不会阻止直接文件写入。手动会话回填在 preview、REM 和 apply 模式下应用这两个控制项,并在暂存候选项时保留源会话来源。

整合安全性

确定性的分数、召回次数和查询多样性阈值仍然 是候选项门槛。整合仅在这些门槛通过后运行。

在构建整合 prompt 之前,memory-core 会移除索引来源为 untrusted 或 system 的候选项。这是一个结构性 污染门槛,而不是分数惩罚。符合条件的候选项包括其来源、 会话类型、观察时间、可选的取代键以及每日笔记 源引用。

模型返回操作决策,而不是替换性记忆文本。记忆写入器使用每个候选项的有界、带来源条目,将这些决策应用到现有文件。被接受的改写或追加压缩必须:

  • 在 phases.deep.maxPriorEntryLossFraction 内保留先前条目
  • 包含每个已提升候选项的 Source: path#Lx-Ly 引用
  • 保持在 MEMORY.md 引导安全文件预算内
  • 解析为预期的结构化响应

在文件更改之前,先前的 MEMORY.md 会存储在基于 SQLite 的插件状态中。DREAMS.md 会接收新增、合并和被取代的计数,以及简短的 diff 风格高亮。这使得每次改写都可审查,而不会将梦境日记变成提升来源。

后台整合受睡眠时计算启发(arXiv:2504.13171)。来源与反思边界遵循生成式智能体研究中关于持久记忆的框架。

梦境日记

梦境功能在 DREAMS.md 中维护一个叙事式梦境日记。每次包含有用材料的扫描都会将其 Light、REM 和成功提升的 Deep 输入合并为一条简短日记条目,即使没有内容符合持久提升条件也是如此。无工具的后台完成使用工作区代理的默认模型,除非配置了 dreaming.model。如果配置的模型不可用,日记运行会使用该代理的默认模型重试一次。信任或允许列表失败不会重试。

日记和整合完成使用全新上下文,不保留会话,也不发送聊天回复。失败或空的日记生成会写入本地回退条目并报告降级结果,因此缺失的模型输出会留下可见痕迹。

日记生成使用现有的代理运行预算 agents.defaults.timeoutSeconds,而不是单独的一分钟截止时间。它继承与代理运行相同的 48 小时默认值和计时器安全的无限设置。所选提供方的 models.providers.<provider>.timeoutSeconds 仍然限制其模型请求,因此请确保两个预算都足够长,以支持缓慢的本地推理。

Note

日记用于在 Dreams UI 中供人类阅读,而不是提升来源。日记/报告产物被排除在短期提升之外;只有有依据的记忆片段才有资格提升到 MEMORY.md。

还有一个用于审查和恢复工作的有依据历史回填通道:

回填命令
  • openclaw memory rem-harness --path <path> --grounded 预览来自历史 YYYY-MM-DD.md 笔记的有依据日记输出。
  • openclaw memory rem-backfill --path <path> 将可逆的有依据日记条目写入 DREAMS.md。
  • openclaw memory rem-backfill --path <path> --stage-short-term 将有依据的持久候选项暂存到正常深度阶段使用的同一短期证据存储中。
  • openclaw memory rem-backfill --rollback 和 --rollback-short-term 移除这些已暂存的回填产物,而不影响普通日记条目或实时短期召回。
  • openclaw memory session-backfill --agent <id> 预览代理保留会话历史中的可信候选项,从最旧的未处理日期开始。
  • openclaw memory session-backfill --agent <id> --apply 通过正常短期存储暂存这些候选项,并写入可逆日记块,而不更改 MEMORY.md 或 USER.md。
  • openclaw memory session-backfill --agent <id> --rem 按天向 DREAMS.md 写入确定性的有依据预览,而不暂存候选项或调用模型。
  • openclaw memory session-backfill --agent <id> --rollback 清除共享的有依据回填候选项和日记块,包括由 rem-backfill 创建的产物。

会话回填使用规范的保留转录标识,包括跨轮换保留的会话。消息按配置的梦境时区分桶,并共享实时摄取所跟踪的消息哈希和信号上限。Apply 操作在一条命令中将有限批次排空至完成。Rollback 操作会移除生成的产物以及这些批次拥有的哈希和游标进度,从而允许再次暂存相同候选项。 通过 --archive-files 提供的外部文件会被保守处理。其嵌入的所有权字段由调用方控制,因此仍不可信;在没有经过身份验证的来源契约的情况下,它们不能进入短期暂存。工具输出、网页内容以及非所有者轮次同样被排除在规范会话路径之外。

Control UI 在代理的 Memory 选项卡(Agents 页面)上公开相同的日记回填/重置流程,以便你在决定有依据候选项是否值得提升之前,在梦境场景中检查结果。一个独立的有依据 Scene 通道显示哪些已暂存的短期条目来自历史重放,哪些已提升项由有依据主导,并允许你仅清除仅有依据的已暂存条目,而不影响实时短期状态。

深度排序信号

深度排序使用六个加权基础信号,外加阶段强化:

信号 权重 描述
相关性 0.30 该条目的平均检索质量
频率 0.24 该条目累积了多少短期信号
查询多样性 0.15 使其浮现的不同交互式召回查询
新近性 0.15 时间衰减的新鲜度分数
整合 0.10 多日重复强度
概念丰富度 0.06 来自片段/路径的概念标签密度

记录在基于 SQLite 的插件状态中的 Light 和 REM 阶段命中会添加一个小的新近性衰减增强。

调度

启用后,memory-core 会自动管理一个用于完整梦境扫描的 cron 作业,并在主运行时工作区和任何已配置的代理工作区之间去重,以便子代理工作区扇出不会排除主代理的 DREAMS.md 和记忆状态。

Plugin 重新加载会保留受管计划。前一个实例会停止其后台回调,并在其替代实例接管之前完成待处理的日记发布,因此定时扫描可以在不重启 Gateway 的情况下继续。

运行时协调仅负责声明为 memory-core:memory-dreaming-promotion 的作业。它对已列出的活动作业使用 Doctor 的只读分类器来报告历史行。已识别的旧版或阶段作业需要在运行时创建或更新受管作业之前进行 Doctor 修复。具有已退役负载格式的已声明作业也需要 Doctor 修复。带有历史标签和人工编写负载的作业保持不变,并产生人工审查警告;它们不会阻止创建或更新已声明的 Dreaming 作业。禁用 Dreaming 仍然只移除显式声明的作业,并报告任何剩余的历史工作。

运行 openclaw doctor --fix 以采用通过所有权元数据和已知生成负载识别的历史 Dreaming 作业。自定义 Prompt 上的历史标签会产生人工审查警告。Doctor 首先保存经过验证的 SQLite 备份,然后在每个持久化 cron 存储分区中采用一个统一作业,且不更改其 ID、顺序或运行时状态。如果仅存在旧版 light/REM 作业,它会就地提升最旧的阶段作业。仅在该分区存在有效幸存作业后,它才会移除已识别的重复项。当 Dreaming 被禁用时,Doctor 会改为退役已识别的受管行。具有不同声明键的作业以及无关的操作员作业保持不变;格式错误或含义模糊的行会产生修复警告并保留在原位。

Dreaming 完成项与 Skill Workshop 及其他插件完成项共享后台工作预算:总共最多三次运行,其中最多三次可供 memory-core 使用。扫描协调器在等待阶段工作时不会占用完成槽位。系统繁忙度会在 background 行中将这些运行合并显示。

显式多智能体集群需要为此作业指定一个常驻系统所有者。如果日志报告 Agent-less cron job has no resolvable owner,请选择一个现有智能体来拥有该扫描。例如,如果该智能体是 ops:

openclaw config set agents.defaults.systemAgent.agentId ops

这会选定执行所有者;它不会更改任何智能体的工作区,也不会将扫描限制为该智能体的记忆。单智能体安装会自动解析其所有者。

设置 默认值
dreaming.frequency 0 3 * * *
dreaming.model 默认模型

快速开始

{
  "plugins": {
    "entries": {
      "memory-core": {
        "config": {
          "dreaming": {
            "enabled": false
          }
        }
      }
    }
  }
}
{
  "plugins": {
    "entries": {
      "memory-core": {
        "config": {
          "dreaming": {
            "enabled": true,
            "timezone": "America/Los_Angeles",
            "frequency": "0 */6 * * *"
          }
        }
      }
    }
  }
}

斜杠命令

/dreaming status
/dreaming on
/dreaming off
/dreaming help

/dreaming on 和 /dreaming off 要求频道调用者具有所有者状态,或 Gateway 客户端具有 operator.admin。/dreaming status 和 /dreaming help 是只读的。

CLI 工作流

openclaw memory promote
openclaw memory promote --apply
openclaw memory promote --limit 5
openclaw memory status --deep

手动 memory promote 默认使用深度阶段阈值,除非通过 CLI 标志覆盖。

解释某个特定候选项会或不会晋升的原因:

openclaw memory promote-explain "router vlan"
openclaw memory promote-explain "router vlan" --json

预览 REM 反思、候选事实以及深度晋升输出,且不写入任何内容:

openclaw memory rem-harness
openclaw memory rem-harness --json

关键默认值

所有设置都位于 plugins.entries.memory-core.config.dreaming 下。

enabled 布尔 (路径)
启用或禁用 Dreaming 扫描。
phases.deep.maxPriorEntryLossFraction 数字 (路径) 默认值:0.25
当整合重写或追加压缩移除了超过先前条目该比例的内容时,拒绝该操作。追加压缩仅移除完整的机器生成晋升部分。
frequency 字符串 (路径) 默认值:0 3 * * *
完整 Dreaming 扫描的 Cron 周期。
model 字符串 (路径)
可选的 Dream Diary 完成模型覆盖。当同时设置子智能体 allowedModels 允许列表时,请使用规范的 provider/model 值。
phases.deep.maxPromotedSnippetTokens 数字 (路径) 默认值:160
从每个晋升到 MEMORY.md 的短期回忆片段中保留的最大估算 Token 数。排名来源仍可见。

Warning

dreaming.model 需要 plugins.entries.memory-core.subagent.allowModelOverride: true。若要限制它,请同时设置 plugins.entries.memory-core.subagent.allowedModels。自动重试仅覆盖模型不可用错误;信任或允许列表失败会产生回退日记跟踪和降级结果,而不是静默切换模型。

Note

大多数阶段策略、阈值和存储行为都是内部实现细节。有关完整的键列表,请参阅内存配置参考。

Dreams UI

启用后,Gateway 的 Dreams 选项卡显示:

  • 当前 Dreaming 启用状态
  • 阶段级状态和受管扫描存在性
  • 短期、接地、信号和今日晋升计数
  • 下次计划运行时间
  • 一个独立的接地 Scene 通道,用于分阶段的历史重放条目
  • 一个可展开的 Dream Diary 阅读器,由 doctor.memory.dreamDiary 支持

当启用捆绑的 memory-wiki 插件时, Diary 视图会在 Dreams 旁边增加两个子选项卡:

  • 导入的洞察:由外部历史导入(例如 openclaw wiki chatgpt import)呈现的聚类洞察,用于在它们中的任何一项晋升为持久记忆之前进行审核
  • 记忆 Wiki:记忆系统可以搜索和推理的已编译 wiki —— 综合、实体和概念页面(以及携带声明、未决问题或矛盾的来源和报告),包含每页计数、全库分解和内联页面预览

当 memory-wiki 关闭时,两个子选项卡都会显示启用提示。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw