English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

快速开始

Dreaming

Dreaming 是 memory-core 中的后台记忆巩固系统。它帮助 OpenClaw 将强烈的短期信号转入持久记忆，同时让过程保持可解释、可审查。

Dreaming 会写入什么

Dreaming 保留两类输出：

  • memory/.dreams/ 中的机器状态（召回存储、阶段信号、摄取检查点、锁）。
  • DREAMS.md（或现有的 dreams.md）中的人类可读输出，以及 memory/dreaming/<phase>/YYYY-MM-DD.md 下可选的阶段报告文件。

长期提升仍然只写入 MEMORY.md。

阶段模型

Dreaming 使用三个协作阶段：

阶段 目的 持久写入
Light 排序并暂存近期短期材料 否
Deep 评分并提升持久候选项 是（MEMORY.md）
REM 反思主题和反复出现的想法 否

这些阶段是内部实现细节，不是单独由用户配置的“模式”。

Light phase

Light 阶段摄取近期每日记忆信号和召回轨迹，对它们去重，并暂存候选行。

  • 从短期召回状态、近期每日记忆文件，以及可用时经过脱敏的会话转录中读取。
  • 当存储包含内联输出时，写入一个托管的 ## Light Sleep 块。
  • 记录强化信号，供之后的 Deep 排名使用。
  • 绝不写入 MEMORY.md。
Deep phase

Deep 阶段决定哪些内容会成为长期记忆。

  • 使用加权评分和阈值门控对候选项排名。
  • 要求 minScore、minRecallCount 和 minUniqueQueries 通过。
  • 写入前从实时每日文件中重新取回片段，因此会跳过陈旧或已删除的片段。
  • 将提升后的条目追加到 MEMORY.md。
  • 向 DREAMS.md 写入 ## Deep Sleep 摘要，并可选写入 memory/dreaming/deep/YYYY-MM-DD.md。
REM phase

REM 阶段提取模式和反思信号。

  • 基于近期短期轨迹构建主题和反思摘要。
  • 当存储包含内联输出时，写入一个托管的 ## REM Sleep 块。
  • 记录 Deep 排名使用的 REM 强化信号。
  • 绝不写入 MEMORY.md。

会话转录摄取

Dreaming 可以将经过脱敏的会话转录摄取到 Dreaming 语料库中。当转录可用时，它们会与每日记忆信号和召回轨迹一起送入 Light 阶段。个人内容和敏感内容会在摄取前脱敏。

Dream Diary

Dreaming 还会在 DREAMS.md 中保留一份叙事性的 Dream Diary。每个阶段积累了足够材料后，memory-core 会运行一次尽力而为的后台子智能体轮次，并追加一条简短的日记条目。除非配置了 dreaming.model，否则它使用默认运行时模型。如果配置的模型不可用，Dream Diary 会使用会话默认模型重试一次。

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

Backfill commands
  • memory rem-harness --path ... --grounded 从历史 YYYY-MM-DD.md 笔记预览有依据的日记输出。
  • memory rem-backfill --path ... 将可逆的有依据日记条目写入 DREAMS.md。
  • memory rem-backfill --path ... --stage-short-term 将有依据的持久候选项暂存到普通 Deep 阶段已经使用的同一个短期证据存储中。
  • memory rem-backfill --rollback 和 --rollback-short-term 移除这些已暂存的回填工件，而不触及普通日记条目或实时短期召回。

Control UI 暴露了相同的日记回填/重置流程，因此你可以在 Dreams 场景中检查结果，再决定这些有依据的候选项是否值得提升。该场景还显示一条独立的有依据通道，因此你可以看到哪些已暂存短期条目来自历史重放、哪些已提升项由有依据内容主导，并且只清除仅有依据的已暂存条目，而不触及普通实时短期状态。

Deep 排名信号

Deep 排名使用六个加权基础信号以及阶段强化：

信号 权重 描述
频率 0.24 该条目累积了多少短期信号
相关性 0.30 该条目的平均检索质量
查询多样性 0.15 使其浮现的不同查询/日期上下文
近期性 0.15 按时间衰减的新鲜度分数
巩固度 0.10 多日重复出现的强度
概念丰富度 0.06 片段/路径中的概念标签密度

Light 和 REM 阶段命中会从 memory/.dreams/phase-signals.json 添加一个较小的、按近期性衰减的提升。

调度

启用后，memory-core 会自动管理一个用于完整 Dreaming 扫描的 cron 作业。每次扫描按顺序运行阶段：Light → REM → Deep。

扫描包括主运行时工作区和任何已配置的 Agent 工作区，并按路径去重，因此子智能体工作区扇出不会排除主智能体的 DREAMS.md 和记忆状态。

默认节奏行为：

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

快速开始

启用 Dreaming

{
  "plugins": {
    "entries": {
      "memory-core": {
        "config": {
          "dreaming": {
            "enabled": true
          }
        }
      }
    }
  }
}

自定义扫描节奏

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

斜杠命令

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

CLI 工作流

提升预览 / 应用

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

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

解释提升

解释为什么某个特定候选项会或不会被提升：

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

REM harness 预览

预览 REM 反思、候选事实和 Deep 提升输出，而不写入任何内容：

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

关键默认值

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

enabledboolean

启用或禁用 Dreaming 扫描。

frequencystring

完整 Dreaming 扫描的 cron 节奏。

modelstring

可选的 Dream Diary 子智能体模型覆盖。同时设置子智能体 allowedModels 允许列表时，请使用规范的 provider/model 值。

Dreams UI

启用后，Gateway 网关 Dreams 标签页会显示：

  • 当前 Dreaming 启用状态
  • 阶段级 Status 和托管扫描存在状态
  • 短期、有依据、信号以及今日已提升计数
  • 下一次计划运行时间
  • 一条用于已暂存历史重放条目的独立有依据场景通道
  • 由 doctor.memory.dreamDiary 支撑的可展开 Dream Diary 阅读器

Dreaming 从不运行：Status 显示被阻止

如果 openclaw memory status 报告 Dreaming status: blocked，说明托管 cron 存在，但默认智能体 Heartbeat 未触发。检查默认智能体是否启用了 Heartbeat，并且其目标不是 none，然后在下一个 Heartbeat 间隔后再次运行 openclaw memory status --deep。

相关