跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Dreaming 是 memory-core 中的背景記憶整合系統。它協助 OpenClaw 將強烈的短期訊號移入持久記憶，同時讓流程保持可解釋且可審查。
Dreaming 是選擇啟用，預設為停用。

​
Dreaming 寫入的內容

Dreaming 保留兩種輸出：
  • 機器狀態位於 memory/.dreams/（召回儲存、階段訊號、擷取檢查點、鎖定）。
  • 人類可讀輸出位於 DREAMS.md（或既有的 dreams.md），以及 memory/dreaming/<phase>/YYYY-MM-DD.md 下的選用階段報告檔案。
長期提升仍然只會寫入 MEMORY.md。

​
階段模型

Dreaming 使用三個協作階段：
階段目的持久寫入
Light排序並暫存近期短期素材否
Deep評分並提升持久候選項目是（MEMORY.md）
REM反思主題與反覆出現的想法否
這些階段是內部實作細節，不是分開由使用者設定的「模式」。
Light 階段會擷取近期每日記憶訊號與召回軌跡、進行去重，並暫存候選行。
  • 從短期召回狀態、近期每日記憶檔案，以及可用時已遮蔽的工作階段轉錄讀取。
  • 當儲存包含內嵌輸出時，寫入受管理的 ## Light Sleep 區塊。
  • 記錄強化訊號，供後續 Deep 排名使用。
  • 絕不寫入 MEMORY.md。
Deep 階段決定哪些內容會成為長期記憶。
  • 使用加權評分與門檻閘門排序候選項目。
  • 必須通過 minScore、minRecallCount 和 minUniqueQueries。
  • 寫入前會從即時每日檔案重新補水片段，因此會略過過時或已刪除的片段。
  • 將已提升的項目附加到 MEMORY.md。
  • 將 ## Deep Sleep 摘要寫入 DREAMS.md，並可選擇寫入 memory/dreaming/deep/YYYY-MM-DD.md。
REM 階段會擷取模式與反思訊號。
  • 從近期短期軌跡建立主題與反思摘要。
  • 當儲存包含內嵌輸出時，寫入受管理的 ## REM Sleep 區塊。
  • 記錄 REM 強化訊號，供 Deep 排名使用。
  • 絕不寫入 MEMORY.md。

​
工作階段轉錄擷取

Dreaming 可以將已遮蔽的工作階段轉錄擷取到 Dreaming 語料庫中。當轉錄可用時，它們會和每日記憶訊號與召回軌跡一起送入 Light 階段。個人與敏感內容會在擷取前先遮蔽。

​
夢境日記

Dreaming 也會在 DREAMS.md 中保留敘事性的夢境日記。每個階段有足夠素材後，memory-core 會以最佳努力方式執行背景子代理回合，並附加一則簡短日記項目。除非設定了 dreaming.model，否則會使用預設執行階段模型。如果設定的模型無法使用，夢境日記會使用工作階段預設模型重試一次。
這份日記供人類在 Dreams UI 中閱讀，不是提升來源。Dreaming 產生的日記/報告成品會排除在短期提升之外。只有有依據的記憶片段才有資格提升到 MEMORY.md。
另外也有一條有依據的歷史回填通道，可用於審查與復原工作：
  • 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 會自動管理一個 Cron 工作，用於完整的 Dreaming 掃描。每次掃描會依序執行階段：Light → REM → Deep。 掃描會包含主要執行階段工作區，以及任何已設定的代理工作區，並依路徑去重，因此子代理工作區展開不會排除主代理的 DREAMS.md 與記憶狀態。 預設節奏行為：
設定預設
dreaming.frequency0 3 * * *
dreaming.model預設模型

​
快速開始

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

​
斜線命令

/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 旗標覆寫。

​
主要預設值

所有設定都位於 plugins.entries.memory-core.config.dreaming 之下。
​
enabled
boolean
預設值:"false"
啟用或停用 Dreaming 掃描。
​
frequency
string
預設值:"0 3 * * *"
完整 Dreaming 掃描的 Cron 節奏。
​
model
string
選用的夢境日記子代理模型覆寫。當同時設定子代理 allowedModels 允許清單時，請使用標準的 provider/model 值。
dreaming.model 需要 plugins.entries.memory-core.subagent.allowModelOverride: true。若要限制它，也請設定 plugins.entries.memory-core.subagent.allowedModels。信任或允許清單失敗會保持可見，而不是靜默退回；重試只涵蓋模型無法使用的錯誤。
階段政策、門檻與儲存行為是內部實作細節（不是面向使用者的設定）。完整鍵清單請參閱記憶設定參考。

​
Dreams UI

啟用時，Gateway Dreams 分頁會顯示：
  • 目前 Dreaming 啟用狀態
  • 階段層級狀態與受管理掃描是否存在
  • 短期、有依據、訊號與今日已提升計數
  • 下一次排程執行時間
  • 用於已暫存歷史重播項目的獨立有依據場景通道
  • 由 doctor.memory.dreamDiary 支援的可展開夢境日記閱讀器

​
Dreaming 從未執行：狀態顯示 blocked

如果 openclaw memory status 回報 Dreaming status: blocked，表示受管理 Cron 存在，但預設代理 Heartbeat 未觸發。請確認預設代理已啟用 Heartbeat，且其目標不是 none，然後在下一個 Heartbeat 間隔後再次執行 openclaw memory status --deep。

​
相關