Bellek vikisi

memory-wiki, kalıcı bilgiyi gezilebilir bir vikide derleyen, paketle birlikte gelen bir plugindir: deterministik sayfalar, kanıt içeren yapılandırılmış iddialar, kaynak geçmişi, panolar ve makine tarafından okunabilir özetler.

Active Memory plugininin yerini almaz. Hatırlama, yükseltme, indeksleme ve Dreaming, yapılandırılmış bellek arka ucu (memory-core, QMD, Honcho vb.) tarafından yönetilmeye devam eder. memory-wiki bunun yanında yer alır ve bilgiyi bakımı yapılan bir viki katmanında derler.

Pratik kural:

• Yapılandırılmış tüm külliyatlarda tek bir geniş kapsamlı hatırlama geçişi için memory_search
• Vikiye özgü sıralama, kaynak geçmişi veya sayfa düzeyinde inanç yapısı istediğinizde wiki_search / wiki_get
• Active Memory plugini külliyat seçimini desteklediğinde, tek çağrıda iki katmanı da kapsamak için memory_search corpus=all

Yaygın bir önce yerel kurulum: hatırlama için Active Memory arka ucu olarak QMD ve kalıcı sentezlenmiş sayfalar için bridge modunda memory-wiki. Yapılandırma altındaki QMD + köprü modu örneğine bakın.

Köprü modu dışa aktarılan sıfır yapıt bildiriyorsa Active Memory plugini şu anda herkese açık köprü girdileri sunmuyor demektir. Önce openclaw wiki doctor komutunu çalıştırın, ardından Active Memory plugininin herkese açık yapıtları desteklediğini doğrulayın.

Kasa modları

• isolated (varsayılan): kendi kasası ve kaynakları vardır; Active Memory pluginine bağımlı değildir. Bunu bağımsız ve özenle düzenlenen bir bilgi deposu için kullanın.
• bridge: herkese açık plugin SDK bağlantı noktaları üzerinden Active Memory plugininden herkese açık bellek yapıtlarını ve olay günlüklerini okur. Bellek plugininin dışa aktardığı yapıtları, özel plugin iç bileşenlerine erişmeden derlemek için bunu kullanın.
• unsafe-local: yerel özel yollar için açıkça etkinleştirilen, aynı makineye yönelik bir kaçış yoludur. Bilerek 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 modu ve kasa kapsamı birbirinden ayrı seçimlerdir:

• vaultMode, viki girdilerinin nereden geldiğini seçer.
• vault.scope, tüm ajanların tek bir kasa mı kullanacağını yoksa her ajanın bir alt kasa mı alacağını seçer.

vault.scope: "global" varsayılandır ve mevcut tek kasa davranışını korur. Ajanların viki sayfalarını, derlenmiş özetleri, arama sonuçlarını veya yazma işlemlerini paylaşmaması gerektiğinde isolated ya da bridge moduyla birlikte vault.scope: "agent" kullanın. Ajan kapsamı unsafe-local moduyla birleştirilemez; çünkü yapılandırılmış bu özel yollar ajanlara ait girdiler değildir. Yapılandırma doğrulaması bu birleşimi reddeder.

Köprü modu, her bridge.* yapılandırma anahtarına göre şunları indeksleyebilir:

• dışa aktarılan bellek yapıtları (indexMemoryRoot)
• günlük notlar (indexDailyNotes)
• Dreaming raporları (indexDreamReports)
• bellek olay günlükleri (followMemoryEvents)

Köprü modu etkinken ve bridge.readMemoryArtifacts etkinleştirildiğinde, openclaw wiki status, openclaw wiki doctor ve openclaw wiki bridge import çalışan Gateway üzerinden yönlendirilir; böylece ajan/çalışma zamanı belleğiyle aynı Active Memory plugini bağlamını görürler. Köprü devre dışıysa veya yapıt okumaları kapalıysa bu komutlar yerel/çevrimdışı davranışlarını korur.

Kasa düzeni

<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; insan tarafından yazılan not blokları yeniden oluşturma işlemleri boyunca korunur.

• sources/: içe aktarılan ham malzeme ve köprü/unsafe-local destekli sayfalar
• entities/: kalıcı öğeler, kişiler, sistemler, projeler ve nesneler
• concepts/: fikirler, soyutlamalar, örüntüler ve politikalar (ayrıca OKF içe aktarımlarının hedefi)
• syntheses/: derlenmiş özetler ve bakımı yapılan toplu değerlendirmeler
• reports/: oluşturulan panolar

Open Knowledge Format içe aktarımları

openclaw wiki okf import ./bundles/ga4

Paketinden çıkarılmış bir Open Knowledge Format paketini viki kavram sayfalarına aktarın. Bir veri kataloğu, dokümantasyon tarayıcısı veya zenginleştirme ajanı zaten OKF üretiyorsa uygundur: taşınabilir değişim yapıtı olarak OKF'yi koruyun ve memory-wikinin bunu OpenClaw'a özgü kavram sayfalarına ve derlenmiş özetlere dönüştürmesine izin verin.

• ayrılmış olmayan .md dosyaları kavram belgeleridir
• içe aktarılan her kavram, frontmatter bölümünde boş olmayan bir type alanı gerektirir; eksik type, missing-type uyarısı oluşturur ve dosya atlanır
• bilinmeyen type değerleri genel kavramlar olarak kabul edilir
• index.md ve log.md ayrılmıştır ve hiçbir zaman kavram olarak içe aktarılmaz
• bozuk veya harici Markdown bağlantıları değiştirilmeden bırakılır

İçe aktarılan sayfalar concepts/ altında düzleştirilir; böylece mevcut derleme, arama, get ve pano akışları ikinci bir viki ağacı olmadan bunları görür. Her sayfa özgün OKF kavram kimliğini, kaynak yolunu, type, resource, tags, zaman damgasını ve üreticinin frontmatter bölümünün tamamını korur. Dahili OKF bağlantıları oluşturulan viki kavram sayfalarına yeniden yazılır ve ayrıca kind: okf-link içeren yapılandırılmış relationships girdileri oluşturur.

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

Sayfalar yalnızca serbest biçimli metin değil, yapılandırılmış claims frontmatter verileri taşır. Her iddia id, text, status, confidence, evidence[] ve updatedAt içerebilir. Her kanıt girdisi kind, sourceId, path, lines, weight, confidence, privacyTier, note ve updatedAt içerebilir.

Bu, vikinin pasif bir not yığını gibi değil, bir inanç katmanı gibi davranmasını sağlar. İddialar izlenebilir, puanlanabilir, itiraz edilebilir ve kaynaklara başvurularak çözümlenebilir.

Ajana yönelik varlık meta verileri

Varlık sayfaları; kişiler, ekipler, sistemler, projeler veya diğer tüm varlık türleri için kullanılabilen genel yönlendirme meta verileri taşır:

• entityType: örneğin person, team, system, project
• canonicalId: takma adlar ve içe aktarımlar arasında kararlı kimlik anahtarı
• aliases: aynı sayfaya çözümlenen adlar, kullanıcı adları veya etiketler
• privacyTier: serbest biçimli dize; public inceleme gerektirmeyen olarak değerlendirilir, diğer tüm değerler (örneğin local-private, sensitive, confirm-before-use) reports/privacy-review.md içinde işaretlenir
• bestUsedFor / notEnoughFor: kısa yönlendirme ipuçları
• lastRefreshedAt: sayfa düzenleme zamanından ayrı kaynak yenileme zaman damgası
• personCard: isteğe bağlı, kişiye özgü yönlendirme kartı (kullanıcı adları, sosyal hesaplar, e-postalar, saat dilimi, çalışma alanı, başvurulacak konular, başvurulmaması gereken konular, güven düzeyi, gizlilik katmanı)
• relationships: ilişkili sayfalara yönelik türlendirilmiş kenarlar (hedef, tür, ağırlık, güven düzeyi, kanıt türü, gizlilik katmanı, not)

Bir kişiler vikisi için reports/person-agent-directory.md ile başlayın, ardından iletişim bilgilerini veya çıkarımsal olguları kullanmadan önce kişi sayfasını wiki_get ile açın.

pageType: entityentityType: personid: entity.example-personcanonicalId: maintainer.example-personaliases:- Alex- example-handleprivacyTier: local-privatebestUsedFor:- Örnek ekosistem yönlendirmesinotEnoughFor:- yasal onaylastRefreshedAt: "2026-04-29T00:00:00.000Z"personCard:handles:  - "@example-handle"socials:  - "https://x.example/example-handle"emails:  - alex@example.comtimezone: America/Chicagolane: Örnek ekosistemaskFor:  - Örnek kullanıma sunma sorularıavoidAskingFor:  - ilgisiz faturalandırma kararlarıconfidence: 0.8privacyTier: confirm-before-userelationships:- targetId: entity.other-person  targetTitle: Diğer Kişi  kind: collaborates-with  confidence: 0.7  evidenceKind: discrawl-statclaims:- id: claim.example.routing  text: Alex, örnek ekosistem yönlendirmesi için faydalıdır.  status: supported  confidence: 0.9  evidence:    - kind: maintainer-whois      sourceId: source.maintainers      privacyTier: local-private

Derleme işlem hattı

Derleme, viki sayfalarını okur, özetleri normalleştirir ve aşağıdaki konumlarda kararlı, makineye yönelik yapıtlar oluşturur:

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

Ajanlar ve çalışma zamanı kodu, Markdown'ı ayrıştırmak yerine bu özetleri okur. Derlenmiş çıktı ayrıca arama/get için ilk geçiş viki indekslemesini, iddia kimliğinden sahibi olan sayfaya geri aramayı, kısa istem eklerini ve rapor oluşturmayı destekler.

Panolar ve durum raporları

render.createDashboards etkinleştirildiğinde derleme, reports/ altındaki panoların bakımını yapar:

Arama ve getirme

İki arama arka ucu:

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

Üç külliyat: wiki, memory, all.

• wiki_search / wiki_get, mümkün olduğunda ilk geçiş olarak derlenmiş özetleri kullanır
• iddia kimlikleri, iddianın sahibi olan sayfaya geri çözümlenir
• itiraz edilmiş/güncelliğini yitirmiş/güncel iddialar sıralamayı etkiler
• kaynak geçmişi etiketleri sonuçlarda korunur

Arama modları (--mode / aracın mode parametresi):

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ürür. Metin çıktısı, kullanılabilir olduğunda kısa Claim: ve Evidence: satırlarını içerir.

Ajan araçları

Plugin ayrıca dışlayıcı olmayan bir bellek külliyatı ek kaynağı kaydeder; böylece etkin bellek Plugin'i külliyat seçimini desteklediğinde paylaşılan memory_search ve memory_get wiki'ye erişebilir.

İstem ve bağlam davranışı

context.includeCompiledDigestPrompt etkinleştirildiğinde bellek istemi bölümlerine agent-digest.json dosyasından derlenmiş kompakt bir anlık görüntü eklenir: yalnızca en önemli sayfalar, yalnızca en önemli iddialar, çelişki sayısı, soru sayısı ve güven/güncellik niteleyicileri. İstem yapısını değiştirdiği için bu özellik isteğe bağlıdır; esas olarak bellek eklerini açıkça kullanan bağlam motorları veya istem oluşturma süreçleri için önemlidir.

Yapılandırma

Yapılandırmayı plugins.entries.memory-wiki.config altına yerleştirin:

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

Temel anahtarlar:

Aracı başına kasalar

Yapılandırılmış her aracıya ayrı bir wiki vermek için vault.scope değerini agent olarak ayarlayın. Bu kapsamda vault.path bir üst dizindir ve OpenClaw, normalleştirilmiş aracı kimliğini sona ekler:

{  agents: {    list: [{ id: "support" }, { id: "marketing" }],  },  plugins: {    entries: {      "memory-wiki": {        enabled: true,        config: {          vaultMode: "bridge",          vault: {            scope: "agent",            path: "~/.openclaw/wiki",          },          bridge: {            enabled: true,            readMemoryArtifacts: true,          },        },      },    },  },}

Bu yapılandırma ~/.openclaw/wiki/support ve ~/.openclaw/wiki/marketing yollarına çözümlenir. Aracı kapsamında vault.path atlanırsa üst dizin varsayılan olarak ~/.openclaw/wiki olur. Bu nedenle varsayılan main aracısı mevcut ~/.openclaw/wiki/main yolunu korur.

Aracı araçları, derlenmiş istem özetleri ve memory_search / memory_get üzerinden sunulan wiki eki, kasayı etkin aracı bağlamından çözümler. Birden fazla yapılandırılmış aracının bulunduğu bir kurulumdaki CLI ve Gateway çağrılarında aracıyı openclaw wiki --agent <agentId> ... ile veya Gateway isteğinin agentId değeriyle açıkça belirtin. Yalnızca bir aracı yapılandırılmışsa kimlik belirtilmediğinde varsayılan olarak o kullanılır.

Köprü modunda aracı kapsamındaki içe aktarımlar, herkese açık bir bellek yapıtını yalnızca agentIds alanı seçilen aracıyı içeriyorsa kabul eder. Başka bir aracıya ait olan, sahiplik meta verisi bulunmayan veya sahibi bilinmeyen yapıtlar atlanır. Genel kapsam mevcut paylaşılan yapıt davranışını korur.

Örnek: QMD + köprü modu

Hatırlama için QMD, sürdürülen bir bilgi katmanı için ise memory-wiki kullanmak istediğinizde bunu kullanın. Her katman kendi odağını korur: QMD ham notları, oturum dışa aktarımlarını ve ek koleksiyonları aranabilir tutarken memory-wiki kararlı varlıkları, iddiaları, gösterge panellerini ve kaynak sayfalarını derler.

{  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 yapılandırma, etkin bellek hatırlamasının yönetimini QMD'de tutar, memory-wiki bileşenini derlenmiş sayfalara ve gösterge panellerine odaklar; derlenmiş özet istemlerini bilinçli olarak etkinleştirene kadar istem yapısını değiştirmez.

CLI

openclaw wiki statusopenclaw wiki doctoropenclaw wiki initopenclaw wiki ingest ./notes/alpha.mdopenclaw wiki compileopenclaw wiki lintopenclaw wiki search "alpha"openclaw wiki get entity.alphaopenclaw wiki apply synthesis "Alpha Summary" --body "..." --source-id source.alphaopenclaw wiki bridge importopenclaw wiki obsidian status

wiki okf import, wiki apply metadata, wiki unsafe-local import, wiki chatgpt import / wiki chatgpt rollback ve eksiksiz wiki obsidian alt komut kümesini içeren tam komut başvurusu için CLI: wiki sayfasına bakın.

Obsidian desteği

vault.renderMode değeri obsidian olduğunda Plugin, Obsidian ile uyumlu Markdown yazar ve isteğe bağlı olarak durum denetimi, kasa araması, sayfa açma, komut çağırma ve günlük nota geçiş için resmî obsidian CLI'ını kullanabilir. Bu isteğe bağlıdır; wiki, Obsidian olmadan da yerel modda çalışır.

Aracı kapsamındaki kasalar Obsidian ile uyumlu Markdown kullanmaya devam edebilir, ancak yapılandırma doğrulaması vault.scope: "agent" ile birlikte obsidian.useOfficialCli: true kullanımını reddeder. Geçerli obsidian.vaultName ayarı geneldir ve her aracı için ayrı bir Obsidian kasası seçemez. Bunun yerine wiki araçlarını ve CLI işlemlerini kullanın veya Obsidian tarafından işletilen wiki'yi genel kapsamda tutun.

Önerilen iş akışı

İlgili belgeler

• Belleğe Genel Bakış
• CLI: bellek
• CLI: wiki
• Plugin SDK'ya genel bakış