Langsung ke konten utama

Ikhtisar Memori

OpenClaw mengingat sesuatu dengan menulis file Markdown biasa di ruang kerja agen Anda. Model hanya “mengingat” apa yang disimpan ke disk — tidak ada status tersembunyi.

Cara kerjanya

Agen Anda memiliki dua tempat untuk menyimpan 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 observasi yang berjalan. Catatan hari ini dan kemarin dimuat secara otomatis.
File-file ini berada di ruang kerja 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 saat susunan katanya berbeda dari aslinya.
  • memory_get — membaca file memori tertentu atau rentang baris.
Kedua alat ini disediakan oleh plugin memori yang aktif (default: memory-core).

Pencarian memori

Saat provider 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 API key untuk provider yang didukung.
OpenClaw mendeteksi otomatis provider embedding Anda dari API key yang tersedia. Jika Anda telah mengonfigurasi key OpenAI, Gemini, Voyage, atau Mistral, pencarian memori diaktifkan secara otomatis.
Untuk detail tentang cara kerja pencarian, opsi penyetelan, dan penyiapan provider, lihat Pencarian Memori.

Backend memori

Bawaan (default)

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

QMD

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

Honcho

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

Flush memori otomatis

Sebelum kompaksi 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 hilangnya konteks selama kompaksi. Jika agen Anda memiliki fakta penting di dalam percakapan yang belum ditulis ke file, fakta tersebut akan disimpan secara otomatis sebelum peringkasan terjadi.

Dreaming (eksperimental)

Dreaming adalah proses konsolidasi latar belakang opsional untuk memori. Fitur ini meninjau kembali recall jangka pendek dari file harian (memory/YYYY-MM-DD.md), memberi skor, dan mempromosikan hanya item yang memenuhi syarat ke memori jangka panjang (MEMORY.md). Fitur ini dirancang untuk menjaga memori jangka panjang tetap bernilai tinggi:
  • Opt-in: dinonaktifkan secara default.
  • Terjadwal: saat diaktifkan, memory-core mengelola tugas berulang secara otomatis.
  • Berbasis ambang: promosi harus lolos gerbang skor, frekuensi recall, dan keberagaman kueri.
Untuk perilaku mode (off, core, rem, deep), sinyal penskoran, dan opsi penyetelan, lihat Dreaming (eksperimental).

CLI

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

Bacaan lanjutan