openclaw memory

Zarządzaj indeksowaniem i wyszukiwaniem pamięci semantycznej. Udostępniane przez dołączony plugin memory-core. Polecenie jest dostępne, gdy plugins.slots.memory wybiera memory-core (domyślnie); inne pluginy pamięci udostępniają własne przestrzenie nazw CLI.

Powiązane:

• Koncepcja pamięci: Pamięć
• Wiki pamięci: Wiki pamięci
• CLI wiki: wiki
• Pluginy: Pluginy

Przykłady

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

Opcje

memory status i memory index:

• --agent <id>: ogranicz zakres do jednego agenta. Bez tej opcji te polecenia działają dla każdego skonfigurowanego agenta; jeśli nie skonfigurowano listy agentów, wracają do agenta domyślnego.
• --verbose: emituj szczegółowe logi podczas sondowania i indeksowania.

memory status:

• --deep: sprawdź gotowość lokalnego magazynu wektorowego, gotowość dostawcy embeddingów i gotowość semantycznego wyszukiwania wektorowego. Zwykłe memory status pozostaje szybkie i nie uruchamia pracy z aktywnymi embeddingami ani wykrywania dostawców; nieznany stan magazynu wektorowego lub wektora semantycznego oznacza, że nie był sondowany w tym poleceniu. Leksykalny QMD searchMode: "search" pomija semantyczne sondy wektorowe i utrzymanie embeddingów nawet z --deep.
• --index: uruchom ponowne indeksowanie, jeśli magazyn jest zabrudzony (implikuje --deep).
• --fix: napraw nieaktualne blokady recall i znormalizuj metadane promocji.
• --json: wypisz dane wyjściowe JSON.

Jeśli memory status pokazuje Dreaming status: blocked, zarządzany Cron Dreaming jest włączony, ale Heartbeat, który go napędza, nie uruchamia się dla agenta domyślnego. Zobacz Dreaming nigdy się nie uruchamia, aby poznać dwie częste przyczyny.

memory index:

• --force: wymuś pełne ponowne indeksowanie.

memory search:

• Dane wejściowe zapytania: przekaż pozycyjne [query] albo --query <text>.
• Jeśli podano oba, wygrywa --query.
• Jeśli nie podano żadnego, polecenie kończy się błędem.
• --agent <id>: ogranicz zakres do jednego agenta (domyślnie: agent domyślny).
• --max-results <n>: ogranicz liczbę zwracanych wyników.
• --min-score <n>: odfiltruj dopasowania o niskim wyniku.
• --json: wypisz wyniki JSON.

memory promote:

Podejrzyj i zastosuj promocje pamięci krótkoterminowej.

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

• --apply -- zapisuj promocje do MEMORY.md (domyślnie: tylko podgląd).
• --limit <n> -- ogranicz liczbę pokazywanych kandydatów.
• --include-promoted -- uwzględnij wpisy już wypromowane w poprzednich cyklach.

Pełne opcje:

• Porządkuje kandydatów krótkoterminowych z memory/YYYY-MM-DD.md przy użyciu ważonych sygnałów promocji (frequency, relevance, query diversity, recency, consolidation, conceptual richness).
• Używa sygnałów krótkoterminowych zarówno z recall pamięci, jak i przebiegów dziennego pobierania, plus sygnałów wzmocnienia z faz light/REM.
• Gdy Dreaming jest włączony, memory-core automatycznie zarządza jednym zadaniem Cron, które uruchamia pełny przebieg (light -> REM -> deep) w tle (ręczne openclaw cron add nie jest wymagane).
• --agent <id>: ogranicz zakres do jednego agenta (domyślnie: agent domyślny).
• --limit <n>: maksymalna liczba kandydatów do zwrócenia/zastosowania.
• --min-score <n>: minimalny ważony wynik promocji.
• --min-recall-count <n>: minimalna liczba recall wymagana dla kandydata.
• --min-unique-queries <n>: minimalna liczba odrębnych zapytań wymagana dla kandydata.
• --apply: dopisz wybranych kandydatów do MEMORY.md i oznacz ich jako wypromowanych.
• --include-promoted: uwzględnij już wypromowanych kandydatów w danych wyjściowych.
• --json: wypisz dane wyjściowe JSON.

memory promote-explain:

Wyjaśnij konkretnego kandydata do promocji i rozbicie jego wyniku.

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

• <selector>: klucz kandydata, fragment ścieżki lub fragment wycinka do wyszukania.
• --agent <id>: ogranicz zakres do jednego agenta (domyślnie: agent domyślny).
• --include-promoted: uwzględnij już wypromowanych kandydatów.
• --json: wypisz dane wyjściowe JSON.

memory rem-harness:

Podejrzyj refleksje REM, prawdy kandydujące i wynik głębokiej promocji bez zapisywania czegokolwiek.

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

• --agent <id>: ogranicz zakres do jednego agenta (domyślnie: agent domyślny).
• --include-promoted: uwzględnij już wypromowanych głębokich kandydatów.
• --json: wypisz dane wyjściowe JSON.

Dreaming

Dreaming to działający w tle system konsolidacji pamięci z trzema współpracującymi fazami: light (sortowanie/przygotowanie materiału krótkoterminowego), deep (promowanie trwałych faktów do MEMORY.md) i REM (refleksja i wydobywanie tematów).

• Włącz za pomocą plugins.entries.memory-core.config.dreaming.enabled: true.
• Przełącz z czatu za pomocą /dreaming on|off (albo sprawdź przez /dreaming status). Wywołujący z kanałów muszą być właścicielami, aby zmienić ustawienie; klienci Gateway potrzebują operator.admin. Status tylko do odczytu i pomoc pozostają dostępne dla autoryzowanych nadawców poleceń.
• Dreaming działa według jednego zarządzanego harmonogramu przebiegu (dreaming.frequency) i wykonuje fazy w kolejności: light, REM, deep.
• Tylko faza deep zapisuje trwałą pamięć do MEMORY.md.
• Czytelne dla człowieka dane wyjściowe faz i wpisy dziennika są zapisywane do DREAMS.md (lub istniejącego dreams.md), z opcjonalnymi raportami dla każdej fazy w memory/dreaming/<phase>/YYYY-MM-DD.md.
• Ranking używa ważonych sygnałów: częstotliwości recall, trafności pobierania, różnorodności zapytań, świeżości czasowej, konsolidacji między dniami i wyprowadzonego bogactwa pojęciowego.
• Promocja ponownie odczytuje aktywną dzienną notatkę przed zapisem do MEMORY.md, więc edytowane lub usunięte krótkoterminowe wycinki nie są promowane z nieaktualnych migawek magazynu recall.
• Zaplanowane i ręczne uruchomienia memory promote współdzielą te same domyślne ustawienia fazy deep, chyba że przekażesz nadpisania progów CLI.
• Automatyczne uruchomienia rozchodzą się na skonfigurowane obszary robocze pamięci.

Domyślne planowanie:

• Rytm przebiegu: dreaming.frequency = 0 3 * * *
• Progi deep: minScore=0.8, minRecallCount=3, minUniqueQueries=3, recencyHalfLifeDays=14, maxAgeDays=30

Przykład:

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

Uwagi:

• memory index --verbose wypisuje szczegóły dla każdej fazy (dostawca, model, źródła, aktywność partii).
• memory status uwzględnia wszystkie dodatkowe ścieżki skonfigurowane przez memorySearch.extraPaths.
• Jeśli efektywnie używane pola klucza API zdalnej Active Memory są skonfigurowane jako SecretRefs, polecenie rozwiązuje te wartości z aktywnej migawki Gateway. Jeśli Gateway jest niedostępny, polecenie szybko kończy się niepowodzeniem.
• Uwaga o niezgodności wersji Gateway: ta ścieżka polecenia wymaga Gateway obsługującego secrets.resolve; starsze Gateway zwracają błąd nieznanej metody.
• Dostrój rytm zaplanowanego przebiegu za pomocą dreaming.frequency. Polityka promocji deep jest poza tym wewnętrzna, z wyjątkiem dreaming.phases.deep.maxPromotedSnippetTokens, które ogranicza długość promowanego wycinka, zachowując widoczne pochodzenie. Użyj flag CLI na memory promote, gdy potrzebujesz jednorazowych ręcznych nadpisań progów.
• memory rem-harness --path <file-or-dir> --grounded pokazuje podgląd ugruntowanych sekcji What Happened, Reflections i Possible Lasting Updates z historycznych dziennych notatek bez zapisywania czegokolwiek.
• memory rem-backfill --path <file-or-dir> zapisuje odwracalne ugruntowane wpisy dziennika do DREAMS.md do przeglądu w UI.
• memory rem-backfill --path <file-or-dir> --stage-short-term dodatkowo zasila aktywny magazyn krótkoterminowych promocji ugruntowanymi trwałymi kandydatami, aby zwykła faza deep mogła je uszeregować.
• memory rem-backfill --rollback usuwa wcześniej zapisane ugruntowane wpisy dziennika, a memory rem-backfill --rollback-short-term usuwa wcześniej przygotowanych ugruntowanych kandydatów krótkoterminowych.
• Zobacz Dreaming, aby poznać pełne opisy faz i referencję konfiguracji.

Powiązane

• Dokumentacja CLI
• Przegląd pamięci