Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw memory
管理語意記憶索引與搜尋。
由 Active Memory Plugin 提供（預設：memory-core；設定 plugins.slots.memory = "none" 可停用）。
相關：
- 記憶概念：Memory
- 記憶 wiki：Memory Wiki
- Wiki CLI：wiki
- Plugins：Plugins
範例
選項
memory status 和 memory index：
--agent <id>：限定於單一代理程式。若未指定，這些命令會針對每個已設定的代理程式執行；如果未設定代理程式清單，則會退回使用預設代理程式。--verbose：在探測與索引期間輸出詳細記錄。
memory status：
--deep：探測向量 + embedding 可用性。一般的memory status會保持快速，且不會執行即時 embedding ping。QMD 詞彙searchMode: "search"即使搭配--deep，也會略過語意向量探測與 embedding 維護。--index：如果儲存區是髒的，則執行重新索引（意味著--deep）。--fix：修復過期的回憶鎖定並正規化提升中繼資料。--json：列印 JSON 輸出。
memory status 顯示 Dreaming status: blocked，代表受管理的 dreaming cron 已啟用，但驅動它的 Heartbeat 未針對預設代理程式觸發。請參閱 Dreaming 永遠不會執行，了解兩個常見原因。
memory index：
--force：強制完整重新索引。
memory search：
- 查詢輸入：傳入位置參數
[query]或--query <text>。 - 如果兩者皆提供，會以
--query為準。 - 如果兩者皆未提供，命令會以錯誤結束。
--agent <id>：限定於單一代理程式（預設：預設代理程式）。--max-results <n>：限制傳回的結果數量。--min-score <n>：篩除低分相符項目。--json：列印 JSON 結果。
memory promote：
預覽並套用短期記憶提升。
--apply— 將提升寫入MEMORY.md（預設：僅預覽）。--limit <n>— 限制顯示的候選項目數量。--include-promoted— 包含先前週期中已提升的項目。
- 使用加權提升訊號（
frequency、relevance、query diversity、recency、consolidation、conceptual richness）對來自memory/YYYY-MM-DD.md的短期候選項目排序。 - 使用來自記憶回憶與每日擷取流程的短期訊號，加上 light/REM 階段強化訊號。
- 啟用 Dreaming 時，
memory-core會自動管理一個在背景執行完整掃描（light -> REM -> deep）的 cron 工作（不需要手動openclaw cron add）。 --agent <id>：限定於單一代理程式（預設：預設代理程式）。--limit <n>：要傳回/套用的最大候選項目數。--min-score <n>：最低加權提升分數。--min-recall-count <n>：候選項目所需的最低回憶次數。--min-unique-queries <n>：候選項目所需的最低相異查詢數。--apply：將選取的候選項目附加到MEMORY.md，並標記為已提升。--include-promoted：在輸出中包含已提升的候選項目。--json：列印 JSON 輸出。
memory promote-explain：
說明特定提升候選項目及其分數明細。
<selector>：要查找的候選鍵、路徑片段或片段內容。--agent <id>：限定於單一代理程式（預設：預設代理程式）。--include-promoted：包含已提升的候選項目。--json：列印 JSON 輸出。
memory rem-harness：
預覽 REM 反思、候選真相與深層提升輸出，不寫入任何內容。
--agent <id>：限定於單一代理程式（預設：預設代理程式）。--include-promoted：包含已提升的深層候選項目。--json：列印 JSON 輸出。
Dreaming
Dreaming 是背景記憶整合系統，包含三個協作 階段：light（排序/暫存短期素材）、deep（將耐久 事實提升到MEMORY.md），以及 REM（反思並浮現主題）。
- 使用
plugins.entries.memory-core.config.dreaming.enabled: true啟用。 - 透過聊天中的
/dreaming on|off切換（或用/dreaming status檢查）。 - Dreaming 會依一個受管理的掃描排程（
dreaming.frequency）執行，並依序執行階段：light、REM、deep。 - 只有 deep 階段會將耐久記憶寫入
MEMORY.md。 - 人類可讀的階段輸出與日記項目會寫入
DREAMS.md（或既有的dreams.md），並可選擇在memory/dreaming/<phase>/YYYY-MM-DD.md寫入各階段報告。 - 排序使用加權訊號：回憶頻率、擷取相關性、查詢多樣性、時間近因、跨日整合，以及衍生概念豐富度。
- 提升會在寫入
MEMORY.md前重新讀取即時每日筆記，因此已編輯或刪除的短期片段不會從過期的回憶儲存區快照被提升。 - 排程與手動
memory promote執行會共用相同的 deep 階段預設值，除非你傳入 CLI 閾值覆寫。 - 自動執行會展開到所有已設定的記憶工作區。
- 掃描節奏：
dreaming.frequency = 0 3 * * * - Deep 閾值：
minScore=0.8、minRecallCount=3、minUniqueQueries=3、recencyHalfLifeDays=14、maxAgeDays=30
memory index --verbose會列印各階段細節（供應者、模型、來源、批次活動）。memory status會包含任何透過memorySearch.extraPaths設定的額外路徑。- 如果實際啟用的 Active Memory 遠端 API 金鑰欄位設定為 SecretRefs，命令會從作用中的 Gateway 快照解析這些值。如果 Gateway 不可用，命令會快速失敗。
- Gateway 版本偏差注意事項：此命令路徑需要支援
secrets.resolve的 Gateway；較舊的 Gateway 會傳回未知方法錯誤。 - 使用
dreaming.frequency調整排程掃描節奏。Deep 提升政策除此之外屬於內部機制；需要一次性手動覆寫時，請在memory promote使用 CLI 旗標。 memory rem-harness --path <file-or-dir> --grounded會從歷史每日筆記預覽有根據的What Happened、Reflections和Possible Lasting Updates，不寫入任何內容。memory rem-backfill --path <file-or-dir>會將可逆的有根據日記項目寫入DREAMS.md，供 UI 檢閱。memory rem-backfill --path <file-or-dir> --stage-short-term也會將有根據的耐久候選項目植入即時短期提升儲存區，讓正常 deep 階段可以對它們排序。memory rem-backfill --rollback會移除先前寫入的有根據日記項目，而memory rem-backfill --rollback-short-term會移除先前暫存的有根據短期候選項目。- 請參閱 Dreaming，取得完整階段說明與設定參考。