Bellek wiki'si - 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â geri çağırma, yükseltme, indeksleme ve Dreaming işlemlerinin sahibidir. memory-wiki onun yanında durur ve kalıcı bilgiyi deterministik sayfalar, yapılandırılmış iddialar, köken bilgisi, panolar ve makine tarafından okunabilir özetlerle gezilebilir bir wiki’ye derler. Belleğin bir Markdown dosyaları yığını gibi değil, sürdürülen bir bilgi katmanı gibi davranmasını istediğinizde kullanın.

Neler ekler

Deterministik sayfa düzenine sahip özel bir wiki kasası
Yalnızca düz metin değil, yapılandırılmış iddia ve kanıt metadatası
Sayfa düzeyinde köken 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ı
Active Memory Plugin’inden herkese açık yapıtları içe aktaran isteğe bağlı köprü modu
İsteğe bağlı Obsidian dostu render modu ve CLI entegrasyonu

Bellek ile nasıl uyum sağlar

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

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

Active Memory Plugin’i paylaşılan geri çağırma yapıtlarını sunarsa OpenClaw, memory_search corpus=all ile tek geçişte iki katmanda da arama yapabilir. Wiki’ye özgü sıralama, köken bilgisi veya doğrudan sayfa erişimi gerektiğinde bunun yerine wiki’ye özgü araçları kullanın.

Önerilen hibrit kalıp

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

Geri çağırma 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 odağını korur:

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

Pratik kural:

bellek genelinde tek bir geniş geri çağırma geçişi istediğinizde memory_search kullanın
köken 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 bildirirse Active Memory Plugin’i şu anda herkese açık köprü girdileri sunmuyor demektir. Önce openclaw wiki doctor çalıştırın, ardından Active Memory Plugin’inin herkese açık 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ü kontrollerini çalışma zamanı bellek Plugin bağlamıyla uyumlu tutar. Köprü devre dışıysa veya yapıt okumaları kapatıldıysa bu komutlar yerel/çevrimdışı davranışlarını korur.

Kasa modları

memory-wiki üç kasa modunu destekler:

`isolated`

Kendi kasası, kendi kaynakları vardır; memory-core bağımlılığı yoktur. Wiki’nin kendi düzenlenmiş bilgi deposu olmasını istediğinizde bunu kullanın.

`bridge`

Active Memory Plugin’inden herkese açık bellek yapıtlarını ve bellek olaylarını, herkese açık Plugin SDK uçları üzerinden okur. Wiki’nin, özel Plugin iç ayrıntılarına erişmeden bellek Plugin’inin dışa aktardığı yapıtları derlemesini ve 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çış yolu. 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 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şturulmuş blokların içinde kalır. İnsan notu blokları korunur. Ana sayfa grupları şunlardır:

içe aktarılmış ham materyal ve köprü destekli sayfalar için sources/
kalıcı şeyler, kişiler, sistemler, projeler ve nesneler için entities/
fikirler, soyutlamalar, kalıplar ve ilkeler için concepts/
derlenmiş özetler ve sürdürülen toplu görünümler için syntheses/
oluşturulmuş panolar için reports/

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

Sayfalar yalnızca serbest biçimli metin değil, yapılandırılmış claims frontmatter’ı da 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 bir inanç katmanı gibi davranmasını sağlayan şey budur. İddialar izlenebilir, puanlanabilir, tartışılabilir ve kaynaklara geri bağlanarak çözülebilir.

Aracıya dönük varlık metadatası

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

entityType: örneğin person, team, system veya project
canonicalId: diğer adlar ve içe aktarımlar genelinde kullanılan kararlı kimlik anahtarı
aliases: aynı sayfaya çözülmesi 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 hesaplar, e-postalar, saat dilimi, kulvar, sorulacak konular, sorulmaması gerekenler, 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 tipli 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ılmış olguları kullanmadan önce wiki_get ile kişi sayfasını 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 şu konumların altında kararlı makineye dönük yapıtlar üretir:

.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ımak zorunda 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 sayfalara geri arama
kompakt prompt ekleri
rapor/pano oluşturma

Panolar ve sağlık raporları

render.createDashboards etkinleştirildiğinde derleme, panoları reports/ altında sürdürür. Yerleşik raporlar şunlardır:

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 şu tür şeyleri 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
bayat 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ımdan önce inceleme gerektiren herkese açık olmayan gizlilik katmanları

Arama ve getirme

memory-wiki iki arama arka ucunu destekler:

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

Ayrıca üç derlemi 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ülebilir
tartışmalı/bayat/güncel iddialar sıralamayı etkiler
köken bilgisi etiketleri sonuçlara taşınabilir
arama modu kişi arama, soru yönlendirme, kaynak kanıtı veya ham iddialar için sıralamayı ağırlıklandırabilir

Pratik kural:

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

Arama modları:

auto: dengeli varsayılan
find-person: kişi benzeri varlıkları, diğer adları, kullanıcı adlarını, sosyal hesapları 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 metadatasını öne çıkarır
raw-claim: eşleşen yapılandırılmış iddiaları öne çıkarır ve sonuçlarda iddia/kanıt metadatası döndürür

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

Aracı araçları

Plugin şu araçları kaydeder:

wiki_status
wiki_search
wiki_get
wiki_apply
wiki_lint

Yaptıkları işler:

wiki_status: mevcut kasa modu, sağlık, Obsidian CLI kullanılabilirliği
wiki_search: wiki sayfalarında ve yapılandırıldığında paylaşılan bellek derlemlerinde arama yapar; kişi arama, soru yönlendirme, kaynak kanıtı veya ham iddia ayrıntılandırması için mode kabul eder
wiki_get: bir wiki sayfasını id/path ile okur veya paylaşılan bellek derlemine geri döner
wiki_apply: serbest biçimli sayfa ameliyatı olmadan dar sentez/metadata değişiklikleri
wiki_lint: yapısal kontroller, köken bilgisi boşlukları, çelişkiler, açık sorular

Plugin ayrıca dışlayıcı olmayan bir bellek derlemi eki kaydeder; böylece Active Memory Plugin’i derlem seçimini desteklediğinde paylaşılan memory_search ve memory_get wiki’ye ulaşabilir.

Prompt ve bağlam davranışı

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

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

Bu isteğe bağlıdır çünkü prompt biçimini değiştirir ve esas olarak bellek eklerini açıkça tüketen bağlam motorları veya eski prompt derleme için kullanış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,
          },
        },
      },
    },
  },
}

Anahtar geçişler:

vaultMode: isolated, bridge, unsafe-local
vault.renderMode: native veya obsidian
bridge.readMemoryArtifacts: Active Memory Plugin genel artefaktları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, hatırlama için QMD ve sürdürülen 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 hatırlamasından QMD sorumlu kalır
memory-wiki derlenmiş sayfalara ve panolara odaklanır
derlenmiş özet istemlerini bilerek etkinleştirene kadar istem biçimi 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 aracını kullanabilir. Desteklenen iş akışları şunları içerir:

durum yoklama
kasa arama
bir sayfa açma
bir Obsidian komutu ç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ışı

Hatırlama/yükseltme/Dreaming için Active Memory Plugin’inizi koruyun.
memory-wiki öğesini etkinleştirin.
Açıkça köprü modunu istemiyorsanız isolated moduyla başlayın.
Kaynak 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.
Eskime/çelişki görünürlüğü istiyorsanız panoları açın.

Documentation Index

​Neler ekler

​Bellek ile nasıl uyum sağlar

​Önerilen hibrit kalıp

​Kasa modları

​isolated

​bridge

​unsafe-local

​Kasa düzeni

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

​Aracıya dönük varlık metadatası

​Derleme hattı

​Panolar ve sağlık raporları

​Arama ve getirme

​Aracı araçları

​Prompt ve bağlam davranışı

​Yapılandırma

​Örnek: QMD + köprü modu

​CLI

​Obsidian desteği

​Önerilen iş akışı

​İlgili belgeler