Wiki memori - OpenClaw

memory-wiki adalah plugin bawaan yang mengubah memori tahan lama menjadi khazanah pengetahuan terkompilasi. Ini tidak menggantikan plugin memori aktif. Plugin memori aktif tetap memiliki recall, promotion, indexing, dan dreaming. memory-wiki berada di sampingnya dan mengompilasi pengetahuan tahan lama menjadi wiki yang dapat dinavigasi dengan halaman deterministik, klaim terstruktur, asal-usul, dasbor, dan digest yang dapat dibaca mesin. Gunakan ini saat Anda ingin memori berperilaku lebih seperti lapisan pengetahuan yang terpelihara dan bukan seperti tumpukan berkas Markdown.

Yang ditambahkan

Vault wiki khusus dengan tata letak halaman deterministik
Metadata klaim dan bukti terstruktur, bukan sekadar prosa
Asal-usul, keyakinan, kontradiksi, dan pertanyaan terbuka tingkat halaman
Digest terkompilasi untuk konsumen agen/runtime
Alat pencarian/pengambilan/penerapan/lint asli wiki
Impor Open Knowledge Format ke dalam konsep wiki terkompilasi
Mode bridge opsional yang mengimpor artefak publik dari plugin memori aktif
Mode render ramah Obsidian dan integrasi CLI opsional

Kesesuaiannya dengan memori

Pikirkan pemisahannya seperti ini:

Lapisan	Memiliki
Plugin memori aktif (`memory-core`, QMD, Honcho, dll.)	Recall, pencarian semantik, promotion, dreaming, runtime memori
`memory-wiki`	Halaman wiki terkompilasi, sintesis kaya asal-usul, dasbor, pencarian/pengambilan/penerapan khusus wiki

Jika plugin memori aktif mengekspos artefak recall bersama, OpenClaw dapat mencari kedua lapisan dalam satu lintasan dengan memory_search corpus=all. Saat Anda membutuhkan pemeringkatan khusus wiki, asal-usul, atau akses halaman langsung, gunakan alat asli wiki sebagai gantinya.

Pola hibrida yang direkomendasikan

Default yang kuat untuk setup local-first adalah:

QMD sebagai backend memori aktif untuk recall dan pencarian semantik luas
memory-wiki dalam mode bridge untuk halaman pengetahuan tersintesis yang tahan lama

Pemisahan itu bekerja dengan baik karena setiap lapisan tetap fokus:

QMD menjaga catatan mentah, ekspor sesi, dan koleksi tambahan tetap dapat dicari
memory-wiki mengompilasi entitas stabil, klaim, dasbor, dan halaman sumber

Aturan praktis:

gunakan memory_search saat Anda menginginkan satu lintasan recall luas di seluruh memori
gunakan wiki_search dan wiki_get saat Anda menginginkan hasil wiki yang sadar asal-usul
gunakan memory_search corpus=all saat Anda ingin pencarian bersama mencakup kedua lapisan

Jika mode bridge melaporkan nol artefak yang diekspor, plugin memori aktif saat ini belum mengekspos input bridge publik. Jalankan openclaw wiki doctor terlebih dahulu, lalu pastikan plugin memori aktif mendukung artefak publik. Saat mode bridge aktif dan bridge.readMemoryArtifacts diaktifkan, openclaw wiki status, openclaw wiki doctor, dan openclaw wiki bridge import membaca melalui Gateway yang sedang berjalan. Ini menjaga pemeriksaan bridge CLI tetap selaras dengan konteks plugin memori runtime. Jika bridge dinonaktifkan atau pembacaan artefak dimatikan, perintah tersebut mempertahankan perilaku lokal/offline-nya.

Mode vault

memory-wiki mendukung tiga mode vault:

`isolated`

Vault sendiri, sumber sendiri, tanpa dependensi pada memory-core. Gunakan ini saat Anda ingin wiki menjadi penyimpanan pengetahuan terkurasi tersendiri.

`bridge`

Membaca artefak memori publik dan peristiwa memori dari plugin memori aktif melalui batas plugin SDK publik. Gunakan ini saat Anda ingin wiki mengompilasi dan mengatur artefak yang diekspor plugin memori tanpa masuk ke internal plugin privat. Mode bridge dapat mengindeks:

artefak memori yang diekspor
laporan dream
catatan harian
berkas root memori
log peristiwa memori

`unsafe-local`

Escape hatch same-machine eksplisit untuk path privat lokal. Mode ini sengaja eksperimental dan tidak portabel. Gunakan hanya saat Anda memahami batas kepercayaan dan secara khusus membutuhkan akses sistem berkas lokal yang tidak dapat disediakan mode bridge.

Tata letak vault

Plugin menginisialisasi vault seperti ini:

<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. Grup halaman utama adalah:

sources/ untuk materi mentah yang diimpor dan halaman berbasis bridge
entities/ untuk hal tahan lama, orang, sistem, proyek, dan objek
concepts/ untuk gagasan, abstraksi, pola, dan kebijakan
syntheses/ untuk ringkasan terkompilasi dan rollup terpelihara
reports/ untuk dasbor yang dihasilkan

Impor Open Knowledge Format

memory-wiki dapat mengimpor bundel Open Knowledge Format yang sudah diekstrak dengan:

openclaw wiki okf import ./bundles/ga4

Ini paling cocok ketika katalog data, crawler dokumentasi, atau agen enrichment sudah menghasilkan OKF: pertahankan OKF sebagai artefak pertukaran portabel, lalu biarkan memory-wiki mengubahnya menjadi halaman konsep native OpenClaw dan digest terkompilasi. Importer mengikuti bentuk OKF v0.1:

berkas .md non-reserved adalah dokumen konsep
setiap konsep yang diimpor membutuhkan kolom frontmatter type yang tidak kosong
nilai type OKF yang tidak dikenal diterima
berkas reserved index.md dan log.md tidak diimpor sebagai konsep
tautan markdown yang rusak atau eksternal dipertahankan

Halaman konsep yang diimpor diratakan di bawah concepts/ sehingga jalur compile, search, get, dashboard, dan prompt-digest yang ada melihatnya tanpa menambahkan pohon wiki kedua. Setiap halaman mempertahankan ID konsep OKF asli, path sumber, type, resource, tags, timestamp, dan frontmatter producer lengkap. Tautan OKF internal ditulis ulang ke halaman konsep wiki yang dihasilkan dan juga dipancarkan sebagai entri relationships terstruktur dengan kind: okf-link.

Klaim dan bukti terstruktur

Halaman dapat membawa frontmatter claims terstruktur, bukan sekadar teks bebas. Setiap klaim dapat mencakup:

id
text
status
confidence
evidence[]
updatedAt

Entri bukti dapat mencakup:

kind
sourceId
path
lines
weight
confidence
privacyTier
note
updatedAt

Inilah yang membuat wiki bertindak lebih seperti lapisan keyakinan daripada dump catatan pasif. Klaim dapat dilacak, dinilai, dipertentangkan, dan diselesaikan kembali ke sumber.

Metadata entitas untuk agen

Halaman entitas juga dapat membawa metadata routing untuk penggunaan agen. Ini adalah frontmatter generik, sehingga bekerja untuk orang, tim, sistem, proyek, atau jenis entitas lain apa pun. Kolom umum mencakup:

entityType: misalnya person, team, system, atau project
canonicalId: kunci identitas stabil yang digunakan lintas alias dan impor
aliases: nama, handle, atau label yang harus mengarah ke halaman yang sama
privacyTier: public, local-private, sensitive, atau confirm-before-use
bestUsedFor / notEnoughFor: petunjuk routing ringkas
lastRefreshedAt: timestamp refresh sumber yang terpisah dari waktu edit halaman
personCard: kartu routing khusus orang opsional dengan handle, sosial, email, zona waktu, lane, ask-for, avoid-asking-for, keyakinan, dan privasi
relationships: edge bertipe ke halaman terkait dengan target, kind, weight, keyakinan, jenis bukti, tingkat privasi, dan catatan

Untuk wiki orang, agen biasanya harus memulai dari reports/person-agent-directory.md, lalu membuka halaman orang dengan wiki_get sebelum menggunakan detail kontak atau fakta tersimpul. Contoh:

pageType: entity
entityType: person
id: entity.brad-groux
canonicalId: maintainer.brad-groux
aliases:
  - Brad
  - bgroux
privacyTier: local-private
bestUsedFor:
  - Microsoft Teams and Azure routing
notEnoughFor:
  - legal approval
lastRefreshedAt: "2026-04-29T00:00:00.000Z"
personCard:
  handles:
    - "@bgroux"
  socials:
    - "https://x.example/bgroux"
  emails:
    - brad@example.com
  timezone: America/Chicago
  lane: Microsoft ecosystem
  askFor:
    - Teams rollout questions
  avoidAskingFor:
    - unrelated billing decisions
  confidence: 0.8
  privacyTier: confirm-before-use
relationships:
  - targetId: entity.alice
    targetTitle: Alice
    kind: collaborates-with
    confidence: 0.7
    evidenceKind: discrawl-stat
claims:
  - id: claim.brad.teams
    text: Brad is useful for Microsoft Teams routing.
    status: supported
    confidence: 0.9
    evidence:
      - kind: maintainer-whois
        sourceId: source.maintainers
        privacyTier: local-private

Pipeline compile

Langkah compile membaca halaman wiki, menormalkan ringkasan, dan menghasilkan artefak stabil yang ditujukan untuk mesin di bawah:

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

Digest ini ada agar agen dan kode runtime tidak perlu mengekstrak halaman Markdown. Output terkompilasi juga menggerakkan:

pengindeksan wiki lintasan pertama untuk alur search/get
lookup claim-id kembali ke halaman pemilik
suplemen prompt ringkas
pembuatan laporan/dasbor

Dasbor dan laporan kesehatan

Saat render.createDashboards diaktifkan, compile memelihara dasbor di bawah reports/. Laporan bawaan mencakup:

reports/open-questions.md
reports/contradictions.md
reports/low-confidence.md
reports/claim-health.md
reports/stale-pages.md
reports/person-agent-directory.md
reports/relationship-graph.md
reports/provenance-coverage.md
reports/privacy-review.md

Laporan ini melacak hal seperti:

cluster catatan kontradiksi
cluster klaim yang bersaing
klaim yang kehilangan bukti terstruktur
halaman dan klaim berkeyakinan rendah
freshness yang usang atau tidak diketahui
halaman dengan pertanyaan yang belum terselesaikan
kartu routing orang/entitas
edge hubungan terstruktur
cakupan kelas bukti
tingkat privasi non-publik yang perlu ditinjau sebelum digunakan

Pencarian dan pengambilan

memory-wiki mendukung dua backend pencarian:

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

Ini juga mendukung tiga korpus:

wiki
memory
all

Perilaku penting:

wiki_search dan wiki_get menggunakan digest terkompilasi sebagai lintasan pertama saat memungkinkan
ID klaim dapat diselesaikan kembali ke halaman pemilik
klaim yang dipertentangkan/usang/segar memengaruhi pemeringkatan
label asal-usul dapat bertahan ke dalam hasil
mode pencarian dapat membiaskan pemeringkatan untuk pencarian orang, routing pertanyaan, sumber bukti, atau klaim mentah

Aturan praktis:

gunakan memory_search corpus=all untuk satu lintasan recall luas
gunakan wiki_search + wiki_get saat Anda peduli dengan pemeringkatan khusus wiki, asal-usul, atau struktur keyakinan tingkat halaman

Mode pencarian:

auto: default seimbang
find-person: tingkatkan entitas mirip orang, alias, handle, sosial, dan ID kanonis
route-question: tingkatkan kartu agen, petunjuk ask-for, petunjuk best-used-for, dan konteks hubungan
source-evidence: tingkatkan halaman sumber dan metadata bukti terstruktur
raw-claim: tingkatkan klaim terstruktur yang cocok dan kembalikan metadata klaim/bukti dalam hasil

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

Alat agen

Plugin mendaftarkan alat berikut:

wiki_status
wiki_search
wiki_get
wiki_apply
wiki_lint

Yang dilakukan alat tersebut:

wiki_status: mode vault saat ini, kesehatan, ketersediaan CLI Obsidian
wiki_search: mencari halaman wiki dan, saat dikonfigurasi, korpora memori bersama; menerima mode untuk pencarian orang, routing pertanyaan, bukti sumber, atau drilldown klaim mentah
wiki_get: membaca halaman wiki berdasarkan id/path atau fallback ke korpus memori bersama
wiki_apply: mutasi sintesis/metadata sempit tanpa operasi halaman bebas
wiki_lint: pemeriksaan struktural, celah asal-usul, kontradiksi, pertanyaan terbuka

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

Perilaku prompt dan konteks

Ketika context.includeCompiledDigestPrompt diaktifkan, bagian prompt memori menambahkan snapshot terkompilasi yang ringkas dari agent-digest.json. Snapshot tersebut sengaja dibuat kecil dan bernilai sinyal tinggi:

hanya halaman teratas
hanya klaim teratas
jumlah kontradiksi
jumlah pertanyaan
penanda keyakinan/kebaruan

Ini bersifat opt-in karena mengubah bentuk prompt dan terutama berguna untuk mesin konteks atau perakitan prompt lama yang secara eksplisit mengonsumsi suplemen memori.

Konfigurasi

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

{
  plugins: {
    entries: {
      "memory-wiki": {
        enabled: true,
        config: {
          vaultMode: "isolated",
          vault: {
            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,
          },
          ingest: {
            autoCompile: true,
            maxConcurrentJobs: 1,
            allowUrlIngest: true,
          },
          search: {
            backend: "shared",
            corpus: "wiki",
          },
          context: {
            includeCompiledDigestPrompt: false,
          },
          render: {
            preserveHumanBlocks: true,
            createBacklinks: true,
            createDashboards: true,
          },
        },
      },
    },
  },
}

Toggle utama:

vaultMode: isolated, bridge, unsafe-local
vault.renderMode: native atau obsidian
bridge.readMemoryArtifacts: impor artefak publik plugin memori aktif
bridge.followMemoryEvents: sertakan log peristiwa dalam mode bridge
search.backend: shared atau local
search.corpus: wiki, memory, atau all
context.includeCompiledDigestPrompt: tambahkan snapshot digest ringkas ke bagian prompt memori
render.createBacklinks: buat blok terkait yang deterministik
render.createDashboards: buat halaman dasbor

Contoh: mode QMD + bridge

Gunakan ini ketika Anda menginginkan QMD untuk recall dan memory-wiki untuk lapisan pengetahuan yang dipelihara:

{
  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 mempertahankan:

QMD bertanggung jawab atas recall memori aktif
memory-wiki berfokus pada halaman terkompilasi dan dasbor
bentuk prompt tidak berubah hingga Anda sengaja mengaktifkan prompt digest terkompilasi

CLI

memory-wiki juga mengekspos permukaan CLI tingkat atas:

openclaw wiki status
openclaw wiki doctor
openclaw wiki init
openclaw wiki ingest ./notes/alpha.md
openclaw wiki compile
openclaw wiki lint
openclaw wiki search "alpha"
openclaw wiki get entity.alpha
openclaw wiki apply synthesis "Alpha Summary" --body "..." --source-id source.alpha
openclaw wiki bridge import
openclaw wiki obsidian status

Lihat CLI: wiki untuk referensi perintah lengkap.

Dukungan Obsidian

Ketika vault.renderMode adalah obsidian, plugin menulis Markdown yang ramah Obsidian dan secara opsional dapat menggunakan CLI obsidian resmi. Workflow yang didukung mencakup:

pemeriksaan status
pencarian vault
membuka halaman
menjalankan perintah Obsidian
melompat ke catatan harian

Ini opsional. Wiki tetap berfungsi dalam mode native tanpa Obsidian.

Workflow yang direkomendasikan

Pertahankan plugin memori aktif Anda untuk recall/promosi/Dreaming.
Aktifkan memory-wiki.
Mulai dengan mode isolated kecuali Anda secara eksplisit menginginkan mode bridge.
Gunakan wiki_search / wiki_get ketika provenance penting.
Gunakan wiki_apply untuk sintesis sempit atau pembaruan metadata.
Jalankan wiki_lint setelah perubahan yang bermakna.
Aktifkan dasbor jika Anda menginginkan visibilitas stale/kontradiksi.

​Yang ditambahkan

​Kesesuaiannya dengan memori

​Pola hibrida yang direkomendasikan

​Mode vault

​isolated

​bridge

​unsafe-local

​Tata letak vault

​Impor Open Knowledge Format

​Klaim dan bukti terstruktur

​Metadata entitas untuk agen

​Pipeline compile

​Dasbor dan laporan kesehatan

​Pencarian dan pengambilan

​Alat agen

​Perilaku prompt dan konteks

​Konfigurasi

​Contoh: mode QMD + bridge

​CLI

​Dukungan Obsidian

​Workflow yang direkomendasikan

​Dokumen terkait