# openclaw memory

Kelola pengindeksan dan pencarian memori semantik. Disediakan oleh Plugin Active Memory (default: memory-core; atur plugins.slots.memory = "none" untuk menonaktifkan).

Terkait:

• Konsep memori: Memori
• Wiki memori: Wiki Memori
• CLI wiki: wiki
• Plugin: Plugin

# Contoh

openclaw memory status
openclaw memory status --deep
openclaw memory status --fix
openclaw memory index --force
openclaw memory search "meeting notes"
openclaw memory search --query "deployment" --max-results 20
openclaw memory promote --limit 10 --min-score 0.75
openclaw memory promote --apply
openclaw memory promote --json --min-recall-count 0 --min-unique-queries 0
openclaw memory promote-explain "router vlan"
openclaw memory promote-explain "router vlan" --json
openclaw memory rem-harness
openclaw memory rem-harness --json
openclaw memory status --json
openclaw memory status --deep --index
openclaw memory status --deep --index --verbose
openclaw memory status --agent main
openclaw memory index --agent main --verbose

# Opsi

memory status dan memory index:

• --agent <id>: batasi cakupan ke satu agen. Tanpanya, perintah ini berjalan untuk setiap agen yang dikonfigurasi; jika tidak ada daftar agen yang dikonfigurasi, perintah akan kembali ke agen default.
• --verbose: keluarkan log terperinci selama probe dan pengindeksan.

memory status:

• --deep: probe kesiapan vector store lokal, kesiapan penyedia embedding, dan kesiapan pencarian vektor semantik. memory status biasa tetap cepat dan tidak menjalankan embedding langsung atau pekerjaan penemuan penyedia; status vector store atau vektor semantik yang tidak diketahui berarti status tersebut tidak diprobe dalam perintah itu. searchMode: "search" leksikal QMD melewati probe vektor semantik dan pemeliharaan embedding bahkan dengan --deep.
• --index: jalankan pengindeksan ulang jika store kotor (menyiratkan --deep).
• --fix: perbaiki kunci recall usang dan normalkan metadata promosi.
• --json: cetak output JSON.

Jika memory status menampilkan Dreaming status: blocked, Cron dreaming terkelola diaktifkan tetapi Heartbeat yang menjalankannya tidak aktif untuk agen default. Lihat Dreaming tidak pernah berjalan untuk dua penyebab umum.

memory index:

• --force: paksa pengindeksan ulang penuh.

memory search:

• Input kueri: berikan [query] posisional atau --query <text>.
• Jika keduanya diberikan, --query yang menang.
• Jika tidak ada yang diberikan, perintah keluar dengan galat.
• --agent <id>: batasi cakupan ke satu agen (default: agen default).
• --max-results <n>: batasi jumlah hasil yang dikembalikan.
• --min-score <n>: saring kecocokan berskor rendah.
• --json: cetak hasil JSON.

memory promote:

Pratinjau dan terapkan promosi memori jangka pendek.

openclaw memory promote [--apply] [--limit <n>] [--include-promoted]

• --apply -- tulis promosi ke MEMORY.md (default: hanya pratinjau).
• --limit <n> -- batasi jumlah kandidat yang ditampilkan.
• --include-promoted -- sertakan entri yang sudah dipromosikan pada siklus sebelumnya.

Opsi lengkap:

• Memeringkat kandidat jangka pendek dari memory/YYYY-MM-DD.md menggunakan sinyal promosi berbobot (frequency, relevance, query diversity, recency, consolidation, conceptual richness).
• Menggunakan sinyal jangka pendek dari recall memori dan lintasan ingest harian, ditambah sinyal penguatan fase light/REM.
• Saat Dreaming diaktifkan, memory-core otomatis mengelola satu tugas Cron yang menjalankan sweep penuh (light -> REM -> deep) di latar belakang (tidak perlu openclaw cron add manual).
• --agent <id>: batasi cakupan ke satu agen (default: agen default).
• --limit <n>: jumlah kandidat maksimum untuk dikembalikan/diterapkan.
• --min-score <n>: skor promosi berbobot minimum.
• --min-recall-count <n>: jumlah recall minimum yang diperlukan untuk kandidat.
• --min-unique-queries <n>: jumlah kueri berbeda minimum yang diperlukan untuk kandidat.
• --apply: tambahkan kandidat terpilih ke MEMORY.md dan tandai sebagai dipromosikan.
• --include-promoted: sertakan kandidat yang sudah dipromosikan dalam output.
• --json: cetak output JSON.

memory promote-explain:

Jelaskan kandidat promosi tertentu dan rincian skornya.

openclaw memory promote-explain <selector> [--agent <id>] [--include-promoted] [--json]

• <selector>: kunci kandidat, fragmen path, atau fragmen cuplikan untuk dicari.
• --agent <id>: batasi cakupan ke satu agen (default: agen default).
• --include-promoted: sertakan kandidat yang sudah dipromosikan.
• --json: cetak output JSON.

memory rem-harness:

Pratinjau refleksi REM, kebenaran kandidat, dan output promosi mendalam tanpa menulis apa pun.

openclaw memory rem-harness [--agent <id>] [--include-promoted] [--json]

• --agent <id>: batasi cakupan ke satu agen (default: agen default).
• --include-promoted: sertakan kandidat mendalam yang sudah dipromosikan.
• --json: cetak output JSON.

# Dreaming

Dreaming adalah sistem konsolidasi memori latar belakang dengan tiga fase kooperatif: light (mengurutkan/menyiapkan materi jangka pendek), deep (mempromosikan fakta tahan lama ke MEMORY.md), dan REM (merefleksikan dan memunculkan tema).

• Aktifkan dengan plugins.entries.memory-core.config.dreaming.enabled: true.
• Alihkan dari chat dengan /dreaming on|off (atau periksa dengan /dreaming status).
• Dreaming berjalan pada satu jadwal sweep terkelola (dreaming.frequency) dan mengeksekusi fase secara berurutan: light, REM, deep.
• Hanya fase deep yang menulis memori tahan lama ke MEMORY.md.
• Output fase yang mudah dibaca manusia dan entri buku harian ditulis ke DREAMS.md (atau dreams.md yang sudah ada), dengan laporan opsional per fase di memory/dreaming/<phase>/YYYY-MM-DD.md.
• Pemeringkatan menggunakan sinyal berbobot: frekuensi recall, relevansi retrieval, keberagaman kueri, resensi temporal, konsolidasi lintas hari, dan kekayaan konsep turunan.
• Promosi membaca ulang catatan harian langsung sebelum menulis ke MEMORY.md, sehingga cuplikan jangka pendek yang diedit atau dihapus tidak dipromosikan dari snapshot recall-store yang usang.
• Jalankan terjadwal dan manual memory promote berbagi default fase deep yang sama kecuali Anda memberikan penimpaan ambang CLI.
• Jalankan otomatis menyebar ke seluruh workspace memori yang dikonfigurasi.

Penjadwalan default:

• Kadensi sweep: dreaming.frequency = 0 3 * * *
• Ambang deep: minScore=0.8, minRecallCount=3, minUniqueQueries=3, recencyHalfLifeDays=14, maxAgeDays=30

Contoh:

{
  "plugins": {
    "entries": {
      "memory-core": {
        "config": {
          "dreaming": {
            "enabled": true
          }
        }
      }
    }
  }
}

Catatan:

• memory index --verbose mencetak detail per fase (penyedia, model, sumber, aktivitas batch).
• memory status menyertakan path tambahan apa pun yang dikonfigurasi melalui memorySearch.extraPaths.
• Jika field kunci API jarak jauh Active Memory yang efektif dikonfigurasi sebagai SecretRefs, perintah menyelesaikan nilai tersebut dari snapshot Gateway aktif. Jika Gateway tidak tersedia, perintah gagal cepat.
• Catatan ketidaksesuaian versi Gateway: path perintah ini memerlukan Gateway yang mendukung secrets.resolve; Gateway lama mengembalikan galat metode tidak dikenal.
• Sesuaikan kadensi sweep terjadwal dengan dreaming.frequency. Kebijakan promosi deep selain itu bersifat internal; gunakan flag CLI pada memory promote saat Anda membutuhkan penimpaan manual satu kali.
• memory rem-harness --path <file-or-dir> --grounded mempratinjau What Happened, Reflections, dan Possible Lasting Updates yang grounded dari catatan harian historis tanpa menulis apa pun.
• memory rem-backfill --path <file-or-dir> menulis entri buku harian grounded yang dapat dibalik ke DREAMS.md untuk peninjauan UI.
• memory rem-backfill --path <file-or-dir> --stage-short-term juga menyemai kandidat tahan lama yang grounded ke dalam store promosi jangka pendek langsung sehingga fase deep normal dapat memeringkatnya.
• memory rem-backfill --rollback menghapus entri buku harian grounded yang sebelumnya ditulis, dan memory rem-backfill --rollback-short-term menghapus kandidat jangka pendek grounded yang sebelumnya di-stage.
• Lihat Dreaming untuk deskripsi fase lengkap dan referensi konfigurasi.

# Terkait

• Referensi CLI
• Ikhtisar memori