Bellek wiki'si

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:
    - [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

# 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ışı

1. Hatırlama/yükseltme/Dreaming için Active Memory Plugin'inizi koruyun.
2. memory-wiki öğesini etkinleştirin.
3. Açıkça köprü modunu istemiyorsanız isolated moduyla başlayın.
4. Kaynak bilgisi önemli olduğunda wiki_search / wiki_get kullanın.
5. Dar kapsamlı sentezler veya meta veri güncellemeleri için wiki_apply kullanın.
6. Anlamlı değişikliklerden sonra wiki_lint çalıştırın.
7. Eskime/çelişki görünürlüğü istiyorsanız panoları açın.

# İlgili belgeler

• Bellek Genel Bakışı
• CLI: memory
• CLI: wiki
• Plugin SDK genel bakışı