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 (atau memory/YYYY-MM-DD-<slug>.md) — catatan harian. Konteks dan observasi yang sedang berjalan. Catatan hari ini dan kemarin dimuat secara otomatis, dan varian berslug seperti yang ditulis oleh hook memori sesi bawaan pada /new atau /reset kini ikut diambil bersama file yang hanya berisi tanggal.
• DREAMS.md (opsional) — Buku Harian Dream dan ringkasan sweep dreaming untuk peninjauan manusia, termasuk entri pengisian balik historis yang berdasar.

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 tahan lama, preferensi, keputusan tetap, dan ringkasan pendek yang seharusnya tersedia pada awal sesi privat utama. File 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, observasi, 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 menyaring 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 melampaui anggaran file bootstrap, OpenClaw mempertahankan file di disk tetap utuh tetapi memangkas salinan yang disuntikkan ke konteks model. Anggap 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 memakai lebih banyak anggaran prompt. Gunakan /context list, /context detail, atau openclaw doctor untuk melihat ukuran mentah vs yang disuntikkan serta status pemangkasan.

Memori sensitif tindakan

Sebagian besar memori dapat ditulis sebagai catatan Markdown biasa. Namun beberapa memori memengaruhi apa yang harus dilakukan agen nanti. Untuk itu, catat kapan aman untuk bertindak berdasarkan catatan tersebut, bukan hanya faktanya saja.

Catat batas tindakan tersebut ketika sebuah catatan melibatkan:

• persyaratan persetujuan atau izin,
• batasan sementara,
• handoff ke sesi, thread, atau orang lain,
• kondisi kedaluwarsa,
• waktu aman untuk bertindak,
• otoritas sumber atau pemilik,
• instruksi untuk menghindari tindakan yang menggoda.

Memori sensitif tindakan yang berguna menjelaskan:

• apa yang mengubah perilaku di masa depan,
• kapan atau dalam kondisi apa hal itu berlaku,
• kapan hal itu kedaluwarsa, atau apa yang membuka tindakan,
• apa yang harus dihindari agen,
• siapa sumber atau pemiliknya, jika itu memengaruhi kepercayaan atau otoritas.

Memori dapat mempertahankan konteks persetujuan, tetapi tidak menegakkan kebijakan. Gunakan pengaturan persetujuan OpenClaw, sandboxing, dan tugas terjadwal untuk kontrol operasional yang keras.

Contoh:

The API migration is being designed in another session. Future turns should not edit the API implementation from this thread; use findings here only as design input until the migration plan lands.

Contoh lain:

A report from an untrusted source needs review before promotion. Future turns should treat it as evidence only; do not store it as durable memory until a trusted reviewer confirms the contents.

Gunakan komitmen untuk tindak lanjut tersimpulkan yang berumur pendek. Gunakan tugas terjadwal untuk pengingat persis, pemeriksaan berwaktu, dan pekerjaan berulang. Memori tetap dapat meringkas konteks tahan lama di sekitar salah satu jalur tersebut.

Ini bukan skema wajib untuk setiap memori. Fakta sederhana dapat tetap ringkas. Gunakan batas sensitif tindakan ketika kehilangan konteks waktu, otoritas, kedaluwarsa, atau aman untuk bertindak dapat membuat agen melakukan hal yang salah nanti.

Komitmen tersimpulkan

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

Komitmen bersifat opt-in, memori tindak lanjut berumur pendek untuk kasus tersebut. OpenClaw menyimpulkannya dalam lintasan latar belakang tersembunyi, membatasinya ke agen dan kanal 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 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 Active Memory (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 vault wiki dengan:

• struktur halaman deterministik
• klaim dan bukti terstruktur
• pelacakan kontradiksi dan kesegaran
• dasbor yang dihasilkan
• digest terkompilasi untuk konsumen agen/runtime
• alat native wiki seperti wiki_search, wiki_get, wiki_apply, dan wiki_lint

Plugin ini tidak menggantikan Plugin Active Memory. Plugin Active Memory tetap memiliki recall, promosi, dan dreaming. memory-wiki menambahkan lapisan pengetahuan 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 langsung berfungsi setelah Anda memiliki kunci API untuk penyedia yang didukung.

Untuk detail tentang cara kerja pencarian, opsi penyesuaian, 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 mempertahankan giliran housekeeping itu pada model lokal, tetapkan override model flush memori yang persis:

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

Override hanya berlaku untuk giliran flush memori 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 tinggi sinyal:

• Opt-in: dinonaktifkan secara default.
• Terjadwal: ketika diaktifkan, memory-core mengelola otomatis satu tugas Cron berulang untuk sweep Dreaming penuh.
• Berambang: promosi harus melewati gerbang skor, frekuensi recall, dan keberagaman kueri.
• Dapat ditinjau: ringkasan fase dan entri buku harian ditulis ke DREAMS.md untuk peninjauan manusia.

Untuk perilaku fase, sinyal penilaian, dan detail Buku Harian Dream, lihat Dreaming.

Pengisian balik berdasar dan promosi langsung

Sistem Dreaming kini memiliki dua jalur peninjauan yang berkaitan erat:

• 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.
• Pengisian balik berdasar membaca catatan historis memory/YYYY-MM-DD.md sebagai file hari mandiri dan menulis keluaran peninjauan terstruktur ke DREAMS.md.

Pengisian balik berdasar berguna ketika Anda ingin memutar ulang catatan lama dan memeriksa apa yang dianggap sistem sebagai tahan lama tanpa mengedit MEMORY.md secara manual.

Ketika Anda menggunakan:

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

kandidat tahan lama yang berdasar 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 peninjauan manusia.
• penyimpanan jangka pendek tetap menjadi permukaan pemeringkatan yang berhadapan dengan 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 status recall normal:

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

CLI

openclaw memory status          # Check index status and provideropenclaw memory search "query"  # Search from the command lineopenclaw memory index --force   # Rebuild the index

Bacaan lebih lanjut

• Mesin memori bawaan: backend SQLite default.
• Mesin memori QMD: sidecar local-first lanjutan.
• Memori Honcho: memori lintas sesi native AI.
• Memory LanceDB: Plugin berbasis LanceDB dengan embedding kompatibel OpenAI.
• Memory Wiki: vault pengetahuan terkompilasi dan alat native wiki.
• Pencarian memori: pipeline pencarian, penyedia, dan penyesuaian.
• 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