Langsung ke konten
Panduan

Wiki memori OpenClaw

Vault pengetahuan terkompilasi dengan klaim, bukti, asal-usul, dan dasbor di samping plugin memori

6 menit baca

Catatan memori biasa menjawab apa yang diingat agen; catatan itu tidak mengatakan seberapa yakin agen tersebut, dari mana sebuah fakta berasal, atau dua catatan mana yang saling bertentangan. Plugin bawaan memory-wiki milik OpenClaw menambahkan lapisan itu. Plugin ini mengompilasi pengetahuan yang bertahan lama menjadi wiki yang dapat dinavigasi, berisi halaman deterministik, klaim terstruktur dengan bukti, asal-usul, dasbor, dan ringkasan yang dapat dibaca mesin, dan plugin ini berada di samping plugin memori yang aktif, bukan menggantikannya: pemanggilan kembali, promosi, pengindeksan, dan dreaming tetap ditangani oleh plugin memori yang dikonfigurasi. Berikut mode vault, tata letak, model klaim, pipeline kompilasi, laporan, alat, dan catatan penting seputar vault per agen.

Mode, scope, tata letak

  • Tiga mode vault: isolated, yang default, dengan vault dan sumbernya sendiri tanpa ketergantungan pada plugin memori; bridge, yang membaca artefak memori publik dan log peristiwa dari plugin memori aktif melalui titik integrasi publik plugin SDK, serta mengindeks artefak yang diekspor, catatan harian, laporan dreaming, dan log peristiwa memori sesuai sakelarnya masing-masing; dan unsafe-local, jalan keluar eksplisit di mesin yang sama untuk path privat yang bersifat eksperimental dan tidak portabel.
  • Scope vault adalah pilihan terpisah: global, yang default, mempertahankan satu vault bersama, sedangkan scope agent memberi setiap agen vault turunan sehingga agen tidak dapat berbagi halaman, ringkasan, hasil pencarian, atau penulisan; scope agent tidak dapat digabungkan dengan mode unsafe-local, dan validasi menolaknya.
  • Vault berisi catatan agen dan wiki di tingkat teratas, sebuah indeks dan kotak masuk, serta folder untuk entitas, konsep, sintesis, sumber, laporan, lampiran, dan tampilan; konten yang dikelola tetap berada di dalam blok yang dihasilkan, dan blok catatan buatan manusia tetap bertahan saat dibuat ulang.
  • Bundel Open Knowledge Format diimpor menjadi halaman konsep, dengan mempertahankan frontmatter asli berupa id konsep, jenis, sumber daya, tag, stempel waktu, dan produsen, sementara tautan internal ditulis ulang menjadi halaman wiki dan dikeluarkan sebagai relasi terstruktur.
Ini membuat wiki berperilaku seperti lapisan keyakinan, bukan tumpukan catatan yang pasif.

Klaim, entitas, kompilasi

Halaman membawa klaim terstruktur di frontmatter, masing-masing dengan id, teks, status, tingkat keyakinan, entri bukti, dan waktu pembaruan, dan setiap bukti membawa jenis, id sumber, path, baris, bobot, tingkat keyakinan, tingkat privasi, dan catatan; klaim dapat dilacak, dinilai, disanggah, dan ditelusuri kembali ke sumbernya. Halaman entitas menambahkan metadata routing yang dapat digunakan untuk orang, tim, sistem, atau proyek: jenis entitas, id kanonis, alias, tingkat privasi yang menandai apa pun selain public untuk ditinjau, petunjuk best-used-for dan not-enough-for, stempel waktu penyegaran, kartu orang opsional dengan handle, akun media sosial, email, zona waktu, lane, serta daftar ask-for dan avoid-asking-for, dan relasi bertipe. Kompilasi membaca halaman, menormalkan ringkasan, dan menyimpan snapshot yang ditujukan untuk mesin di state plugin SQLite bersama milik OpenClaw; persiapan prompt saat runtime memuat snapshot itu secara asinkron dan tidak pernah mengekstrak isi Markdown atau membaca file cache, perubahan pada sumber baru terlihat oleh mesin setelah kompilasi berikutnya, dan publikasi kompilasi yang dirantai secara kausal memungkinkan penyegaran lifecycle menolak snapshot dari state yang lebih baru tetapi sudah di-rollback. Cache hasil kompilasi dapat dibangun ulang dan diganti, bukan dimigrasikan.

Laporan, pencarian, alat

  • Saat dasbor diaktifkan, kompilasi memelihara laporan untuk pertanyaan terbuka, kontradiksi, halaman dan klaim dengan tingkat keyakinan rendah, klaim tanpa bukti terstruktur, halaman usang, direktori orang dan agen, graf relasi, cakupan asal-usul, dan tinjauan privasi untuk tingkat selain public.
  • Pencarian memiliki backend bersama yang menggunakan alur pencarian memori jika tersedia dan backend lokal yang hanya mencari di wiki, tiga korpus (wiki, memory, dan all), dan lima mode: auto, find-person, route-question, source-evidence, dan raw-claim; hasil yang mengenai klaim terstruktur mengembalikan id klaim, status, tingkat keyakinan, jenis bukti, dan id sumber, dan klaim yang disanggah, usang, atau baru memengaruhi peringkat.
  • Lima alat agen: wiki status, wiki search, wiki get, wiki apply untuk mutasi sintesis dan metadata yang terbatas tanpa membedah halaman secara bebas, dan wiki lint untuk pemeriksaan struktural, celah asal-usul, kontradiksi, dan pertanyaan terbuka; plugin ini juga mendaftarkan suplemen korpus non-eksklusif sehingga pencarian dan get memori bersama dapat menjangkau wiki jika plugin memori mendukung pemilihan korpus.

Penjelasan memori OpenClaw menjelaskan lapisan yang berdampingan dengan plugin ini, dan pencarian memori OpenClaw menjelaskan satu putaran pemanggilan kembali yang luas yang tetap direkomendasikan dokumentasi sebagai langkah pertama.

UI dan catatan penting

Control UI menelusuri wiki hasil kompilasi dari halaman memori di bawah tab Dreams dan Diary, mengelompokkan halaman sintesis, entitas, dan konsep dengan jumlah per halaman, membuka konten secara inline melalui pencarian yang sama dengan yang digunakan alat get, membatasi setiap dasbor pada 2.500 kartu terbaru, dan tidak pernah memindai halaman vault mentah atau menunggu kompilasi penuh. Ringkasan hasil kompilasi dapat ditambahkan ke bagian memori dalam prompt, berupa halaman teratas dan klaim teratas dengan jumlah kontradiksi dan pertanyaan, tetapi fitur ini bersifat opt-in karena mengubah bentuk prompt. Mengubah scope vault tidak menyalin atau memecah vault yang sudah ada, dan vault per agen adalah batas pengetahuan di dalam proses yang sama, bukan batas sistem operasi, karena alat tanpa sandbox yang memiliki akses ke sistem file host tetap dapat membaca direktori agen lain. Dreaming OpenClaw membahas konsolidasi milik plugin memori itu sendiri yang dapat diindeks oleh mode bridge, dan penjelasan sandboxing OpenClaw membahas batas yang dirujuk dokumentasi saat agen tidak saling percaya.

Di Diali

Di Diali, plugin ini disertakan dalam image runtime, dan setelah diaktifkan, vault-nya disimpan di volume persisten asisten di bawah direktori state; batas per agen kurang penting di sini, karena setiap instans menjalankan asistennya sendiri. OpenClaw yang di-hosting di Diali adalah asistennya dan panduan plugin OpenClaw menjelaskan cara mengaktifkan plugin bawaan.

  • Lapisan keyakinan di samping memori, bukan penggantinya.
  • Klaim dengan bukti, dikompilasi ke SQLite, dilaporkan di dasbor.
  • Isolated secara default; bridge untuk mengindeks apa yang diekspor memori.
Mulai sekarang

Berhenti membaca, buat agen Anda sendiri

Siapkan agen, pilih saluran, dan biarkan ia bekerja di dalam aplikasi yang sudah selalu Anda buka.