Wiki memori

memory-wiki adalah plugin bawaan yang mengompilasi pengetahuan tahan lama menjadi wiki yang dapat dinavigasi: halaman deterministik, klaim terstruktur dengan bukti, asal-usul, dasbor, dan ringkasan yang dapat dibaca mesin.

Plugin ini tidak menggantikan plugin Active Memory. Pemanggilan kembali, promosi, pengindeksan, dan Dreaming tetap dikelola oleh backend memori mana pun yang dikonfigurasi (memory-core, QMD, Honcho, dll.). memory-wiki berjalan berdampingan dengannya dan mengompilasi pengetahuan menjadi lapisan wiki yang terpelihara.

Aktifkan plugin sebelum menggunakan CLI, alat, atau integrasi runtime-nya:

openclaw plugins enable memory-wikiopenclaw gateway restart

Aturan praktis:

• memory_search untuk satu pemanggilan kembali luas di seluruh korpus yang dikonfigurasi
• wiki_search / wiki_get saat Anda menginginkan pemeringkatan khusus wiki, asal-usul, atau struktur keyakinan tingkat halaman
• memory_search corpus=all untuk mencakup kedua lapisan dalam satu panggilan, ketika plugin Active Memory mendukung pemilihan korpus

Penyiapan lokal-utama yang umum: QMD sebagai backend Active Memory untuk pemanggilan kembali, dan memory-wiki dalam mode bridge untuk halaman sintesis yang tahan lama. Lihat contoh mode QMD + bridge di bagian Konfigurasi.

Jika mode bridge melaporkan nol artefak yang diekspor, plugin Active Memory saat ini tidak mengekspos input bridge publik. Jalankan openclaw wiki doctor terlebih dahulu, lalu pastikan plugin Active Memory mendukung artefak publik.

Mode vault

• isolated (default): vault sendiri, sumber sendiri, tanpa dependensi pada plugin Active Memory. Gunakan ini untuk penyimpanan pengetahuan terkurasi yang mandiri.
• bridge: membaca artefak memori publik dan log peristiwa dari plugin Active Memory melalui antarmuka SDK plugin publik. Gunakan ini untuk mengompilasi artefak yang diekspor oleh plugin memori tanpa mengakses internal plugin privat.
• unsafe-local: jalur keluar eksplisit pada mesin yang sama untuk jalur lokal privat. Sengaja bersifat eksperimental dan tidak portabel; gunakan hanya jika Anda memahami batas kepercayaan dan secara khusus memerlukan akses sistem berkas lokal yang tidak dapat disediakan oleh mode bridge.

Mode vault dan cakupan vault adalah pilihan yang terpisah:

• vaultMode memilih dari mana input wiki berasal.
• vault.scope memilih apakah semua agen menggunakan satu vault atau setiap agen mendapatkan vault turunan.

vault.scope: "global" adalah default dan mempertahankan perilaku satu vault yang ada. Gunakan vault.scope: "agent" dengan mode isolated atau bridge ketika agen tidak boleh berbagi halaman wiki, ringkasan terkompilasi, hasil pencarian, atau penulisan. Cakupan agen tidak dapat digabungkan dengan mode unsafe-local karena jalur privat yang dikonfigurasi tersebut bukan input milik agen. Validasi konfigurasi menolak kombinasi ini.

Mode bridge dapat mengindeks, sesuai toggle konfigurasi bridge.*:

• artefak memori yang diekspor (indexMemoryRoot)
• catatan harian (indexDailyNotes)
• laporan Dreaming (indexDreamReports)
• log peristiwa memori (followMemoryEvents)

Saat mode bridge aktif dan bridge.readMemoryArtifacts diaktifkan, openclaw wiki status, openclaw wiki doctor, dan openclaw wiki bridge import dirutekan melalui Gateway yang berjalan agar melihat konteks plugin Active Memory yang sama dengan memori agen/runtime. Jika bridge dinonaktifkan atau pembacaan artefak dimatikan, perintah tersebut mempertahankan perilaku lokal/luring.

Tata letak vault

<vault>/  AGENTS.md  WIKI.md  index.md  inbox.md  entities/  concepts/  syntheses/  sources/  reports/  _attachments/  _views/  .openclaw-wiki/

Konten terkelola tetap berada di dalam blok yang dihasilkan; blok catatan manusia dipertahankan selama regenerasi.

• sources/: materi mentah yang diimpor dan halaman yang didukung bridge/unsafe-local
• entities/: hal, orang, sistem, proyek, dan objek yang tahan lama
• concepts/: gagasan, abstraksi, pola, kebijakan (juga menjadi tujuan impor OKF)
• syntheses/: ringkasan terkompilasi dan rekapitulasi yang terpelihara
• reports/: dasbor yang dihasilkan

Impor Open Knowledge Format

openclaw wiki okf import ./bundles/ga4

Impor bundel Open Knowledge Format yang telah diekstrak ke halaman konsep wiki. Sangat cocok ketika katalog data, perayap dokumentasi, atau agen pengayaan telah menghasilkan OKF: pertahankan OKF sebagai artefak pertukaran portabel, lalu biarkan memory-wiki mengubahnya menjadi halaman konsep asli OpenClaw dan ringkasan terkompilasi.

• berkas .md yang tidak dicadangkan adalah dokumen konsep
• setiap konsep yang diimpor memerlukan bidang frontmatter type yang tidak kosong; type yang tidak ada menghasilkan peringatan missing-type dan berkas dilewati
• nilai type yang tidak dikenal diterima sebagai konsep generik
• index.md dan log.md dicadangkan dan tidak pernah diimpor sebagai konsep
• tautan markdown yang rusak atau eksternal dibiarkan tidak berubah

Halaman yang diimpor diratakan di bawah concepts/ agar alur kompilasi, pencarian, pengambilan, dan dasbor yang ada dapat melihatnya tanpa pohon wiki kedua. Setiap halaman mempertahankan ID konsep OKF asli, jalur sumber, type, resource, tags, stempel waktu, dan seluruh frontmatter produsen. Tautan OKF internal ditulis ulang ke halaman konsep wiki yang dihasilkan dan juga menghasilkan entri relationships terstruktur dengan kind: okf-link.

Klaim dan bukti terstruktur

Halaman membawa frontmatter claims terstruktur, bukan hanya teks bebas. Setiap klaim dapat mencakup id, text, status, confidence, evidence[], dan updatedAt. Setiap entri bukti dapat mencakup kind, sourceId, path, lines, weight, confidence, privacyTier, note, dan updatedAt.

Hal ini membuat wiki berperilaku seperti lapisan keyakinan, bukan tempat pembuangan catatan pasif. Klaim dapat dilacak, dinilai, disanggah, dan ditelusuri kembali ke sumbernya untuk diselesaikan.

Metadata entitas untuk agen

Halaman entitas membawa metadata perutean generik yang dapat digunakan untuk orang, tim, sistem, proyek, atau jenis entitas lainnya:

• entityType: misalnya person, team, system, project
• canonicalId: kunci identitas stabil di seluruh alias dan impor
• aliases: nama, handle, atau label yang mengarah ke halaman yang sama
• privacyTier: string bebas; public dianggap tidak memerlukan review, nilai lainnya (misalnya local-private, sensitive, confirm-before-use) ditandai dalam reports/privacy-review.md
• bestUsedFor / notEnoughFor: petunjuk perutean ringkas
• lastRefreshedAt: stempel waktu penyegaran sumber, terpisah dari waktu pengeditan halaman
• personCard: kartu perutean opsional khusus orang (handle, media sosial, email, zona waktu, jalur, hal yang dapat diminta, hal yang sebaiknya tidak diminta, tingkat keyakinan, tingkat privasi)
• relationships: edge bertipe ke halaman terkait (target, jenis, bobot, tingkat keyakinan, jenis bukti, tingkat privasi, catatan)

Untuk wiki orang, mulai dengan reports/person-agent-directory.md, lalu buka halaman orang tersebut dengan wiki_get sebelum menggunakan detail kontak atau fakta yang disimpulkan.

pageType: entityentityType: personid: entity.example-personcanonicalId: maintainer.example-personaliases:- Alex- example-handleprivacyTier: local-privatebestUsedFor:- Perutean ekosistem contohnotEnoughFor:- persetujuan hukumlastRefreshedAt: "2026-04-29T00:00:00.000Z"personCard:handles:  - "@example-handle"socials:  - "https://x.example/example-handle"emails:  - alex@example.comtimezone: America/Chicagolane: Ekosistem contohaskFor:  - Pertanyaan peluncuran contohavoidAskingFor:  - keputusan penagihan yang tidak terkaitconfidence: 0.8privacyTier: confirm-before-userelationships:- targetId: entity.other-person  targetTitle: Orang Lain  kind: collaborates-with  confidence: 0.7  evidenceKind: discrawl-statclaims:- id: claim.example.routing  text: Alex berguna untuk perutean ekosistem contoh.  status: supported  confidence: 0.9  evidence:    - kind: maintainer-whois      sourceId: source.maintainers      privacyTier: local-private

Pipeline kompilasi

Kompilasi membaca halaman wiki, menormalisasi ringkasan, dan menyimpan snapshot untuk mesin dalam status plugin SQLite bersama milik OpenClaw. Kode runtime menggunakan snapshot pemilik yang dikelola siklus hidup untuk memuat SQLite selama persiapan prompt asinkron; perakitan prompt sinkron tidak pernah mengeruk Markdown atau membaca berkas cache. Output terkompilasi juga mendukung pengindeksan wiki tahap pertama untuk pencarian/pengambilan, pencarian ID klaim kembali ke halaman pemiliknya, pelengkap prompt ringkas, dan pembuatan laporan.

Pengeditan sumber dan pemulihan vault baru tersedia untuk mesin setelah kompilasi berikutnya. Memulai ulang atau menyegarkan siklus hidup plugin membandingkan publikasi kompilasi vault yang dirantai secara kausal dengan SQLite dan menolak snapshot dari status lebih baru yang telah di-roll back. Kompilator yang dimulai sebelum rollback tidak dapat menerbitkan terhadap pendahulu yang dipulihkan. Persiapan prompt tidak melakukan polling terhadap vault atau memasang pemantau berkas. Setelah karantina rollback, kompilasi dalam proses yang sedang berjalan segera menghapus pemilik; proses kompilator terpisah memerlukan penyegaran siklus hidup plugin agar daemon dapat mengonfirmasi publikasi tahan lama yang baru. Cache terkompilasi dapat dibangun ulang: baris cache dari sebelum epoch publikasi dianggap sebagai cache miss dan diganti oleh kompilasi berikutnya; baris tersebut tidak dimigrasikan.

Dasbor dan laporan kesehatan

Saat render.createDashboards diaktifkan, kompilasi memelihara dasbor di bawah reports/:

Pencarian dan pengambilan

Dua backend pencarian:

• shared: gunakan alur pencarian memori bersama jika tersedia
• local: cari wiki secara lokal

Tiga korpus: wiki, memory, all.

• wiki_search / wiki_get menggunakan ringkasan terkompilasi sebagai tahap pertama jika memungkinkan
• ID klaim mengarah kembali ke halaman pemiliknya
• klaim yang disengketakan/usang/segar memengaruhi pemeringkatan
• label asal-usul tetap dipertahankan dalam hasil

Mode pencarian (parameter --mode / alat mode):

Saat hasil cocok dengan klaim terstruktur, wiki_search mengembalikan matchedClaimId, matchedClaimStatus, matchedClaimConfidence, evidenceKinds, dan evidenceSourceIds dalam payload detailnya. Output teks menyertakan baris ringkas Claim: dan Evidence: jika tersedia.

Alat agen

Plugin juga mendaftarkan suplemen korpus memori non-eksklusif, sehingga memory_search dan memory_get bersama dapat menjangkau wiki saat Plugin memori aktif mendukung pemilihan korpus.

Perilaku prompt dan konteks

Saat context.includeCompiledDigestPrompt diaktifkan, bagian prompt memori menambahkan snapshot terkompilasi yang ringkas dari status Plugin: hanya halaman teratas, hanya klaim teratas, jumlah kontradiksi, jumlah pertanyaan, serta kualifikasi keyakinan/kebaruan. Fitur ini bersifat opt-in karena mengubah bentuk prompt; terutama relevan untuk mesin konteks atau perakitan prompt yang secara eksplisit menggunakan suplemen memori.

Konfigurasi

Letakkan konfigurasi di bawah plugins.entries.memory-wiki.config:

{  plugins: {    entries: {      "memory-wiki": {        enabled: true,        config: {          vaultMode: "isolated",          vault: {            scope: "global",            path: "~/.openclaw/wiki/main",            renderMode: "obsidian",          },          obsidian: {            enabled: true,            useOfficialCli: true,            vaultName: "OpenClaw Wiki",            openAfterWrites: false,          },          bridge: {            enabled: false,            readMemoryArtifacts: true,            indexDreamReports: true,            indexDailyNotes: true,            indexMemoryRoot: true,            followMemoryEvents: true,          },          unsafeLocal: {            allowPrivateMemoryCoreAccess: false,            paths: [],          },          ingest: {            autoCompile: true,            maxConcurrentJobs: 1,            allowUrlIngest: true,          },          search: {            backend: "shared",            corpus: "wiki",          },          context: {            includeCompiledDigestPrompt: false,          },          render: {            preserveHumanBlocks: true,            createBacklinks: true,            createDashboards: true,          },        },      },    },  },}

Pengaturan utama:

Vault per agen

Atur vault.scope ke agent untuk memberikan wiki terpisah kepada setiap agen yang dikonfigurasi. Dalam cakupan ini, vault.path adalah direktori induk dan OpenClaw menambahkan id agen yang telah dinormalisasi:

{  agents: {    list: [{ id: "support" }, { id: "marketing" }],  },  plugins: {    entries: {      "memory-wiki": {        enabled: true,        config: {          vaultMode: "bridge",          vault: {            scope: "agent",            path: "~/.openclaw/wiki",          },          bridge: {            enabled: true,            readMemoryArtifacts: true,          },        },      },    },  },}

Ini ditetapkan menjadi ~/.openclaw/wiki/support dan ~/.openclaw/wiki/marketing. Jika vault.path dihilangkan dalam cakupan agen, induk secara default menjadi ~/.openclaw/wiki. Oleh karena itu, agen main default tetap menggunakan jalur ~/.openclaw/wiki/main yang ada.

Alat agen, ringkasan prompt terkompilasi, dan suplemen wiki yang diekspos melalui memory_search / memory_get menetapkan vault dari konteks agen aktif. Untuk panggilan CLI dan Gateway dalam pengaturan dengan beberapa agen yang dikonfigurasi, berikan agen secara eksplisit dengan openclaw wiki --agent <agentId> ... atau agentId milik permintaan Gateway. Satu agen yang dikonfigurasi tetap menjadi default jika tidak ada id yang diberikan.

Dalam mode bridge, impor dengan cakupan agen hanya menerima artefak memori publik jika agentIds-nya menyertakan agen yang dipilih. Artefak yang dimiliki agen lain, tanpa metadata kepemilikan, atau dengan pemilik yang tidak diketahui akan dilewati. Cakupan global mempertahankan perilaku artefak bersama yang ada.

Contoh: QMD + mode bridge

Gunakan ini saat Anda menginginkan QMD untuk pengingatan dan memory-wiki untuk lapisan pengetahuan yang dipelihara. Setiap lapisan tetap terfokus: QMD menjaga agar catatan mentah, ekspor sesi, dan koleksi tambahan dapat dicari, sedangkan memory-wiki mengompilasi entitas stabil, klaim, dasbor, dan halaman sumber.

{  memory: {    backend: "qmd",  },  plugins: {    entries: {      "memory-wiki": {        enabled: true,        config: {          vaultMode: "bridge",          bridge: {            enabled: true,            readMemoryArtifacts: true,            indexDreamReports: true,            indexDailyNotes: true,            indexMemoryRoot: true,            followMemoryEvents: true,          },          search: {            backend: "shared",            corpus: "all",          },          context: {            includeCompiledDigestPrompt: false,          },        },      },    },  },}

Ini membuat QMD tetap menangani pengingatan memori aktif, memory-wiki berfokus pada halaman terkompilasi dan dasbor, serta mempertahankan bentuk prompt tanpa perubahan hingga Anda secara sengaja mengaktifkan prompt ringkasan terkompilasi.

CLI

openclaw wiki statusopenclaw wiki doctoropenclaw wiki initopenclaw wiki ingest ./notes/alpha.mdopenclaw wiki compileopenclaw wiki lintopenclaw wiki search "alpha"openclaw wiki get entity.alphaopenclaw wiki apply synthesis "Alpha Summary" --body "..." --source-id source.alphaopenclaw wiki bridge importopenclaw wiki obsidian status

Lihat CLI: wiki untuk referensi perintah lengkap, termasuk wiki okf import, wiki apply metadata, wiki unsafe-local import, wiki chatgpt import / wiki chatgpt rollback, dan rangkaian lengkap subperintah wiki obsidian.

Dukungan Obsidian

Saat vault.renderMode bernilai obsidian, Plugin menulis Markdown yang ramah Obsidian dan dapat secara opsional menggunakan CLI resmi obsidian untuk pemeriksaan status, pencarian vault, membuka halaman, menjalankan perintah, dan beralih ke catatan harian. Fitur ini opsional; wiki tetap berfungsi dalam mode asli tanpa Obsidian.

Vault dengan cakupan agen tetap dapat menggunakan Markdown yang ramah Obsidian, tetapi validasi konfigurasi menolak obsidian.useOfficialCli: true dengan vault.scope: "agent". Pengaturan obsidian.vaultName saat ini bersifat global dan tidak dapat memilih vault Obsidian yang berbeda untuk setiap agen. Sebagai gantinya, gunakan alat wiki dan operasi CLI, atau pertahankan wiki yang dioperasikan Obsidian dalam cakupan global.

Alur kerja yang direkomendasikan

Dokumentasi terkait

• Ikhtisar Memori
• CLI: memori
• CLI: wiki
• Ikhtisar SDK Plugin