memory-wiki, kalıcı bilgiyi gezinilebilir bir wiki hâlinde derleyen paketlenmiş bir plugindir: belirlenimci sayfalar, kanıtlarla 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ış olan bellek arka ucunun
(memory-core, QMD, Honcho vb.) sorumluluğunda kalır. memory-wiki onun yanında yer alır ve bilgiyi bakımı yapılan bir wiki katmanı hâlinde derler.
CLI’sini, araçlarını veya çalışma zamanı entegrasyonunu kullanmadan önce plugini etkinleştirin:
Pratik kural:
- Yapılandırılmış tüm derlemler genelinde tek bir geniş hatırlama geçişi için
memory_search - Wikiye özgü sıralama, kaynak geçmişi veya sayfa düzeyinde inanç yapısı istediğinizde
wiki_search/wiki_get - Active Memory plugini derlem seçimini desteklediğinde, tek çağrıda her iki katmanı da kapsamak için
memory_search corpus=all
bridge modunda
memory-wiki. Yapılandırma altındaki QMD + köprü modu örneğine bakın.
Köprü modu dışa aktarılmış 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ı, kendi kaynakları vardır; Active Memory pluginine bağımlılığı yoktur. Bağımsız ve özenle seçilmiş bir bilgi deposu için bunu kullanın.bridge: herkese açık plugin SDK bağlantı noktaları üzerinden Active Memory pluginindeki herkese açık bellek yapıtlarını ve olay günlüklerini okur. Bellek plugininin dışa aktardığı yapıtları, pluginin özel 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 özgü bir kaçış yoludur. Bilerek deneysel ve taşınamazdır; yalnızca güven sınırını anladığınızda ve özellikle köprü modunun sağlayamadığı yerel dosya sistemi erişimine ihtiyaç duyduğunuzda kullanın.
vaultMode, wiki girdilerinin nereden geleceğini seçer.vault.scope, tüm ajanların tek kasa kullanacağını mı yoksa her ajanın bir alt kasa alacağını mı seçer.
vault.scope: "global" varsayılandır ve mevcut tek kasa davranışını korur. Ajanların wiki 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 ajana ait girdiler değildir. Yapılandırma doğrulaması bu birleşimi reddeder.
Köprü modu, bridge.* yapılandırma anahtarına göre şunları indeksleyebilir:
- dışa aktarılmış bellek yapıtları (
indexMemoryRoot) - günlük notlar (
indexDailyNotes) - Dreaming raporları (
indexDreamReports) - bellek olay günlükleri (
followMemoryEvents)
bridge.readMemoryArtifacts etkinleştirildiğinde,
openclaw wiki status, openclaw wiki doctor ve openclaw wiki bridge import, ajan/çalışma zamanı belleğiyle aynı Active Memory plugini bağlamını görmeleri için çalışan Gateway üzerinden yönlendirilir. Köprü devre dışıysa veya yapıt okumaları kapalıysa bu komutlar yerel/çevrimdışı davranışını korur.
Kasa düzeni
sources/: içe aktarılmış ham materyal ile köprü/güvenli olmayan yerel destekli sayfalarentities/: kalıcı şeyler, kişiler, sistemler, projeler, nesnelerconcepts/: fikirler, soyutlamalar, örüntüler, politikalar (aynı zamanda OKF içe aktarımlarının hedef konumu)syntheses/: derlenmiş özetler ve bakımı yapılan toplu görünümlerreports/: oluşturulan panolar
Open Knowledge Format içe aktarımları
memory-wiki onu OpenClaw’a özgü kavram sayfalarına ve derlenmiş özetlere dönüştürsün.
- ayrılmamış
.mddosyaları kavram belgeleridir - içe aktarılan her kavram, boş olmayan bir
typefrontmatter alanı gerektirir; eksiktype, birmissing-typeuyarısı oluşturur ve dosya atlanır - bilinmeyen
typedeğerleri genel kavramlar olarak kabul edilir index.mdvelog.mdayrı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
concepts/ altında düzleştirilir; böylece mevcut derleme, arama, get ve pano akışları ikinci bir wiki 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 tüm frontmatter verilerini 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 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 verisi 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, wikinin pasif bir not yığını gibi değil, bir inanç katmanı gibi davranmasını sağlar. İddialar izlenebilir, puanlanabilir, itiraz konusu yapılabilir ve kaynaklara göre çö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ğinperson,team,system,projectcanonicalId: takma adlar ve içe aktarımlar genelinde kararlı kimlik anahtarıaliases: aynı sayfaya çözümlenen adlar, kullanıcı adları veya etiketlerprivacyTier: serbest biçimli dize;publicinceleme gerektirmeyen olarak değerlendirilir, diğer tüm değerler (örneğinlocal-private,sensitive,confirm-before-use)reports/privacy-review.mdiçinde işaretlenirbestUsedFor/notEnoughFor: kompakt 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, kulvar, sorulacak konular, sorulmaması gereken konular, güven düzeyi, gizlilik katmanı)relationships: ilişkili sayfalara yönelen türü belirlenmiş kenarlar (hedef, tür, ağırlık, güven düzeyi, kanıt türü, gizlilik katmanı, not)
reports/person-agent-directory.md ile başlayın, ardından iletişim bilgilerini veya çıkarılmış olguları kullanmadan önce kişi sayfasını wiki_get ile açın.
Varlık sayfası örneği
Varlık sayfası örneği
Derleme işlem hattı
Derleme, wiki sayfalarını okur, özetleri normalleştirir ve makineye yönelik bir anlık görüntüyü OpenClaw’ın paylaşılan SQLite plugin durumunda kalıcı hâle getirir. Çalışma zamanı kodu, eşzamansız istem hazırlığı sırasında SQLite’ı yüklemek için yaşam döngüsüne ait sahip anlık görüntüsünü kullanır; eşzamanlı istem oluşturma hiçbir zaman Markdown’ı kazımaz veya önbellek dosyalarını okumaz. Derlenmiş çıktı ayrıca arama/get için ilk geçiş wiki indekslemesini, iddia kimliklerinin sahip sayfalara geri çözümlenmesini, kompakt istem eklerini ve rapor oluşturmayı destekler. Kaynak düzenlemeleri ve kasa geri yüklemeleri, yalnızca sonraki derlemeden sonra makineye yönelik hâle gelir. Plugin yaşam döngüsünü yeniden başlatmak veya yenilemek, kasanın nedensel olarak zincirlenmiş derleme yayınını SQLite ile karşılaştırır ve daha yeni, geri alınmış bir durumdan gelen anlık görüntüyü reddeder. Geri almadan önce başlatılan bir derleyici, geri yüklenmiş öncül duruma karşı yayın yapamaz. İstem hazırlığı kasayı yoklamaz veya dosya izleyicileri kurmaz. Geri alma karantinasından sonra, çalışan süreçte yapılan bir derleme sahibi hemen temizler; ayrı bir derleyici süreci ise daemon’ın yeni kalıcı yayını doğrulayabilmesi için plugin yaşam döngüsünün yenilenmesini gerektirir. Derlenmiş önbellekler yeniden oluşturulabilir: yayın dönemlerinden önceki önbellek satırları isabetsiz kabul edilir ve sonraki derlemeyle değiştirilir; bunlar taşınmaz.Panolar ve sistem durumu raporları
render.createDashboards etkinleştirildiğinde derleme, reports/ altında panoların bakımını yapar:
Arama ve getirme
İki arama arka ucu:shared: kullanılabildiğinde paylaşılan bellek arama akışını kullanırlocal: wikiyi yerel olarak arar
wiki, memory, all.
wiki_search/wiki_get, mümkün olduğunda ilk geçiş olarak derlenmiş özetleri kullanır- iddia kimlikleri sahip sayfaya geri çözümlenir
- itirazlı/eskimiş/güncel iddialar sıralamayı etkiler
- kaynak geçmişi etiketleri sonuçlarda korunur
--mode / araç 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 değerlerini döndürür. Metin çıktısı,
mevcut olduğunda kısa Claim: ve Evidence: satırlarını içerir.
Ajan araçları
Plugin ayrıca münhasır olmayan bir bellek külliyatı eklentisi 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
plugin durumundan derlenen kısa 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 biçimini değiştirdiği için bu özellik
isteğe bağlıdır; esas olarak bellek eklentilerini açıkça kullanan bağlam
motorları veya istem oluşturma süreçleri açısından önem taşır.
Yapılandırma
Yapılandırmayıplugins.entries.memory-wiki.config altına yerleştirin:
Ajan başına kasalar
Yapılandırılmış her ajana ayrı bir wiki vermek içinvault.scope değerini
agent olarak ayarlayın. Bu kapsamda vault.path bir üst
dizindir ve OpenClaw normalleştirilmiş ajan kimliğini buna ekler:
~/.openclaw/wiki/support ve ~/.openclaw/wiki/marketing olarak çözümlenir.
Ajan kapsamında vault.path belirtilmezse üst dizin varsayılan olarak
~/.openclaw/wiki olur. Bu nedenle varsayılan main ajanı mevcut
~/.openclaw/wiki/main yolunu korur.
Ajan araçları, derlenmiş istem özetleri ve memory_search /
memory_get üzerinden sunulan wiki eklentisi, kasayı etkin ajan
bağlamından çözümler. Birden çok yapılandırılmış ajanın bulunduğu bir kurulumda
CLI ve Gateway çağrıları için ajanı openclaw wiki --agent <agentId> ... veya Gateway isteğinin
agentId değeriyle açıkça belirtin. Kimlik sağlanmadığında tek bir
yapılandırılmış ajan varsayılan olarak kalır.
Köprü modunda, ajan kapsamlı içe aktarmalar yalnızca agentIds değeri
seçili ajanı içeriyorsa herkese açık bir bellek yapıtını kabul eder. Başka bir
ajana ait olan, sahiplik meta verileri bulunmayan veya sahibi bilinmeyen
yapıtlar atlanır. Genel kapsam, mevcut paylaşılan yapıt davranışını korur.
Örnek: QMD + köprü modu
Geri çağırma için QMD, sürdürülen bir bilgi katmanı içinmemory-wiki kullanmak istediğinizde bunu kullanın. Her katman kendi
alanına odaklanır: QMD ham notları, oturum dışa aktarımlarını ve ek
koleksiyonları aranabilir tutarken memory-wiki kararlı varlıkları,
iddiaları, panoları ve kaynak sayfalarını derler.
memory-wiki bileşenini derlenmiş sayfalara ve panolara odaklar ve
derlenmiş özet istemlerini bilinçli olarak etkinleştirene kadar istem biçimini
değiştirmez.
CLI
wiki okf import, wiki apply metadata, wiki unsafe-local import,
wiki chatgpt import / wiki chatgpt rollback ve eksiksiz wiki obsidian
alt komut kümesi dâhil olmak üzere tüm 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 yoklama, kasa arama, sayfa
açma, komut çağırma ve günlük nota gitme işlemleri için resmî
obsidian CLI’ı kullanabilir. Bu isteğe bağlıdır; wiki, Obsidian
olmadan yerel modda çalışmaya devam eder.
Ajan kapsamlı kasalar Obsidian ile uyumlu Markdown kullanmaya devam edebilir,
ancak yapılandırma doğrulaması obsidian.useOfficialCli: true ile
vault.scope: "agent" birleşimini reddeder. Geçerli obsidian.vaultName ayarı
geneldir ve her ajan 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 bir
wiki’yi genel kapsamda tutun.
Önerilen iş akışı
1
Geri çağırma için etkin bellek plugin'ini koruyun
Geri çağırma, yükseltme ve Dreaming, yapılandırılmış bellek arka ucunun sorumluluğunda kalır.
2
memory-wiki'yi etkinleştirin
Açıkça köprü modunu istemediğiniz sürece
isolated moduyla başlayın.3
Kaynak geçmişi önemli olduğunda wiki_search / wiki_get kullanın
Wiki’ye özgü sıralama veya sayfa düzeyinde inanç yapısı istediğinizde bunları
memory_search yerine tercih edin.4
Dar kapsamlı sentezler veya meta veri güncellemeleri için wiki_apply kullanın
Yönetilen, oluşturulmuş blokları elle düzenlemekten kaçının.
5
Anlamlı değişikliklerden sonra wiki_lint çalıştırın
Çelişkileri, açık soruları ve kaynak geçmişindeki boşlukları yakalar.
6
Eskimişlik/çelişki görünürlüğü için panoları etkinleştirin
render.createDashboards: true değerini ayarlayın (varsayılan).