Plugins

Wiki memori

memory-wiki adalah Plugin bawaan yang mengubah memori persisten menjadi brankas pengetahuan terkompilasi.

Ia tidak menggantikan Plugin Active Memory. Plugin Active Memory tetap memiliki recall, promosi, pengindeksan, dan Dreaming. memory-wiki berada di sampingnya dan mengompilasi pengetahuan persisten menjadi wiki yang dapat dinavigasi dengan halaman deterministik, klaim terstruktur, asal-usul, dasbor, dan digest yang dapat dibaca mesin.

Gunakan ini ketika Anda ingin memori berperilaku lebih seperti lapisan pengetahuan yang terpelihara dan lebih sedikit seperti tumpukan berkas Markdown.

Yang ditambahkan

Brankas wiki khusus dengan tata letak halaman deterministik
Metadata klaim dan bukti terstruktur, bukan hanya prosa
Asal-usul, keyakinan, kontradiksi, dan pertanyaan terbuka tingkat halaman
Digest terkompilasi untuk konsumen agen/runtime
Alat pencarian/pengambilan/penerapan/lint khusus wiki
Mode jembatan opsional yang mengimpor artefak publik dari Plugin Active Memory
Mode render ramah Obsidian dan integrasi CLI opsional

Bagaimana ini cocok dengan memori

Pikirkan pemisahannya seperti ini:

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

Jika Plugin Active Memory mengekspos artefak recall bersama, OpenClaw dapat mencari kedua lapisan dalam satu lintasan dengan memory_search corpus=all.

Ketika Anda membutuhkan pemeringkatan khusus wiki, asal-usul, atau akses halaman langsung, gunakan alat khusus wiki sebagai gantinya.

Pola hibrida yang direkomendasikan

Default yang kuat untuk penyiapan local-first adalah:

QMD sebagai backend Active Memory untuk recall dan pencarian semantik luas
memory-wiki dalam mode bridge untuk halaman pengetahuan tersintesis yang persisten

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 ketika Anda menginginkan satu lintasan recall luas di seluruh memori
gunakan wiki_search dan wiki_get ketika Anda menginginkan hasil wiki yang sadar asal-usul
gunakan memory_search corpus=all ketika Anda ingin pencarian bersama mencakup kedua lapisan

Jika mode jembatan melaporkan nol artefak yang diekspor, Plugin Active Memory saat ini belum mengekspos masukan jembatan publik. Jalankan openclaw wiki doctor terlebih dahulu, lalu pastikan Plugin Active Memory mendukung artefak publik.

Ketika mode jembatan 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 jembatan CLI tetap selaras dengan konteks Plugin memori runtime. Jika jembatan dinonaktifkan atau pembacaan artefak dimatikan, perintah tersebut tetap mempertahankan perilaku lokal/offline.

Mode brankas

memory-wiki mendukung tiga mode brankas:

`isolated`

Brankas sendiri, sumber sendiri, tanpa dependensi pada memory-core.

Gunakan ini ketika Anda ingin wiki menjadi penyimpanan pengetahuan terkurasi miliknya sendiri.

`bridge`

Membaca artefak memori publik dan peristiwa memori dari Plugin Active Memory melalui seam SDK Plugin publik.

Gunakan ini ketika Anda ingin wiki mengompilasi dan mengatur artefak yang diekspor Plugin memori tanpa masuk ke internal Plugin privat.

Mode jembatan dapat mengindeks:

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

`unsafe-local`

Jalur keluar eksplisit untuk path privat lokal pada mesin yang sama.

Mode ini sengaja eksperimental dan tidak portabel. Gunakan hanya ketika Anda memahami batas kepercayaan dan secara khusus membutuhkan akses sistem berkas lokal yang tidak dapat disediakan mode jembatan.

Tata letak brankas

Plugin menginisialisasi brankas 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 jembatan
entities/ untuk hal, orang, sistem, proyek, dan objek yang persisten
concepts/ untuk gagasan, abstraksi, pola, dan kebijakan
syntheses/ untuk ringkasan terkompilasi dan rollup yang dipelihara
reports/ untuk dasbor yang dihasilkan

Klaim dan bukti terstruktur

Halaman dapat membawa frontmatter claims terstruktur, bukan hanya 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 sekadar tempat pembuangan catatan pasif. Klaim dapat dilacak, dinilai, diperdebatkan, dan diselesaikan kembali ke sumber.

Metadata entitas yang menghadap agen

Halaman entitas juga dapat membawa metadata perutean untuk penggunaan agen. Ini adalah frontmatter generik, jadi berfungsi untuk orang, tim, sistem, proyek, atau jenis entitas lainnya.

Bidang 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 diselesaikan ke halaman yang sama
privacyTier: public, local-private, sensitive, atau confirm-before-use
bestUsedFor / notEnoughFor: petunjuk perutean ringkas
lastRefreshedAt: stempel waktu penyegaran sumber yang terpisah dari waktu edit halaman
personCard: kartu perutean khusus orang opsional dengan handle, sosial, email, zona waktu, jalur, minta-untuk, hindari-meminta-untuk, keyakinan, dan privasi
relationships: edge bertipe ke halaman terkait dengan target, jenis, bobot, keyakinan, jenis bukti, tingkat privasi, dan catatan

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

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:
    - [email protected]
  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 kompilasi

Langkah kompilasi membaca halaman wiki, menormalkan ringkasan, dan menghasilkan artefak stabil yang menghadap mesin di bawah:

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

Digest ini ada agar agen dan kode runtime tidak perlu mengikis halaman Markdown.

Keluaran terkompilasi juga mendukung:

pengindeksan wiki lintasan pertama untuk alur pencarian/pengambilan
pencarian ID klaim kembali ke halaman pemilik
suplemen prompt ringkas
pembuatan laporan/dasbor

Dasbor dan laporan kesehatan

Ketika render.createDashboards diaktifkan, kompilasi 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-hal seperti:

kluster catatan kontradiksi
kluster klaim yang bersaing
klaim yang kehilangan bukti terstruktur
halaman dan klaim dengan keyakinan rendah
kesegaran usang atau tidak diketahui
halaman dengan pertanyaan yang belum terselesaikan
kartu perutean orang/entitas
edge relasi terstruktur
cakupan kelas bukti
tingkat privasi nonpublik yang perlu ditinjau sebelum digunakan

Pencarian dan pengambilan

memory-wiki mendukung dua backend pencarian:

shared: gunakan alur pencarian memori bersama jika 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 jika memungkinkan
ID klaim dapat diselesaikan kembali ke halaman pemilik
klaim yang diperdebatkan/usang/segar memengaruhi pemeringkatan
label asal-usul dapat bertahan ke dalam hasil
mode pencarian dapat membiaskan pemeringkatan untuk pencarian orang, perutean pertanyaan, bukti sumber, atau klaim mentah

Aturan praktis:

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

Mode pencarian:

auto: default seimbang
find-person: dorong entitas mirip orang, alias, handle, sosial, dan ID kanonis
route-question: dorong kartu agen, petunjuk minta-untuk, petunjuk paling-cocok-untuk, dan konteks relasi
source-evidence: dorong halaman sumber dan metadata bukti terstruktur
raw-claim: dorong klaim terstruktur yang cocok dan kembalikan metadata klaim/bukti dalam hasil

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

Alat agen

Plugin mendaftarkan alat berikut:

wiki_status
wiki_search
wiki_get
wiki_apply
wiki_lint

Yang dilakukan:

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

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

Perilaku prompt dan konteks

Ketika context.includeCompiledDigestPrompt diaktifkan, bagian prompt memori menambahkan snapshot terkompilasi ringkas dari agent-digest.json.

Snapshot itu sengaja kecil dan bernilai sinyal tinggi:

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

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: QMD + mode bridge

Gunakan ini saat Anda menginginkan QMD untuk pengingatan dan memory-wiki untuk lapisan pengetahuan yang dikelola:

{
  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 tetap bertanggung jawab atas pengingatan memori aktif
memory-wiki berfokus pada halaman terkompilasi dan dasbor
bentuk prompt tidak berubah sampai 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

Saat vault.renderMode adalah obsidian, Plugin menulis Markdown yang ramah Obsidian dan secara opsional dapat menggunakan CLI obsidian resmi.

Alur kerja yang didukung meliputi:

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

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

Alur kerja yang direkomendasikan

Pertahankan Plugin memori aktif Anda untuk pengingatan/promosi/dreaming.
Aktifkan memory-wiki.
Mulai dengan mode isolated kecuali Anda secara eksplisit menginginkan mode bridge.
Gunakan wiki_search / wiki_get saat asal-usul penting.
Gunakan wiki_apply untuk sintesis sempit atau pembaruan metadata.
Jalankan wiki_lint setelah perubahan bermakna.
Aktifkan dasbor jika Anda menginginkan visibilitas atas stale/kontradiksi.

Wiki memori

Yang ditambahkan

Bagaimana ini cocok dengan memori

Pola hibrida yang direkomendasikan

Mode brankas

`isolated`

`bridge`

`unsafe-local`

Tata letak brankas

Klaim dan bukti terstruktur

Metadata entitas yang menghadap agen

Pipeline kompilasi

Dasbor dan laporan kesehatan

Pencarian dan pengambilan

Alat agen

Perilaku prompt dan konteks

Konfigurasi

Contoh: QMD + mode bridge

CLI

Dukungan Obsidian

Alur kerja yang direkomendasikan

Dokumen terkait

Ask OpenClaw

# Yang ditambahkan

# Bagaimana ini cocok dengan memori

# Pola hibrida yang direkomendasikan

# Mode brankas

# isolated

# bridge

# unsafe-local

# Tata letak brankas

# Klaim dan bukti terstruktur

# Metadata entitas yang menghadap agen

# Pipeline kompilasi

# Dasbor dan laporan kesehatan

# Pencarian dan pengambilan

# Alat agen

# Perilaku prompt dan konteks

# Konfigurasi

# Contoh: QMD + mode bridge

# CLI

# Dukungan Obsidian

# Alur kerja yang direkomendasikan

# Dokumen terkait

Yang ditambahkan

Bagaimana ini cocok dengan memori

Pola hibrida yang direkomendasikan

Mode brankas

`isolated`

`bridge`

`unsafe-local`

Tata letak brankas

Klaim dan bukti terstruktur

Metadata entitas yang menghadap agen

Pipeline kompilasi

Dasbor dan laporan kesehatan

Pencarian dan pengambilan

Alat agen

Perilaku prompt dan konteks

Konfigurasi

Contoh: QMD + mode bridge

CLI

Dukungan Obsidian

Alur kerja yang direkomendasikan

Dokumen terkait