OpenClaw & AI Operasional

Memory Wiki OpenClaw Gagal Dimuat karena Dependency Hilang dari Paket NPM

Jawaban singkat: hal utama tentang Memory Wiki OpenClaw Gagal Dimuat karena Dependency Hilang dari Paket NPM adalah ini: Memory Wiki OpenClaw bisa gagal dimuat karena dependency runtime hilang dari paket NPM. Cek versi terdampak, diagnosis, dan mitigasi aman.

Memory Wiki OpenClaw dapat gagal dimuat pada instalasi bersih karena mdast-util-from-markdown tidak tersedia dalam dependency tree paket NPM resmi.

Memory Wiki OpenClaw Gagal Dimuat karena Dependency Hilang dari Paket NPM

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 latest masih 2026.7.1-2, beta sudah 2026.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:

  1. OpenClaw membawa Memory Wiki sebagai plugin bundled.
  2. Manifest plugin mencantumkan [email protected].
  3. Kode plugin mengimpor package tersebut secara langsung.
  4. Dependency tidak ada pada lokasi yang dapat di-resolve dari plugin.
  5. 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:

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:

  1. Pastikan versi yang diperiksa sama dengan versi yang benar-benar dijalankan Gateway.
  2. Jalankan inventory atau doctor plugin sesuai prosedur operasional host.
  3. Cari error resolution yang menyebut mdast-util-from-markdown atau Memory Wiki belum terpasang lengkap.
  4. Cek apakah masalah muncul setelah clean install, upgrade, atau rebuild dependency tree.
  5. 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:

  1. perbaikan masuk ke repository resmi;
  2. test package artifact memverifikasi resolution dari root plugin;
  3. tarball NPM baru lolos clean install;
  4. 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.

Sumber resmi

Lanjut membaca

Artikel yang masih relevan

Cara Komunikasi Antar Bot OpenClaw di Telegram: Update Terbaru
OpenClaw & AI Operasional

Cara Komunikasi Antar Bot OpenClaw di Telegram: Update Terbaru

Telegram resmi merilis Bot-to-Bot Communication pada 7 Mei 2026. Ini panduan praktis agar bot OpenClaw bisa saling bicara di Telegram, lengkap dengan setting BotFather, allowlist, reload gateway, dan best practice keamanannya.