openclaw memory

管理語意記憶索引與搜尋。 由內建的 memory-core 外掛提供。當 plugins.slots.memory 選取 memory-core（預設值）時，此命令可用；其他記憶外掛會 公開自己的命令列介面命名空間。

相關：

• 記憶概念：記憶
• 記憶 wiki：記憶 Wiki
• Wiki 命令列介面：wiki
• 外掛：外掛

範例

openclaw memory statusopenclaw memory status --deepopenclaw memory status --fixopenclaw memory index --forceopenclaw memory search "meeting notes"openclaw memory search --query "deployment" --max-results 20openclaw memory promote --limit 10 --min-score 0.75openclaw memory promote --applyopenclaw memory promote --json --min-recall-count 0 --min-unique-queries 0openclaw memory promote-explain "router vlan"openclaw memory promote-explain "router vlan" --jsonopenclaw memory rem-harnessopenclaw memory rem-harness --jsonopenclaw memory status --jsonopenclaw memory status --deep --indexopenclaw memory status --deep --index --verboseopenclaw memory status --agent mainopenclaw memory index --agent main --verbose

選項

memory status 和 memory index：

• --agent <id>：限定至單一代理。若未提供，這些命令會針對每個已設定的代理執行；如果未設定代理清單，則會退回使用預設代理。
• --verbose：在探測與索引期間輸出詳細記錄。

memory status：

• --deep：探測本機向量儲存就緒狀態、嵌入提供者就緒狀態，以及語意向量搜尋就緒狀態。一般的 memory status 會保持快速，且不會執行即時嵌入或提供者探索工作；未知的向量儲存或語意向量狀態表示該命令未探測它。即使使用 --deep，QMD 詞彙式 searchMode: "search" 也會略過語意向量探測與嵌入維護。
• --index：如果儲存區是髒的，執行重新索引（隱含 --deep）。
• --fix：修復過期的回想鎖定，並正規化提升中繼資料。
• --json：列印 JSON 輸出。

如果 memory status 顯示 Dreaming status: blocked，表示受管理的夢境整理排程已啟用，但驅動它的心跳偵測未對預設代理觸發。請參閱夢境整理從未執行，了解兩個常見原因。

memory index：

• --force：強制完整重新索引。

memory search：

• 查詢輸入：傳入位置參數 [query] 或 --query <text>。
• 如果兩者都提供，--query 優先。
• 如果兩者皆未提供，命令會以錯誤結束。
• --agent <id>：限定至單一代理（預設：預設代理）。
• --max-results <n>：限制傳回的結果數量。
• --min-score <n>：篩除低分數的相符項目。
• --json：列印 JSON 結果。

memory promote：

預覽並套用短期記憶提升。

openclaw memory promote [--apply] [--limit <n>] [--include-promoted]

• --apply -- 將提升寫入 MEMORY.md（預設：僅預覽）。
• --limit <n> -- 限制顯示的候選項目數量。
• --include-promoted -- 包含先前週期中已提升的項目。

完整選項：

• 使用加權提升訊號（frequency、relevance、query diversity、recency、consolidation、conceptual richness），從 memory/YYYY-MM-DD.md 排序短期候選項目。
• 使用來自記憶回想與每日擷取處理的短期訊號，加上輕度/REM 階段強化訊號。
• 啟用夢境整理時，memory-core 會自動管理一個在背景執行完整掃描（light -> REM -> deep）的排程工作（不需要手動 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：

說明特定提升候選項目及其分數細項。

openclaw memory promote-explain <selector> [--agent <id>] [--include-promoted] [--json]

• <selector>：要查找的候選項目鍵、路徑片段或片段摘錄。
• --agent <id>：限定至單一代理（預設：預設代理）。
• --include-promoted：包含已提升的候選項目。
• --json：列印 JSON 輸出。

memory rem-harness：

預覽 REM 反思、候選真相，以及深度提升輸出，而不寫入任何內容。

openclaw memory rem-harness [--agent <id>] [--include-promoted] [--json]

• --agent <id>：限定至單一代理（預設：預設代理）。
• --include-promoted：包含已提升的深度候選項目。
• --json：列印 JSON 輸出。

夢境整理

夢境整理是背景記憶整合系統，具有三個協作 階段：light（排序/暫存短期素材）、deep（將持久 事實提升至 MEMORY.md），以及 REM（反思並浮現主題）。

• 使用 plugins.entries.memory-core.config.dreaming.enabled: true 啟用。
• 在聊天中使用 /dreaming on|off 切換（或使用 /dreaming status 檢查）。 頻道呼叫者必須是擁有者才能變更設定；閘道用戶端需要 operator.admin。唯讀狀態與說明仍可供已授權的 命令傳送者使用。
• 夢境整理會依據一個受管理的掃描排程（dreaming.frequency）執行，並按順序執行階段：light、REM、deep。
• 只有 deep 階段會將持久記憶寫入 MEMORY.md。
• 人類可讀的階段輸出與日記項目會寫入 DREAMS.md（或既有的 dreams.md），可選擇在 memory/dreaming/<phase>/YYYY-MM-DD.md 中產生每階段報告。
• 排名使用加權訊號：回想頻率、擷取相關性、查詢多樣性、時間近因、跨日整合，以及衍生概念豐富度。
• 提升在寫入 MEMORY.md 前會重新讀取即時每日筆記，因此已編輯或刪除的短期片段不會從過期的回想儲存快照提升。
• 除非你傳入命令列介面閾值覆寫，排程與手動 memory promote 執行會共用相同的 deep 階段預設值。
• 自動執行會展開到已設定的記憶工作區。

預設排程：

• 掃描週期：dreaming.frequency = 0 3 * * *
• Deep 閾值：minScore=0.8、minRecallCount=3、minUniqueQueries=3、recencyHalfLifeDays=14、maxAgeDays=30

範例：

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

注意事項：

• memory index --verbose 會列印每階段詳細資訊（提供者、模型、來源、批次活動）。
• memory status 會包含透過 memorySearch.extraPaths 設定的任何額外路徑。
• 如果有效的主動記憶遠端 API 金鑰欄位設定為 SecretRefs，命令會從作用中的閘道快照解析這些值。如果閘道不可用，命令會快速失敗。
• 閘道版本偏差注意事項：此命令路徑需要支援 secrets.resolve 的閘道；較舊的閘道會傳回未知方法錯誤。
• 使用 dreaming.frequency 調整排程掃描週期。Deep 提升策略除此之外屬於內部機制，但 dreaming.phases.deep.maxPromotedSnippetTokens 例外，它會在保留來源可見性的同時限制已提升片段長度。當你需要一次性的手動閾值覆寫時，請在 memory promote 使用命令列介面旗標。
• 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 會移除先前暫存且有根據的短期候選項目。
• 請參閱夢境整理，了解完整階段說明與設定參考。

相關

• 命令列介面參考
• 記憶概觀