
Kalau Memory Wiki gagal dimuat setelah install atau upgrade OpenClaw, masalahnya belum tentu ada di konfigurasi. Paket NPM resmi stable dan beta saat ini memang tidak menyediakan satu runtime dependency yang dibutuhkan plugin bundled tersebut.
Temuan ini dilaporkan dalam issue OpenClaw #122357 pada 12 Agustus 2026. Statusnya masih open, prioritas P1, dan reproduksinya diberi label source-repro oleh sistem triase proyek.
Package yang tidak tersedia adalah mdast-util-from-markdown. Manifest Memory Wiki mendeklarasikan versi 2.0.3, dan source plugin mengimpornya untuk memproses Markdown. Masalahnya, package OpenClaw yang dipublikasikan tidak menyediakannya di root maupun di dalam plugin bundled. Pada instalasi bersih, import itu tidak dapat di-resolve.
Status per 12 Agustus 2026: dist-tag NPM
latestmasih2026.7.1-2,betasudah2026.8.1-beta.1, dan belum ada release resmi yang terverifikasi membawa fix untuk issue ini.
Apa yang sebenarnya rusak
Memory Wiki adalah plugin opsional untuk menyusun pengetahuan jangka panjang menjadi vault Markdown yang bisa dicari dan diaudit. Bug ini tidak merusak isi vault. Kegagalannya terjadi lebih awal, saat runtime mencoba memuat kode plugin.
Pola teknisnya seperti ini:
- OpenClaw membawa Memory Wiki sebagai plugin bundled.
- Manifest plugin mencantumkan
[email protected]. - Kode plugin mengimpor package tersebut secara langsung.
- Dependency tidak ada pada lokasi yang dapat di-resolve dari plugin.
- Plugin inventory atau doctor dapat melaporkan bahwa Memory Wiki belum terpasang lengkap.
Pada reproduksi bersih terhadap stable 2026.7.1-2 dan beta 2026.8.1-beta.1, dependency tidak ditemukan baik di root node_modules maupun di node_modules milik OpenClaw. Resolution dari direktori plugin juga menghasilkan MODULE_NOT_FOUND.
Kenapa dampaknya bisa terlihat tidak konsisten
Bug packaging seperti ini sering tampak acak karena struktur node_modules berbeda antar-host.
Workspace pengembangan bisa saja memiliki dependency yang sama dari package lain, atau menyimpan sisa instalasi lama. Dalam kondisi itu, import dapat kebetulan berhasil. Clean install dengan cache baru tidak punya bantuan tersebut, sehingga dependency yang hilang langsung terlihat.
Itulah kenapa hasil test di source tree belum cukup untuk membuktikan paket distribusi sehat. Yang harus diuji adalah tarball NPM setelah dipasang ke environment kosong, lalu runtime dependency di-resolve dari root plugin.
Stable dan beta sama-sama terdampak
Issue resmi mencakup dua jalur distribusi:
[email protected]pada dist-taglatest[email protected]pada dist-tagbeta
Berpindah dari stable ke beta bukan mitigasi untuk masalah ini. Keduanya menunjukkan pola yang sama dalam reproduksi bersih.
Source main juga masih memperlihatkan dependency tersebut sebagai kebutuhan langsung Memory Wiki. Namun adanya deklarasi di source tidak otomatis berarti package distribusi sudah benar. Sampai ada release baru dan clean-install verification yang lolos, operator sebaiknya menganggap bug ini belum terselesaikan.
Cara memastikan host Anda terdampak
Jangan langsung reinstall seluruh OpenClaw. Mulai dari diagnosis sempit:
- Pastikan versi yang diperiksa sama dengan versi yang benar-benar dijalankan Gateway.
- Jalankan inventory atau doctor plugin sesuai prosedur operasional host.
- Cari error resolution yang menyebut
mdast-util-from-markdownatau Memory Wiki belum terpasang lengkap. - Cek apakah masalah muncul setelah clean install, upgrade, atau rebuild dependency tree.
- Uji satu operasi wiki nyata, bukan hanya memastikan Gateway sudah listen pada port.
Kalau Memory Wiki tidak diaktifkan, dampak operasionalnya rendah. Kalau plugin ini menjadi knowledge source utama agent, perlakukan kegagalan load sebagai blocker upgrade karena fitur wiki dapat hilang setelah restart.
Mitigasi sementara yang aman
Pilihan paling aman adalah menahan perubahan pada host yang sudah stabil, atau tidak mengaktifkan Memory Wiki sampai correction release tersedia. Ini menghindari state package manual yang mudah hilang ketika OpenClaw di-update.
Jika Memory Wiki wajib dipakai, pemasangan manual [email protected] dapat digunakan sebagai workaround darurat. Namun lokasi instalasinya harus benar-benar masuk ke jalur resolution runtime OpenClaw pada host tersebut. Menambah package di folder kerja yang tidak dipakai Gateway tidak akan memperbaiki apa pun.
Workaround manual membawa tiga konsekuensi:
- reinstall atau update berikutnya dapat menghapusnya;
- state host menjadi berbeda dari package resmi;
- operator berikutnya perlu tahu kenapa dependency tersebut ditambahkan.
Karena itu, lakukan hanya dalam maintenance window. Backup config dan state, dokumentasikan perubahan, restart secara terukur, lalu cek inventory plugin dan jalankan satu query wiki. Jangan memodifikasi isi package OpenClaw tanpa rollback plan.
Fix resmi yang perlu ditunggu
Perbaikannya bukan sekadar menambah satu baris manifest di source. Jalur publish juga harus memastikan runtime dependency plugin bundled ikut tersedia dalam paket final.
Gate yang relevan untuk operator adalah:
- perbaikan masuk ke repository resmi;
- test package artifact memverifikasi resolution dari root plugin;
- tarball NPM baru lolos clean install;
- release note atau issue menyebut versi yang membawa fix.
Saat audit dilakukan, belum ada pull request perbaikan untuk issue #122357 yang sudah merged. Percobaan implementasi otomatis pada issue juga berhenti sebelum seluruh gate deterministik selesai. Jadi statusnya masih bug terbuka, bukan fix yang tinggal menunggu restart.
Keputusan operasional
Untuk host yang tidak memakai Memory Wiki, tidak perlu panic. Catat issue ini dan tambahkan smoke test plugin saat upgrade berikutnya.
Untuk host yang mengandalkan wiki sebagai knowledge source, jangan blind upgrade dan jangan menganggap beta sebagai jalan keluar. Tahan versi yang sudah terbukti bekerja, atau pasang workaround secara terkontrol sambil menunggu release resmi.
Ini bukan security advisory dan belum ada indikasi kebocoran data. Risikonya adalah availability: plugin resmi dapat gagal dimuat pada instalasi bersih karena dependency runtime tidak tersedia di paket NPM.


