## Langit-langit memori Jika Anda menjalankan OpenClaw hari ini, agen Anda menyimpan memori di `MEMORY.md` dan file bertanggal di direktori `memory/`. Itu berfungsi untuk penggunaan agen tunggal dan sesi tunggal. Saat Anda mengandalkan ingatan itu untuk segala sesuatu yang sedang berlangsung, Anda mencapai puncaknya. Mode kegagalan bersifat spesifik dan dapat diprediksi. **Pemadatan memori menghilangkan fakta.** OpenClaw memicu pergantian agen diam yang menulis "kenangan tahan lama" sebelum memotong konteks. Apa yang ada di dalam file sebelum pemadatan tidak diketahui. Jika versi ringkasnya menghilangkan fakta, maka fakta itu hilang. Tidak ada catatan observasi. Tidak ada kemunduran. **Tidak ada identitas entitas di seluruh sesi.** "Acme Corp" dalam satu sesi dan "ACME CORP" di sesi berikutnya mungkin atau mungkin tidak terpecahkan menjadi entitas yang sama. Agen menyimpulkan ulang setiap kali dari jendela konteks. Tidak ada ID stabil. Tidak ada aturan penggabungan. **Penulisan status rusak secara bersamaan.** Jika Anda menjalankan beberapa agen atau plugin yang menyentuh file memori yang sama, Anda akan mengalami kerusakan data. Dokumentasi OpenClaw sendiri mengakui hal ini. Batasan maksimum agen tunggal adalah nyata, dan sebagian besar alur kerja agen tidak akan tetap menjadi agen tunggal selamanya. **Tidak ada jejak audit.** Jika agen memberikan jawaban yang salah, Anda tidak dapat melacaknya kembali ke pengamatan tertentu. Anda tidak dapat melihat apa yang berubah antara Selasa dan Kamis. Anda tidak dapat menjawab "apa yang diketahui agen saya ketika mengambil keputusan itu?" Ini bukan kasus-kasus ekstrem. Mereka muncul segera setelah agen menangani kontak, tugas, transaksi, atau keadaan apa pun yang penting di seluruh sesi. ## Apa yang ditambahkan plugin [Neotoma v0.4.3](https://github.com/markmhendrickson/neotoma/releases/tag/v0.4.3) menambahkan manifes `openclaw.plugin.json`, titik masuk, dan definisi alat yang terdaftar ke dalam sistem plugin empat lapis OpenClaw. Gateway menemukan plugin, memvalidasi manifes, memuat runtime, dan memaparkan alat Neotoma ke agen. Setiap mode kegagalan di atas mendapat perbaikan struktural. **Pemadatan tidak lagi kehilangan statusnya.** Pengamatan hanya bersifat tambahan. Ringkasan yang dipadatkan masih dapat menyajikan jendela konteks, namun sumber observasi tetap ada di Neotoma dengan riwayat lengkap. Tidak ada yang dijatuhkan secara diam-diam. **Identitas entitas bersifat deterministik.** ID kanonis berbasis hash menyelesaikan "Acme Corp" dan "ACME CORP" menjadi satu entitas berdasarkan aturan, bukan berdasarkan inferensi per sesi. Kontak yang sama, ID yang sama, setiap saat. **Penulisan secara bersamaan aman.** Dua agen yang menulis tentang entitas yang sama menghasilkan dua pengamatan di penyimpanan tambahan saja, bukan konflik file. Batasan skema memvalidasi setiap penulisan sebelum memasuki penyimpanan. **Jejak audit sudah ada di dalamnya.** Setiap pengamatan menelusuri sumbernya. Koreksi menciptakan pengamatan baru, bukan penimpaan. Anda dapat merekonstruksi keadaan kapan saja. Selain memperbaiki batas atas, plugin ini memperlihatkan kemampuan yang tidak dapat didukung oleh `MEMORY.md` sama sekali: - **Pengambilan terstruktur.** "Semua tugas yang ditautkan ke kontak ini" atau "setiap transaksi dengan vendor X" adalah kueri, bukan file grep. - **Kueri garis waktu.** Bidang tanggal di seluruh entitas menghasilkan garis waktu. "Apa yang terjadi minggu lalu" mencapai indeks temporal, bukan pencarian jendela konteks. - **Validasi skema.** Jenis entitas diperiksa saat menulis. Data buruk ditolak sebelum dimasukkan ke penyimpanan. Lingkaran agen tidak berubah. OpenClaw masih mengelola interpretasi maksud, penelusuran, pengisian formulir, dan eksekusi keterampilan. Neotoma menangani keadaan. Plugin ini berada di antara penulisan agen dan penyimpanan persisten. ## Pertanyaan overhead File penurunan harga gratis. Mereka tidak mengeluarkan biaya apa pun untuk menyiapkannya, tidak mengeluarkan biaya apa pun untuk memeliharanya, dan ekonomi KV-cache secara aktif memberikan imbalan kepada mereka. Neotoma menambahkan overhead. Validasi skema saat menulis. Penyimpanan observasi. Resolusi entitas. Proses server lokal. Ini tidak gratis. Namun overhead dirancang agar tetap tidak terlihat: agen menginstal Neotoma, mengonfigurasinya, dan menulis ke dalamnya tanpa mengharuskan Anda mempelajari alat baru atau mengubah cara Anda bekerja. Pertanyaannya adalah apakah biaya overhead tersebut layak dibayar. Jika agen Anda tidak perlu menjawab "apa yang saya ketahui Selasa lalu" atau "tulisan mana yang merusak catatan kontak ini", maka tidak. `MEMORY.md` adalah arsitektur yang benar. Jika agen Anda mengelola status, kontak, tugas, transaksi, dan hubungan vendor yang sedang berlangsung, dan Anda memerlukan konsistensi di seluruh sesi, overhead jalur tulis adalah bagian masalah yang paling murah. Bagian yang mahal adalah men-debug korupsi negara setelah kejadiannya, ketika jejak audit tidak ada. ## Apa yang tidak dilakukan ini Plugin ini tidak menggantikan loop agen OpenClaw. Itu tidak mengubah cara kerja keterampilan. Ini tidak memerlukan migrasi konten `MEMORY.md` yang ada (meskipun impor didukung). Itu tidak menyelesaikan setiap masalah memori agen. Kualitas pengambilan, rekayasa yang cepat, desain keterampilan, dan pemilihan model tetap penting. Neotoma menangani lapisan negara: entitas apa yang ada, bagaimana mereka terhubung, dari mana mereka berasal, dan bagaimana mereka berubah. Segala sesuatu di atas lapisan itu tetap sama. Ia juga tidak mengklaim stabilitas produksi. Neotoma ada di [rilis pengembang](/posts/neotoma-developer-release). Perubahan besar diharapkan terjadi. Plugin ini ada untuk menguji tekanan apakah keadaan terstruktur di bawah platform agen nyata berfungsi dalam praktiknya, bukan untuk menjanjikan keandalan saat ini. ## Cobalah, hancurkan Saya telah menjalankan Neotoma sebagai lapisan memori di [tumpukan agen saya sendiri](/posts/apa yang sebenarnya dilakukan tumpukan agensaya). Beberapa agen menulis ke toko yang sama: triase email, manajemen tugas, keuangan, dan konten. Masalah negara multi-agen yang dijelaskan di atas bukanlah hipotesis bagi saya. Itulah yang saya alami setiap minggunya. Plugin ini membuat ini tersedia untuk pengguna OpenClaw. Instal itu. Aktifkan itu. Jalankan agen Anda dengan status terstruktur di bawahnya. Lihat di mana hal ini membantu. Lihat di mana biaya overhead tidak sepadan. Lihat di mana kerusakan desainnya. Putaran umpan balik lebih penting daripada arsitektur. Agen nyata yang menulis observasi nyata melalui lapisan terstruktur adalah tempat klaim bertahan atau gagal. ## Evaluasi dan instal Cara tercepat untuk mengetahui apakah Neotoma cocok dengan alur kerja OpenClaw Anda adalah dengan membiarkan agen Anda mengevaluasinya untuk Anda. Rekatkan ini ke sesi OpenClaw Anda: ```salinan Baca https://neotoma.io/evaluate. Sebelum Anda menjawab, periksa alat, ruang kerja, dan konteks konfigurasi yang lebih luas yang dapat Anda akses sehingga Anda menilai alur kerja saya yang sebenarnya, bukan hanya obrolan ini. Lalu beri tahu saya apakah Neotoma benar-benar cocok untuk alur kerja saya, data apa yang memiliki nilai tertinggi untuk dipertahankan terlebih dahulu, dan apa yang harus saya lakukan selanjutnya. ``` Agen Anda membaca halaman tersebut, memeriksa konteks lokal Anda (alat, konfigurasi, file memori, dan ruang kerja), dan memberi tahu Anda apakah masalah yang dijelaskan dalam postingan ini berlaku untuk pengaturan Anda. Jika ya, ini akan memandu Anda melalui instalasi, aktivasi dengan data Anda sendiri, dan konfigurasi plugin. Jika tidak, itu juga memberitahu Anda. Jika Anda sudah menginginkan Neotoma dan memilih untuk melewati [langkah evaluasi](https://neotoma.io/evaluate), gunakan instalasi yang dibantu agen dari [neotoma.io/install](https://neotoma.io/install). Rekatkan ini ke OpenClaw. Agen Anda membaca urutan penginstalan-pertama secara lengkap di halaman tersebut, menginstal hanya jika diperlukan, menjalankan aktivasi dengan data Anda, lalu mengonfigurasi alat Anda saat ini untuk penggunaan berkelanjutan, termasuk langkah-langkah integrasi OpenClaw di halaman yang sama: ```salinan Baca https://neotoma.io/install dan bawa saya melalui alur instalasi Neotoma pertama. Instal, aktifkan dengan data saya, dan konfigurasikan alat saya saat ini untuk penggunaan berkelanjutan yang kuat. ``` If you prefer manual commands: `openclaw plugins install clawhub:neotoma` adds the plugin directly from ClawHub. Atau instal paket npm secara global dengan `npm install -g neotoma` lalu `neotoma init`, dengan pin opsional untuk rilis ini (`npm install -g neotoma@0.4.3`). Opsi lengkap, konfigurasi MCP, Docker, dan perilaku reset tetap ada di [neotoma.io/install](https://neotoma.io/install). Repo: [github.com/markmhendrickson/neotoma](https://github.com/markmhendrickson/neotoma). Catatan rilis: [v0.4.3](https://github.com/markmhendrickson/neotoma/releases/tag/v0.4.3). Untuk alasan arsitektural yang lebih mendalam di balik memori agen terstruktur, lihat [OpenClaw dan lapisan kebenaran](/posts/openclaw-and-the-truth-layer) dan [Plafon memori penurunan harga](/posts/the-markdown-memory-ceiling).