做夢（實驗性）

做夢（實驗性功能）

做夢是 memory-core 中的背景記憶整合系統。 它能協助 OpenClaw 將強大的短期訊號轉移至持久記憶，同時 保持過程的可解釋性與可審閱性。

做夢功能是 選用 (opt-in) 的，預設為停用。

做夢寫入的內容

做夢會保留兩種輸出：

• memory/.dreams/ 中的 機器狀態（回溯儲存、階段訊號、攝入檢查點、鎖定）。
• DREAMS.md（或現有的 dreams.md）中的 人類可讀輸出，以及 memory/dreaming/<phase>/YYYY-MM-DD.md 下的選用階段報告檔案。

長期晉升仍僅寫入 MEMORY.md。

階段模型

做夢使用三個協作階段：

階段	目的	持久寫入
輕度	排序並暫存最近的短期素材	否
深度	評分並提升持久候選項目	是 (MEMORY.md)
REM	反思主題和重複出現的想法	否

這些階段是內部實作細節，並非分開的「模式」 供使用者設定。

輕度階段

輕度階段會攝入最近的每日記憶訊號和回憶追蹤，對其進行去重， 並暫存候選行。

• 從短期回憶狀態、最近的每日記憶檔案以及可用的經過編輯的會話記錄中讀取。
• 當儲存包含內聯輸出時，會寫入受管理的 ## Light Sleep 區塊。
• 記錄強化訊號以供稍後的深度排名使用。
• 絕不寫入 MEMORY.md。

深度階段

深度階段決定什麼內容會成為長期記憶。

• 使用加權評分和閾值門檻來排列候選項目。
• 需要 minScore、minRecallCount 和 minUniqueQueries 通過。
• 在寫入之前，從即時的每日檔案中重新還原片段，因此會跳過過時/已刪除的片段。
• 將晉升的條目附加到 MEMORY.md。
• 將 ## Deep Sleep 摘要寫入 DREAMS.md，並選擇性寫入 memory/dreaming/deep/YYYY-MM-DD.md。

REM 階段

REM 階段提取模式和反思訊號。

• 根據最近的短期追蹤記錄，建立主題與反思摘要。
• 當儲存包含內聯輸出時，會寫入受管理的 ## REM Sleep 區塊。
• 記錄深度排名所使用的 REM 增強訊號。
• 絕不寫入 MEMORY.md。

會話記錄擷取

Dreaming 可以將經過編輯的會話記錄擷取到夢境語料庫中。當記錄可用時，它們會與每日記憶訊號和回憶痕跡一起被輸入到淺層階段。個人與敏感內容在擷取前會經過編輯。

夢境日記

Dreaming 也會在 DREAMS.md 中維護一份敘事性的 夢境日記。 在每個階段累積足夠的素材後，memory-core 會盡力運行一個背景子代理程式回合（使用預設的運行時模型），並附加一則簡短的日記條目。

此日記是供人類在 Dreams UI 中閱讀的，而非提升來源。

還有一個基於歷史記錄的回填通道用於審查和恢復工作：

• memory rem-harness --path ... --grounded 預覽來自歷史 YYYY-MM-DD.md 筆記的基礎日記輸出。
• memory rem-backfill --path ... 將可逆轉的基礎日記條目寫入 DREAMS.md。
• memory rem-backfill --path ... --stage-short-term 將基礎的持久候選項暫存到正常深層階段已經使用的同一個短期證據存儲中。
• memory rem-backfill --rollback 和 --rollback-short-term 會移除那些暫存的回填產物，而不會觸及普通的日記條目或即時短期回憶。

控制 UI 公開了相同的日記回填/重置流程，以便您在決定基礎候選項是否值得提升之前，先在 Dreams 場景中檢查結果。該場景也會顯示一個獨立的基礎通道，讓您可以看到哪些暫存的短期條目來自歷史重播，哪些提升項目是由基礎引導的，並且僅清除僅包含基礎的暫存條目，而不觸及普通的即時短期狀態。

深層排序訊號

深層排序使用六個加權基礎訊號加上階段增強：

訊號	權重	描述
頻率	0.24	該條目累積了多少短期訊號
相關性	0.30	該條目的平均檢索品質
查詢多樣性	0.15	顯示它的不同查詢/每日上下文
新近度	0.15	時間衰減的新鮮度分數
鞏固	0.10	多日重複強度
概念豐富度	0.06	片段/路徑的概念標籤密度

Light 和 REM 階段的命中會從 memory/.dreams/phase-signals.json 新增一個小幅的隨時間遞減的權重。

排程

啟用後，memory-core 會自動管理一個 cron 工作以執行完整的夢境掃描。每次掃描會按順序執行各個階段：light -> REM -> deep。

預設頻率行為：

設定	預設值
dreaming.frequency	0 3 * * *

快速開始

啟用夢境功能：

{
  "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 工作流程

使用 CLI 晉升以進行預覽或手動套用：

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

手動 memory promote 預設使用 deep-phase 閾值，除非使用 CLI 標誌覆寫。

解釋為什麼特定候選者會或不會晉升：

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

預覽 REM 反思、候選事實以及 deep 晉升輸出，而不寫入任何內容：

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

主要預設值

所有設定皆位於 plugins.entries.memory-core.config.dreaming 之下。

鍵	預設值
enabled	false
frequency	0 3 * * *

階段策略、閾值和儲存行為是內部實作細節（非使用者面向的設定）。

請參閱 Memory configuration reference 以取得完整的鍵列表。

Dreams UI

啟用後，Gateway 的 Dreams 分頁會顯示：

• 目前的夢境啟用狀態
• 階段層級的狀態與受管理的掃描工作是否存在
• 短期、已落實、訊號和今日晉升的計數
• 下一次排程執行的時間
• 一個獨立的已落實 Scene 頻道，用於已暫存的歷史重播項目
• 一個可展開的夢境日記閱讀器，後端由 doctor.memory.dreamDiary 支援

相關

• Memory
• Memory Search
• memory CLI
• Memory configuration reference