Langsung ke konten utama

​
Ikhtisar Memori

OpenClaw mengingat berbagai hal dengan menulis file Markdown biasa di workspace agen Anda. Model hanya “mengingat” apa yang disimpan ke disk — tidak ada state tersembunyi.

​
Cara kerjanya

Agen Anda memiliki tiga file yang terkait dengan memori:
  • MEMORY.md — memori jangka panjang. Fakta, preferensi, dan keputusan yang bertahan lama. Dimuat pada awal setiap sesi DM.
  • memory/YYYY-MM-DD.md — catatan harian. Konteks dan observasi yang berjalan. Catatan hari ini dan kemarin dimuat secara otomatis.
  • DREAMS.md (opsional) — Buku Harian Mimpi dan ringkasan penyapuan Dreaming untuk tinjauan manusia, termasuk entri backfill historis yang terlandaskan.
File-file ini berada di workspace agen (default ~/.openclaw/workspace).
Jika Anda ingin agen Anda mengingat sesuatu, cukup minta: “Ingat bahwa saya lebih suka TypeScript.” Agen akan menuliskannya ke file yang sesuai.

​
Alat memori

Agen memiliki dua alat untuk bekerja dengan memori:
  • memory_search — menemukan catatan yang relevan menggunakan pencarian semantik, bahkan ketika susunan katanya berbeda dari aslinya.
  • memory_get — membaca file memori tertentu atau rentang baris.
Kedua alat disediakan oleh Plugin memori aktif (default: memory-core).

​
Plugin pendamping Memory Wiki

Jika Anda ingin memori yang bertahan lama berperilaku lebih seperti basis pengetahuan yang dipelihara daripada sekadar catatan mentah, gunakan Plugin bawaan memory-wiki. memory-wiki mengompilasi pengetahuan yang bertahan lama ke dalam vault wiki dengan:
  • struktur halaman yang deterministik
  • klaim dan bukti yang terstruktur
  • pelacakan kontradiksi dan kebaruan
  • dasbor yang dihasilkan
  • digest terkompilasi untuk konsumen agen/runtime
  • alat yang native untuk wiki seperti wiki_search, wiki_get, wiki_apply, dan wiki_lint
Ini tidak menggantikan Plugin memori aktif. Plugin memori aktif tetap memiliki recall, promosi, dan Dreaming. memory-wiki menambahkan lapisan pengetahuan yang kaya provenance di sampingnya. Lihat Memory Wiki.

​
Pencarian memori

Ketika penyedia embedding dikonfigurasi, memory_search menggunakan pencarian hibrida — menggabungkan kemiripan vektor (makna semantik) dengan pencocokan kata kunci (istilah persis seperti ID dan simbol kode). Ini berfungsi langsung setelah Anda memiliki API key untuk penyedia yang didukung.
OpenClaw secara otomatis mendeteksi penyedia embedding Anda dari API key yang tersedia. Jika Anda telah mengonfigurasi key OpenAI, Gemini, Voyage, atau Mistral, pencarian memori akan diaktifkan secara otomatis.
Untuk detail tentang cara kerja pencarian, opsi penyesuaian, dan penyiapan penyedia, lihat Pencarian Memori.

​
Backend memori

Bawaan (default)

Berbasis SQLite. Berfungsi langsung dengan pencarian kata kunci, kemiripan vektor, dan pencarian hibrida. Tidak memerlukan dependensi tambahan.

QMD

Sidecar local-first dengan reranking, perluasan kueri, dan kemampuan untuk mengindeks direktori di luar workspace.

Honcho

Memori lintas sesi yang native AI dengan pemodelan pengguna, pencarian semantik, dan kesadaran multi-agen. Instalasi Plugin.

​
Lapisan wiki pengetahuan

Memory Wiki

Mengompilasi memori yang bertahan lama ke dalam vault wiki yang kaya provenance dengan klaim, dasbor, mode bridge, dan alur kerja yang ramah Obsidian.

​
Flush memori otomatis

Sebelum Compaction merangkum percakapan Anda, OpenClaw menjalankan giliran senyap yang mengingatkan agen untuk menyimpan konteks penting ke file memori. Ini aktif secara default — Anda tidak perlu mengonfigurasi apa pun.
Flush memori mencegah kehilangan konteks selama Compaction. Jika agen Anda memiliki fakta penting dalam percakapan yang belum ditulis ke file, fakta tersebut akan disimpan secara otomatis sebelum peringkasan terjadi.

​
Dreaming

Dreaming adalah proses konsolidasi latar belakang opsional untuk memori. Ini mengumpulkan sinyal jangka pendek, memberi skor pada kandidat, dan hanya mempromosikan item yang memenuhi syarat ke memori jangka panjang (MEMORY.md). Ini dirancang untuk menjaga agar memori jangka panjang tetap memiliki sinyal tinggi:
  • Opt-in: dinonaktifkan secara default.
  • Terjadwal: saat diaktifkan, memory-core secara otomatis mengelola satu pekerjaan Cron berulang untuk penyapuan Dreaming penuh.
  • Berambang batas: promosi harus melewati gerbang skor, frekuensi recall, dan keragaman kueri.
  • Dapat ditinjau: ringkasan fase dan entri buku harian ditulis ke DREAMS.md untuk tinjauan manusia.
Untuk perilaku fase, sinyal penilaian, dan detail Buku Harian Mimpi, lihat Dreaming.

​
Backfill terlandaskan dan promosi langsung

Sistem Dreaming kini memiliki dua jalur peninjauan yang sangat terkait:
  • Dreaming langsung bekerja dari penyimpanan Dreaming jangka pendek di bawah memory/.dreams/ dan itulah yang digunakan fase mendalam normal saat memutuskan apa yang dapat lulus ke MEMORY.md.
  • Backfill terlandaskan membaca catatan historis memory/YYYY-MM-DD.md sebagai file harian mandiri dan menulis keluaran tinjauan terstruktur ke DREAMS.md.
Backfill terlandaskan berguna ketika Anda ingin memutar ulang catatan lama dan memeriksa apa yang menurut sistem bersifat tahan lama tanpa mengedit MEMORY.md secara manual. Saat Anda menggunakan: 
openclaw memory rem-backfill --path ./memory --stage-short-term
kandidat tahan lama yang terlandaskan tidak dipromosikan secara langsung. Kandidat tersebut dipentaskan ke penyimpanan Dreaming jangka pendek yang sama yang sudah digunakan fase mendalam normal. Artinya:
  • DREAMS.md tetap menjadi permukaan tinjauan manusia.
  • penyimpanan jangka pendek tetap menjadi permukaan pemeringkatan yang menghadap mesin.
  • MEMORY.md tetap hanya ditulis oleh promosi mendalam.
Jika Anda memutuskan pemutaran ulang itu tidak berguna, Anda dapat menghapus artefak yang dipentaskan tanpa menyentuh entri buku harian biasa atau state recall normal: 
openclaw memory rem-backfill --rollback
openclaw memory rem-backfill --rollback-short-term

​
CLI

openclaw memory status          # Periksa status indeks dan penyedia
openclaw memory search "query"  # Cari dari baris perintah
openclaw memory index --force   # Bangun ulang indeks

​
Bacaan lanjutan