Wiki memori

memory-wiki adalah plugin bawaan yang mengompilasi pengetahuan persisten 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 memori aktif. Pengingatan kembali, promosi, pengindeksan, dan Dreaming tetap dimiliki oleh backend memori apa pun yang dikonfigurasi (memory-core, QMD, Honcho, dan sebagainya). memory-wiki berada di sampingnya dan mengompilasi pengetahuan menjadi lapisan wiki yang terpelihara.

Aturan praktis:

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

Konfigurasi lokal sebagai prioritas yang umum: QMD sebagai backend memori aktif untuk pengingatan kembali, dan memory-wiki dalam mode bridge untuk halaman sintesis persisten. Lihat contoh mode QMD + bridge di bagian Konfigurasi.

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

Mode vault

• isolated (bawaan): vault sendiri, sumber sendiri, tanpa dependensi pada plugin memori aktif. Gunakan ini untuk penyimpanan pengetahuan terkurasi yang mandiri.
• bridge: membaca artefak memori publik dan log peristiwa dari plugin memori aktif melalui jalur SDK plugin publik. Gunakan ini untuk mengompilasi artefak yang diekspor plugin memori tanpa mengakses bagian internal privat plugin.
• unsafe-local: jalan keluar eksplisit untuk mesin yang sama bagi jalur privat lokal. 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 terpisah:

• vaultMode memilih asal masukan wiki.
• vault.scope memilih apakah semua agen menggunakan satu vault atau setiap agen mendapatkan vault turunan.

vault.scope: "global" adalah bawaan dan mempertahankan perilaku satu vault yang sudah 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 masukan milik agen. Validasi konfigurasi menolak kombinasi ini.

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

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

Ketika mode bridge aktif dan bridge.readMemoryArtifacts diaktifkan, openclaw wiki status, openclaw wiki doctor, dan openclaw wiki bridge import dirutekan melalui Gateway yang sedang berjalan agar melihat konteks plugin memori aktif 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 saat pembuatan ulang.

• sources/: materi mentah yang diimpor serta halaman yang didukung bridge/unsafe-local
• entities/: hal, orang, sistem, proyek, dan objek yang persisten
• concepts/: gagasan, abstraksi, pola, kebijakan (juga menjadi lokasi tujuan impor OKF)
• syntheses/: ringkasan terkompilasi dan rekapitulasi yang dipelihara
• 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 sesuai ketika katalog data, perayap dokumentasi, atau agen pengayaan sudah 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 merupakan dokumen konsep
• setiap konsep yang diimpor memerlukan bidang frontmatter type yang tidak kosong; type yang tidak ada menghasilkan peringatan missing-type dan berkas tersebut 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 sudah 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 internal OKF ditulis ulang ke halaman konsep wiki yang dihasilkan dan juga menghasilkan entri relationships terstruktur dengan kind: okf-link.

Klaim dan bukti terstruktur

Halaman memuat frontmatter claims terstruktur, bukan sekadar 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, diberi skor, disanggah, dan ditelusuri kembali hingga sumbernya.

Metadata entitas untuk agen

Halaman entitas memuat 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, nama pengguna, atau label yang mengarah ke halaman yang sama
• privacyTier: string bentuk bebas; public diperlakukan sebagai tidak memerlukan peninjauan, nilai lainnya (misalnya local-private, sensitive, confirm-before-use) ditandai di reports/privacy-review.md
• bestUsedFor / notEnoughFor: petunjuk perutean ringkas
• lastRefreshedAt: stempel waktu penyegaran sumber, terpisah dari waktu penyuntingan halaman
• personCard: kartu perutean khusus orang opsional (nama pengguna, media sosial, email, zona waktu, jalur, hal yang dapat ditanyakan, hal yang sebaiknya tidak ditanyakan, tingkat keyakinan, tingkat privasi)
• relationships: sisi bertipe menuju 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

Alur kompilasi

Kompilasi membaca halaman wiki, menormalisasi ringkasan, dan menghasilkan artefak stabil untuk mesin di bawah:

• .openclaw-wiki/cache/agent-digest.json
• .openclaw-wiki/cache/claims.jsonl

Agen dan kode runtime membaca ringkasan ini alih-alih mengurai Markdown. Keluaran terkompilasi juga mendukung pengindeksan wiki tahap awal untuk pencarian/pengambilan, pencarian ID klaim kembali ke halaman pemiliknya, pelengkap prompt ringkas, dan pembuatan laporan.

Dasbor dan laporan kesehatan

Ketika 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 awal jika memungkinkan
• ID klaim mengarah kembali ke halaman pemiliknya
• klaim yang disengketakan/kedaluwarsa/terkini memengaruhi pemeringkatan
• label asal-usul tetap disertakan dalam hasil

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

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

Alat agen

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

Perilaku perintah dan konteks

Ketika context.includeCompiledDigestPrompt diaktifkan, bagian perintah memori menambahkan cuplikan terkompilasi ringkas dari agent-digest.json: hanya halaman teratas, hanya klaim teratas, jumlah kontradiksi, jumlah pertanyaan, serta penjelas tingkat keyakinan/kebaruan. Fitur ini bersifat opsional karena mengubah bentuk perintah; fitur ini terutama penting bagi mesin konteks atau perakitan perintah yang secara eksplisit menggunakan pelengkap 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,          },        },      },    },  },}

Pengalih 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 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,          },        },      },    },  },}

Konfigurasi ini ditetapkan menjadi ~/.openclaw/wiki/support dan ~/.openclaw/wiki/marketing. Jika vault.path dihilangkan dalam cakupan agen, induk secara bawaan adalah ~/.openclaw/wiki. Karena itu, agen main bawaan tetap menggunakan jalur ~/.openclaw/wiki/main yang sudah ada.

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

Dalam mode jembatan, impor bercakupan agen menerima artefak memori publik hanya ketika agentIds-nya menyertakan agen yang dipilih. Artefak milik agen lain, tanpa metadata kepemilikan, atau dengan pemilik yang tidak diketahui akan dilewati. Cakupan global mempertahankan perilaku artefak bersama yang sudah ada.

Contoh: QMD + mode jembatan

Gunakan ini ketika Anda menginginkan QMD untuk pemanggilan kembali dan memory-wiki untuk lapisan pengetahuan yang terpelihara. Setiap lapisan tetap fokus: QMD menjaga catatan mentah, ekspor sesi, dan koleksi tambahan agar 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,          },        },      },    },  },}

Konfigurasi ini mempertahankan QMD sebagai pengelola pemanggilan kembali memori aktif, menjaga memory-wiki tetap berfokus pada halaman terkompilasi dan dasbor, serta mempertahankan bentuk perintah hingga Anda sengaja mengaktifkan perintah 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 subperintah wiki obsidian lengkap.

Dukungan Obsidian

Ketika vault.renderMode adalah obsidian, Plugin menulis Markdown yang ramah Obsidian dan secara opsional dapat menggunakan CLI obsidian resmi untuk memeriksa status, mencari vault, membuka halaman, menjalankan perintah, dan berpindah ke catatan harian. Fitur ini opsional; wiki tetap berfungsi dalam mode asli tanpa Obsidian.

Vault bercakupan 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. Gunakan alat wiki dan operasi CLI sebagai gantinya, atau pertahankan wiki yang dioperasikan Obsidian dalam cakupan global.

Alur kerja yang disarankan

Dokumentasi terkait

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