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 status tersembunyi.

Cara kerjanya

Agen Anda memiliki tiga file terkait memori:

• MEMORY.md — memori jangka panjang. Fakta, preferensi, dan keputusan yang tahan lama. Dimuat pada awal setiap sesi DM.
• memory/YYYY-MM-DD.md — catatan harian. Konteks dan pengamatan yang sedang berjalan. Catatan hari ini dan kemarin dimuat otomatis.
• DREAMS.md (opsional) — Buku Harian Dream dan ringkasan sweep dreaming untuk tinjauan manusia, termasuk entri backfill historis yang berlandasan.

File-file ini berada di workspace agen (default ~/.openclaw/workspace).

Apa ditempatkan di mana

MEMORY.md adalah lapisan yang ringkas dan terkurasi. Gunakan untuk fakta yang tahan lama, preferensi, keputusan tetap, dan ringkasan pendek yang harus tersedia pada awal sesi privat utama. Ini tidak dimaksudkan sebagai transkrip mentah, log harian, atau arsip lengkap.

File memory/YYYY-MM-DD.md adalah lapisan kerja. Gunakan untuk catatan harian terperinci, pengamatan, ringkasan sesi, dan konteks mentah yang mungkin masih berguna nanti. File-file ini diindeks untuk memory_search dan memory_get, tetapi tidak disuntikkan ke prompt bootstrap normal pada setiap giliran.

Seiring waktu, agen diharapkan menyarikan materi berguna dari catatan harian ke dalam MEMORY.md dan menghapus entri jangka panjang yang usang. Instruksi workspace yang dihasilkan dan alur heartbeat dapat melakukannya secara berkala; Anda tidak perlu mengedit MEMORY.md secara manual untuk setiap detail yang diingat.

Jika MEMORY.md tumbuh melewati anggaran file bootstrap, OpenClaw mempertahankan file di disk secara utuh tetapi memotong salinan yang disuntikkan ke konteks model. Perlakukan itu sebagai sinyal untuk memindahkan materi terperinci kembali ke memory/*.md, hanya menyimpan ringkasan tahan lama di MEMORY.md, atau menaikkan batas bootstrap jika Anda secara eksplisit ingin menggunakan lebih banyak anggaran prompt. Gunakan /context list, /context detail, atau openclaw doctor untuk melihat ukuran mentah vs yang disuntikkan dan status pemotongan.

Komitmen yang disimpulkan

Beberapa tindak lanjut di masa depan bukanlah fakta yang tahan lama. Jika Anda menyebut wawancara besok, memori yang berguna mungkin adalah "cek lagi setelah wawancara," bukan "simpan ini selamanya di MEMORY.md."

Komitmen adalah memori tindak lanjut opt-in dan berumur pendek untuk kasus tersebut. OpenClaw menyimpulkannya dalam lintasan latar belakang tersembunyi, membatasinya ke agen dan channel yang sama, dan mengirimkan check-in yang jatuh tempo melalui heartbeat. Pengingat eksplisit tetap menggunakan tugas terjadwal.

Alat memori

Agen memiliki dua alat untuk bekerja dengan memori:

• memory_search — menemukan catatan yang relevan menggunakan pencarian semantik, bahkan saat susunan katanya berbeda dari aslinya.
• memory_get — membaca file memori atau rentang baris tertentu.

Kedua alat disediakan oleh Plugin memori aktif (default: memory-core).

Plugin pendamping Memory Wiki

Jika Anda ingin memori tahan lama berperilaku lebih seperti basis pengetahuan yang dipelihara daripada sekadar catatan mentah, gunakan Plugin memory-wiki bawaan.

memory-wiki mengompilasi pengetahuan tahan lama ke dalam vault wiki dengan:

• struktur halaman deterministik
• klaim dan bukti terstruktur
• pelacakan kontradiksi dan kesegaran
• dashboard yang dihasilkan
• digest terkompilasi untuk konsumen agen/runtime
• alat native 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 kaya provenance di sampingnya.

Lihat Memory Wiki.

Pencarian memori

Saat penyedia embedding dikonfigurasi, memory_search menggunakan pencarian hibrida — menggabungkan kemiripan vektor (makna semantik) dengan pencocokan kata kunci (istilah tepat seperti ID dan simbol kode). Ini langsung berfungsi setelah Anda memiliki kunci API untuk penyedia yang didukung.

Untuk detail tentang cara kerja pencarian, opsi penyetelan, dan penyiapan penyedia, lihat Pencarian memori.

Backend memori

Lapisan wiki pengetahuan

Flush memori otomatis

Sebelum Compaction meringkas 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.

Untuk menjaga giliran housekeeping tersebut pada model lokal, tetapkan override model memory-flush yang tepat:

{  "agents": {    "defaults": {      "compaction": {        "memoryFlush": {          "model": "ollama/qwen3:8b"        }      }    }  }}

Override hanya berlaku untuk giliran memory-flush dan tidak mewarisi rantai fallback sesi aktif.

Dreaming

Dreaming adalah lintasan konsolidasi latar belakang opsional untuk memori. Ini mengumpulkan sinyal jangka pendek, memberi skor kandidat, dan hanya mempromosikan item yang memenuhi syarat ke memori jangka panjang (MEMORY.md).

Ini dirancang untuk menjaga memori jangka panjang tetap bernilai tinggi:

• Opt-in: dinonaktifkan secara default.
• Terjadwal: saat diaktifkan, memory-core mengelola otomatis satu tugas cron berulang untuk sweep dreaming penuh.
• Berambang: 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 penskoran, dan detail Buku Harian Dream, lihat Dreaming.

Backfill berlandasan dan promosi live

Sistem dreaming sekarang memiliki dua lane tinjauan yang terkait erat:

• Dreaming live bekerja dari penyimpanan dreaming jangka pendek di bawah memory/.dreams/ dan itulah yang digunakan fase deep normal saat memutuskan apa yang dapat lulus ke MEMORY.md.
• Backfill berlandasan membaca catatan historis memory/YYYY-MM-DD.md sebagai file hari mandiri dan menulis keluaran tinjauan terstruktur ke DREAMS.md.

Backfill berlandasan berguna saat Anda ingin memutar ulang catatan lama dan memeriksa apa yang menurut sistem tahan lama tanpa mengedit MEMORY.md secara manual.

Saat Anda menggunakan:

openclaw memory rem-backfill --path ./memory --stage-short-term

kandidat tahan lama yang berlandasan tidak dipromosikan secara langsung. Kandidat tersebut di-stage ke dalam penyimpanan dreaming jangka pendek yang sama yang sudah digunakan fase deep normal. Itu berarti:

• DREAMS.md tetap menjadi permukaan tinjauan manusia.
• penyimpanan jangka pendek tetap menjadi permukaan pemeringkatan yang menghadap mesin.
• MEMORY.md tetap hanya ditulis oleh promosi deep.

Jika Anda memutuskan pemutaran ulang tidak berguna, Anda dapat menghapus artefak yang di-stage tanpa menyentuh entri buku harian biasa atau status recall normal:

openclaw memory rem-backfill --rollbackopenclaw memory rem-backfill --rollback-short-term

CLI

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

Bacaan lebih lanjut

• Mesin memori bawaan: backend SQLite default.
• Mesin memori QMD: sidecar local-first tingkat lanjut.
• Memori Honcho: memori lintas sesi AI-native.
• Memory LanceDB: Plugin yang didukung LanceDB dengan embedding kompatibel OpenAI.
• Memory Wiki: vault pengetahuan terkompilasi dan alat native wiki.
• Pencarian memori: pipeline pencarian, penyedia, dan penyetelan.
• Dreaming: promosi latar belakang dari recall jangka pendek ke memori jangka panjang.
• Referensi konfigurasi memori: semua kenop konfigurasi.
• Compaction: bagaimana Compaction berinteraksi dengan memori.

Terkait

• Active memory
• Pencarian memori
• Mesin memori bawaan
• Memori Honcho
• Memory LanceDB
• Komitmen