Podstawowe pliki pamięci
OpenClaw wykorzystuje trzy pliki Markdown przechowywane w workspace agenta (~/.openclaw/workspace) jako fundament systemu pamięci:
- MEMORY.md — pamięć długoterminowa na trwałe fakty, preferencje i decyzje. Ładowana na starcie każdej sesji.
- memory/YYYY-MM-DD.md — dzienne notatki zbierające bieżący kontekst. Notatki z dziś i wczoraj ładowane są automatycznie.
- DREAMS.md — eksperymentalny dziennik marzeń i podsumowania konsolidacji pamięci do przeglądu przez człowieka.
Narzędzia pamięci
Dwa podstawowe narzędzia służą do operacji na pamięci:
- memory_search — wyszukiwanie semantyczne, które znajduje istotne notatki nawet gdy słowa kluczowe się różnią od oryginału
- memory_get — pobieranie konkretnych plików pamięci lub zakresów linii
Aktywna wtyczka pamięci (domyślnie memory-core) dostarcza oba narzędzia.
Backendy pamięci
OpenClaw oferuje trzy opcje backendu:
- Builtin (domyślny) — oparty na SQLite, działa natychmiast po instalacji z wyszukiwaniem słów kluczowych i wektorowym.
- QMD — lokalny sidecar z rerankowaniem i rozszerzaniem zapytań, zapewniający lepsze wyniki wyszukiwania.
- Honcho — pamięć natywna dla AI, międzysesyjna z modelowaniem użytkownika i personalizacją.
Wtyczka Memory Wiki
Opcjonalna wtyczka memory-wiki kompiluje trwałą pamięć w strukturalny zbiór wiedzy (knowledge vault) z deterministycznymi stronami, śledzeniem twierdzeń, wykrywaniem sprzeczności i narzędziami natywnymi dla wiki: wiki_search, wiki_get, wiki_apply, wiki_lint.
Możliwości wyszukiwania
Przy skonfigurowanym dostawcy embeddingów memory_search korzysta z wyszukiwania hybrydowego — łączącego podobieństwo wektorowe z dopasowaniem słów kluczowych. OpenClaw automatycznie wykrywa providerów (OpenAI, Gemini, Voyage, Mistral).
Automatyczny zapis pamięci
Przed kompaktowaniem konwersacji OpenClaw automatycznie uruchamia cichą turę, przypominając agentowi o zapisaniu ważnego kontekstu. Zapobiega to utracie informacji przy redukcji okna kontekstowego.
System marzeń (Dreaming)
Opcjonalna, działająca w tle konsolidacja, która ocenia i promuje krótkoterminowe sygnały do pamięci długoterminowej. Bramki progowe zapewniają kontrolę jakości, a wynik zapisywany jest w pliku DREAMS.md.
Polecenia CLI
openclaw memory status # Sprawdź stan indeksu i providera
openclaw memory search "query" # Wyszukiwanie z wiersza poleceń
openclaw memory index --force # Przebuduj indeks
openclaw memory rem-backfill --path ./memory --stage-short-term # Odtwórz historyczne notatki