Bellek wiki - OpenClaw

memory-wiki, kalıcı belleği derlenmiş bir bilgi kasasına dönüştüren paketlenmiş bir Plugin’dir. Active Memory Plugin’inin yerini almaz. Active Memory Plugin’i hâlâ hatırlama, yükseltme, indeksleme ve Dreaming işlemlerinin sahibidir. memory-wiki onun yanında durur ve kalıcı bilgiyi belirlenimci sayfalar, yapılandırılmış iddialar, kaynak bilgisi, panolar ve makine tarafından okunabilir özetler içeren gezilebilir bir wiki’ye derler. Belleğin bir Markdown dosyaları yığını gibi değil, bakımı yapılan bir bilgi katmanı gibi davranmasını istediğinizde kullanın.

Ne ekler?

Belirlenimci sayfa düzenine sahip özel bir wiki kasası
Yalnızca düz yazı değil, yapılandırılmış iddia ve kanıt üst verisi
Sayfa düzeyinde kaynak bilgisi, güven, çelişkiler ve açık sorular
Aracı/çalışma zamanı tüketicileri için derlenmiş özetler
Wiki’ye özgü search/get/apply/lint araçları
Open Knowledge Format içe aktarımlarını derlenmiş wiki kavramlarına dönüştürme
Active Memory Plugin’inden genel yapıtları içe aktaran isteğe bağlı köprü modu
İsteğe bağlı Obsidian dostu işleme modu ve CLI entegrasyonu

Bellekle nasıl uyum sağlar?

Ayrımı şöyle düşünün:

Katman	Sahip olduğu
Active Memory Plugin’i (`memory-core`, QMD, Honcho vb.)	Hatırlama, anlamsal arama, yükseltme, Dreaming, bellek çalışma zamanı
`memory-wiki`	Derlenmiş wiki sayfaları, kaynak bilgisi açısından zengin sentezler, panolar, wiki’ye özgü search/get/apply

Active Memory Plugin’i paylaşılan hatırlama yapıtlarını açığa çıkarıyorsa OpenClaw, memory_search corpus=all ile iki katmanı da tek geçişte arayabilir. Wiki’ye özgü sıralama, kaynak bilgisi veya doğrudan sayfa erişimi gerektiğinde bunun yerine wiki’ye özgü araçları kullanın.

Önerilen hibrit desen

Yerel öncelikli kurulumlar için güçlü bir varsayılan şudur:

Hatırlama ve geniş anlamsal arama için Active Memory arka ucu olarak QMD
Kalıcı sentezlenmiş bilgi sayfaları için bridge modunda memory-wiki

Bu ayrım iyi çalışır çünkü her katman odaklı kalır:

QMD, ham notları, oturum dışa aktarımlarını ve ek koleksiyonları aranabilir tutar
memory-wiki, kararlı varlıkları, iddiaları, panoları ve kaynak sayfaları derler

Pratik kural:

bellek genelinde tek bir geniş hatırlama geçişi istediğinizde memory_search kullanın
kaynak bilgisine duyarlı wiki sonuçları istediğinizde wiki_search ve wiki_get kullanın
paylaşılan aramanın iki katmanı da kapsamasını istediğinizde memory_search corpus=all kullanın

Köprü modu sıfır dışa aktarılmış yapıt bildiriyorsa Active Memory Plugin’i şu anda genel köprü girdilerini henüz açığa çıkarmıyor demektir. Önce openclaw wiki doctor çalıştırın, ardından Active Memory Plugin’inin genel yapıtları desteklediğini doğrulayın. Köprü modu etkin olduğunda ve bridge.readMemoryArtifacts etkinleştirildiğinde, openclaw wiki status, openclaw wiki doctor ve openclaw wiki bridge import çalışan Gateway üzerinden okur. Bu, CLI köprü denetimlerini çalışma zamanı bellek Plugin bağlamıyla uyumlu tutar. Köprü devre dışıysa veya yapıt okumaları kapalıysa, bu komutlar yerel/çevrimdışı davranışlarını korur.

Kasa modları

memory-wiki üç kasa modunu destekler:

`isolated`

Kendi kasası, kendi kaynakları; memory-core bağımlılığı yoktur. Wiki’nin kendi seçilmiş bilgi deposu olmasını istediğinizde bunu kullanın.

`bridge`

Active Memory Plugin’inden genel Plugin SDK sınırları üzerinden genel bellek yapıtlarını ve bellek olaylarını okur. Wiki’nin, bellek Plugin’inin dışa aktarılmış yapıtlarını özel Plugin iç yapısına erişmeden derleyip düzenlemesini istediğinizde bunu kullanın. Köprü modu şunları indeksleyebilir:

dışa aktarılmış bellek yapıtları
Dreaming raporları
günlük notlar
bellek kök dosyaları
bellek olay günlükleri

`unsafe-local`

Yerel özel yollar için açık aynı makine kaçış kapısı. Bu mod bilinçli olarak deneysel ve taşınabilir değildir. Yalnızca güven sınırını anladığınızda ve köprü modunun sağlayamadığı yerel dosya sistemi erişimine özellikle ihtiyaç duyduğunuzda kullanın.

Kasa düzeni

Plugin bir kasayı şöyle başlatır:

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

Yönetilen içerik oluşturulan blokların içinde kalır. İnsan notu blokları korunur. Ana sayfa grupları şunlardır:

içe aktarılmış ham malzeme ve köprü destekli sayfalar için sources/
kalıcı şeyler, kişiler, sistemler, projeler ve nesneler için entities/
fikirler, soyutlamalar, desenler ve ilkeler için concepts/
derlenmiş özetler ve bakımı yapılan toplamalar için syntheses/
oluşturulan panolar için reports/

Open Knowledge Format içe aktarımları

memory-wiki, açılmış Open Knowledge Format paketlerini şu komutla içe aktarabilir:

openclaw wiki okf import ./bundles/ga4

Bir veri kataloğu, dokümantasyon tarayıcısı veya zenginleştirme aracısı zaten OKF üretiyorsa en temiz uyum budur: OKF’yi taşınabilir değişim yapıtı olarak tutun, ardından memory-wiki’nin bunu OpenClaw’a özgü kavram sayfalarına ve derlenmiş özetlere dönüştürmesine izin verin. İçe aktarıcı OKF v0.1 biçimini izler:

ayrılmış olmayan .md dosyaları kavram belgeleridir
içe aktarılan her kavramın boş olmayan bir type frontmatter alanına ihtiyacı vardır
bilinmeyen OKF type değerleri kabul edilir
ayrılmış index.md ve log.md dosyaları kavram olarak içe aktarılmaz
bozuk veya harici markdown bağlantıları korunur

İçe aktarılan kavram sayfaları concepts/ altında düzleştirilir; böylece mevcut derleme, arama, getirme, pano ve istem özeti yolları ikinci bir wiki ağacı eklemeden bunları görür. Her sayfa özgün OKF kavram kimliğini, kaynak yolunu, type, resource, tags, zaman damgasını ve tüm üretici frontmatter’ını korur. Dahili OKF bağlantıları oluşturulan wiki kavram sayfalarına yeniden yazılır ve ayrıca kind: okf-link ile yapılandırılmış relationships girdileri olarak yayılır.

Yapılandırılmış iddialar ve kanıt

Sayfalar yalnızca serbest biçimli metin değil, yapılandırılmış claims frontmatter’ı taşıyabilir. Her iddia şunları içerebilir:

id
text
status
confidence
evidence[]
updatedAt

Kanıt girdileri şunları içerebilir:

kind
sourceId
path
lines
weight
confidence
privacyTier
note
updatedAt

Wiki’nin pasif bir not dökümünden çok inanç katmanı gibi davranmasını sağlayan budur. İddialar izlenebilir, puanlanabilir, itiraz edilebilir ve kaynaklara geri bağlanarak çözümlenebilir.

Aracıya dönük varlık üst verisi

Varlık sayfaları, aracı kullanımı için yönlendirme üst verisi de taşıyabilir. Bu genel frontmatter’dır; dolayısıyla kişiler, ekipler, sistemler, projeler veya başka herhangi bir varlık türü için çalışır. Yaygın alanlar şunlardır:

entityType: örneğin person, team, system veya project
canonicalId: takma adlar ve içe aktarımlar genelinde kullanılan kararlı kimlik anahtarı
aliases: aynı sayfaya çözümlenmesi gereken adlar, kullanıcı adları veya etiketler
privacyTier: public, local-private, sensitive veya confirm-before-use
bestUsedFor / notEnoughFor: kompakt yönlendirme ipuçları
lastRefreshedAt: sayfa düzenleme zamanından ayrı kaynak yenileme zaman damgası
personCard: kullanıcı adları, sosyal bağlantılar, e-postalar, saat dilimi, hat, sorulacak konular, sorulmaması gereken konular, güven ve gizlilik içeren isteğe bağlı kişiye özgü yönlendirme kartı
relationships: hedef, tür, ağırlık, güven, kanıt türü, gizlilik katmanı ve not içeren ilgili sayfalara türlendirilmiş kenarlar

Bir kişi wiki’si için aracı genellikle reports/person-agent-directory.md ile başlamalı, ardından iletişim ayrıntılarını veya çıkarılan olguları kullanmadan önce kişi sayfasını wiki_get ile açmalıdır. Örnek:

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

Derleme hattı

Derleme adımı wiki sayfalarını okur, özetleri normalleştirir ve kararlı makineye dönük yapıtları şuraya yayar:

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

Bu özetler, aracıların ve çalışma zamanı kodunun Markdown sayfalarını kazımasına gerek kalmaması için vardır. Derlenmiş çıktı ayrıca şunları destekler:

search/get akışları için ilk geçiş wiki indeksleme
iddia kimliğinden sahip sayfaya geri arama
kompakt istem ekleri
rapor/pano oluşturma

Panolar ve sağlık raporları

render.createDashboards etkinleştirildiğinde derleme, reports/ altında panoları korur. Yerleşik raporlar şunları içerir:

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

Bu raporlar şunlar gibi konuları izler:

çelişki notu kümeleri
rakip iddia kümeleri
yapılandırılmış kanıtı eksik iddialar
düşük güvenli sayfalar ve iddialar
eski veya bilinmeyen güncellik
çözülmemiş soruları olan sayfalar
kişi/varlık yönlendirme kartları
yapılandırılmış ilişki kenarları
kanıt sınıfı kapsamı
kullanılmadan önce inceleme gerektiren genel olmayan gizlilik katmanları

Arama ve getirme

memory-wiki iki arama arka ucunu destekler:

shared: kullanılabilir olduğunda paylaşılan bellek arama akışını kullanır
local: wiki’yi yerel olarak arar

Ayrıca üç külliyatı destekler:

wiki
memory
all

Önemli davranış:

wiki_search ve wiki_get mümkün olduğunda ilk geçiş olarak derlenmiş özetleri kullanır
iddia kimlikleri sahip sayfaya geri çözümlenebilir
itirazlı/eski/güncel iddialar sıralamayı etkiler
kaynak bilgisi etiketleri sonuçlara taşınabilir
arama modu kişi bulma, soru yönlendirme, kaynak kanıtı veya ham iddialar için sıralamayı yönlendirebilir

Pratik kural:

tek bir geniş hatırlama geçişi için memory_search corpus=all kullanın
wiki’ye özgü sıralama, kaynak bilgisi veya sayfa düzeyinde inanç yapısı önemli olduğunda wiki_search + wiki_get kullanın

Arama modları:

auto: dengeli varsayılan
find-person: kişiye benzeyen varlıkları, takma adları, kullanıcı adlarını, sosyal bağlantıları ve kanonik kimlikleri öne çıkarır
route-question: aracı kartlarını, sorulacak konu ipuçlarını, en iyi kullanım ipuçlarını ve ilişki bağlamını öne çıkarır
source-evidence: kaynak sayfaları ve yapılandırılmış kanıt üst verisini öne çıkarır
raw-claim: eşleşen yapılandırılmış iddiaları öne çıkarır ve sonuçlarda iddia/kanıt üst verisi döndürür

Bir sonuç yapılandırılmış bir iddiayla eşleştiğinde wiki_search, ayrıntı yükünde matchedClaimId, matchedClaimStatus, matchedClaimConfidence, evidenceKinds ve evidenceSourceIds döndürebilir. Metin çıktısı da mevcut olduğunda kompakt Claim: ve Evidence: satırlarını içerir.

Aracı araçları

Plugin şu araçları kaydeder:

wiki_status
wiki_search
wiki_get
wiki_apply
wiki_lint

Ne yaptıkları:

wiki_status: geçerli kasa modu, sağlık, Obsidian CLI kullanılabilirliği
wiki_search: wiki sayfalarını ve yapılandırıldığında paylaşılan bellek külliyatlarını arar; kişi bulma, soru yönlendirme, kaynak kanıtı veya ham iddia ayrıntısına inme için mode kabul eder
wiki_get: bir wiki sayfasını kimliğe/yola göre okur veya paylaşılan bellek külliyatına geri döner
wiki_apply: serbest biçimli sayfa ameliyatı olmadan dar sentez/üst veri mutasyonları
wiki_lint: yapısal denetimler, kaynak bilgisi boşlukları, çelişkiler, açık sorular

Plugin ayrıca münhasır olmayan bir bellek derlemi eki kaydeder; böylece paylaşılan memory_search ve memory_get, Active Memory Plugin’i derlem seçimini desteklediğinde wiki’ye erişebilir.

İstem ve bağlam davranışı

context.includeCompiledDigestPrompt etkinleştirildiğinde, bellek istemi bölümleri agent-digest.json içinden kompakt bir derlenmiş anlık görüntü ekler. Bu anlık görüntü bilerek küçük ve yüksek sinyallidir:

yalnızca en önemli sayfalar
yalnızca en önemli iddialar
çelişki sayısı
soru sayısı
güven/güncellik niteleyicileri

Bu, istem şeklini değiştirdiği ve özellikle bellek eklerini açıkça tüketen bağlam motorları veya eski istem birleştirme için yararlı olduğu için isteğe bağlıdır.

Yapılandırma

Yapılandırmayı plugins.entries.memory-wiki.config altına koyun:

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

Temel anahtarlar:

vaultMode: isolated, bridge, unsafe-local
vault.renderMode: native veya obsidian
bridge.readMemoryArtifacts: Active Memory Plugin’inin herkese açık yapılarını içe aktar
bridge.followMemoryEvents: köprü modunda olay günlüklerini dahil et
search.backend: shared veya local
search.corpus: wiki, memory veya all
context.includeCompiledDigestPrompt: bellek istemi bölümlerine kompakt özet anlık görüntüsünü ekle
render.createBacklinks: deterministik ilgili bloklar oluştur
render.createDashboards: pano sayfaları oluştur

Örnek: QMD + köprü modu

Bunu, geri çağırma için QMD ve bakımı yapılan bir bilgi katmanı için memory-wiki istediğinizde kullanın:

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

Bu şunları korur:

Active Memory geri çağırmadan QMD sorumlu kalır
memory-wiki derlenmiş sayfalara ve panolara odaklanır
derlenmiş özet istemlerini bilerek etkinleştirene kadar istem şekli değişmez

CLI

memory-wiki ayrıca üst düzey bir CLI yüzeyi sunar:

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

Tam komut başvurusu için CLI: wiki bölümüne bakın.

Obsidian desteği

vault.renderMode obsidian olduğunda Plugin, Obsidian dostu Markdown yazar ve isteğe bağlı olarak resmi obsidian CLI’sini kullanabilir. Desteklenen iş akışları şunları içerir:

durum yoklama
vault araması
bir sayfayı açma
bir Obsidian komutunu çağırma
günlük nota atlama

Bu isteğe bağlıdır. Wiki, Obsidian olmadan yerel modda da çalışır.

Önerilen iş akışı

Active Memory Plugin’inizi geri çağırma/yükseltme/Dreaming için koruyun.
memory-wiki özelliğini etkinleştirin.
Köprü modunu açıkça istemediğiniz sürece isolated moduyla başlayın.
Köken bilgisi önemli olduğunda wiki_search / wiki_get kullanın.
Dar kapsamlı sentezler veya meta veri güncellemeleri için wiki_apply kullanın.
Anlamlı değişikliklerden sonra wiki_lint çalıştırın.
Eski/çelişki görünürlüğü istiyorsanız panoları açın.

​Ne ekler?

​Bellekle nasıl uyum sağlar?

​Önerilen hibrit desen

​Kasa modları

​isolated

​bridge

​unsafe-local

​Kasa düzeni

​Open Knowledge Format içe aktarımları

​Yapılandırılmış iddialar ve kanıt

​Aracıya dönük varlık üst verisi

​Derleme hattı

​Panolar ve sağlık raporları

​Arama ve getirme

​Aracı araçları

​İstem ve bağlam davranışı

​Yapılandırma

​Örnek: QMD + köprü modu

​CLI

​Obsidian desteği

​Önerilen iş akışı

​İlgili dokümanlar