openclaw memory
Anlamsal bellek dizinlemeyi ve aramayı yönetin.
Paketle gelen memory-core plugin tarafından sağlanır. Komut,
plugins.slots.memory memory-core seçtiğinde kullanılabilir (varsayılan); diğer bellek pluginleri
kendi CLI ad alanlarını sunar.
İlgili:
- Bellek kavramı: Bellek
- Bellek wiki’si: Bellek Wiki
- Wiki CLI: wiki
- Pluginler: Pluginler
Örnekler
Seçenekler
memory status ve memory index:
--agent <id>: kapsamı tek bir ajanla sınırlar. Bu seçenek olmadan, bu komutlar yapılandırılmış her ajan için çalışır; ajan listesi yapılandırılmamışsa varsayılan ajana geri dönerler.--verbose: yoklamalar ve dizinleme sırasında ayrıntılı günlükler üretir.
memory status:
--deep: yerel vektör deposu hazır oluşunu, gömme sağlayıcı hazır oluşunu ve anlamsal vektör araması hazır oluşunu yoklar. Düzmemory statushızlı kalır ve canlı gömme ya da sağlayıcı keşfi işi çalıştırmaz; bilinmeyen vektör deposu veya anlamsal vektör durumu, o komutta yoklanmadığı anlamına gelir. QMD sözlükselsearchMode: "search",--deepile bile anlamsal vektör yoklamalarını ve gömme bakımını atlar.--index: depo kirliyse yeniden dizinleme çalıştırır (--deepanlamına gelir).--fix: eski hatırlama kilitlerini onarır ve yükseltme meta verilerini normalleştirir.--json: JSON çıktısı yazdırır.
memory status Dreaming status: blocked gösteriyorsa, yönetilen Dreaming cron etkindir ancak onu süren Heartbeat varsayılan ajan için çalışmıyordur. İki yaygın neden için Dreaming hiç çalışmıyor bölümüne bakın.
memory index:
--force: tam yeniden dizinlemeyi zorlar.
memory search:
- Sorgu girdisi: konumsal
[query]veya--query <text>geçirin. - İkisi de sağlanırsa
--querykazanır. - Hiçbiri sağlanmazsa komut bir hatayla çıkar.
--agent <id>: kapsamı tek bir ajanla sınırlar (varsayılan: varsayılan ajan).--max-results <n>: döndürülen sonuç sayısını sınırlar.--min-score <n>: düşük skorlu eşleşmeleri filtreler.--json: JSON sonuçları yazdırır.
memory promote:
Kısa süreli bellek yükseltmelerini önizleyin ve uygulayın.
--apply— yükseltmeleriMEMORY.mddosyasına yazar (varsayılan: yalnızca önizleme).--limit <n>— gösterilen aday sayısını sınırlar.--include-promoted— önceki döngülerde zaten yükseltilmiş girdileri dahil eder.
memory/YYYY-MM-DD.mdiçindeki kısa süreli adayları ağırlıklı yükseltme sinyallerini (frequency,relevance,query diversity,recency,consolidation,conceptual richness) kullanarak sıralar.- Hem bellek hatırlamalarından hem de günlük alım geçişlerinden gelen kısa süreli sinyalleri, ayrıca hafif/REM aşaması pekiştirme sinyallerini kullanır.
- Dreaming etkin olduğunda,
memory-corearka planda tam bir tarama (light -> REM -> deep) çalıştıran tek bir cron işini otomatik yönetir (elleopenclaw cron addgerekmez). --agent <id>: kapsamı tek bir ajanla sınırlar (varsayılan: varsayılan ajan).--limit <n>: döndürülecek/uygulanacak en fazla aday sayısı.--min-score <n>: minimum ağırlıklı yükseltme skoru.--min-recall-count <n>: bir aday için gereken minimum hatırlama sayısı.--min-unique-queries <n>: bir aday için gereken minimum farklı sorgu sayısı.--apply: seçili adaylarıMEMORY.mddosyasına ekler ve yükseltilmiş olarak işaretler.--include-promoted: çıktıya zaten yükseltilmiş adayları dahil eder.--json: JSON çıktısı yazdırır.
memory promote-explain:
Belirli bir yükseltme adayını ve skor dökümünü açıklayın.
<selector>: aranacak aday anahtarı, yol parçası veya kesit parçası.--agent <id>: kapsamı tek bir ajanla sınırlar (varsayılan: varsayılan ajan).--include-promoted: zaten yükseltilmiş adayları dahil eder.--json: JSON çıktısı yazdırır.
memory rem-harness:
Hiçbir şey yazmadan REM yansımalarını, aday gerçekleri ve derin yükseltme çıktısını önizleyin.
--agent <id>: kapsamı tek bir ajanla sınırlar (varsayılan: varsayılan ajan).--include-promoted: zaten yükseltilmiş derin adayları dahil eder.--json: JSON çıktısı yazdırır.
Dreaming
Dreaming, üç işbirlikçi aşamaya sahip arka plan bellek pekiştirme sistemidir: light (kısa süreli materyali sırala/aşamaya al), deep (kalıcı olgularıMEMORY.md içine yükselt) ve REM (yansıt ve temaları yüzeye çıkar).
plugins.entries.memory-core.config.dreaming.enabled: trueile etkinleştirin.- Sohbetten
/dreaming on|offile değiştirin (veya/dreaming statusile inceleyin). Kanal çağıranların ayarı değiştirmek için sahip olması gerekir; Gateway istemcilerininoperator.adminyetkisine ihtiyacı vardır. Salt okunur durum ve yardım, yetkili komut göndericilerine açık kalır. - Dreaming, tek bir yönetilen tarama zamanlamasında (
dreaming.frequency) çalışır ve aşamaları sırayla yürütür: light, REM, deep. - Yalnızca deep aşaması kalıcı belleği
MEMORY.mddosyasına yazar. - İnsan tarafından okunabilir aşama çıktısı ve günlük girdileri
DREAMS.md(veya mevcutdreams.md) dosyasına, isteğe bağlı aşama başına raporlarlamemory/dreaming/<phase>/YYYY-MM-DD.mdiçine yazılır. - Sıralama ağırlıklı sinyaller kullanır: hatırlama sıklığı, getirme ilgililiği, sorgu çeşitliliği, zamansal yakınlık, günler arası pekiştirme ve türetilmiş kavram zenginliği.
- Yükseltme,
MEMORY.mddosyasına yazmadan önce canlı günlük notu yeniden okur; böylece düzenlenmiş veya silinmiş kısa süreli kesitler eski hatırlama deposu anlık görüntülerinden yükseltilmez. - Zamanlanmış ve elle çalıştırılan
memory promoteçalışmaları, CLI eşik geçersiz kılmaları vermediğiniz sürece aynı deep aşaması varsayılanlarını paylaşır. - Otomatik çalışmalar yapılandırılmış bellek çalışma alanlarına yayılır.
- Tarama sıklığı:
dreaming.frequency = 0 3 * * * - Deep eşikleri:
minScore=0.8,minRecallCount=3,minUniqueQueries=3,recencyHalfLifeDays=14,maxAgeDays=30
memory index --verboseaşama başına ayrıntıları yazdırır (sağlayıcı, model, kaynaklar, toplu işlem etkinliği).memory status,memorySearch.extraPathsile yapılandırılmış ek yolları içerir.- Etkin bellek uzak API anahtarı alanları SecretRef olarak yapılandırılmışsa komut bu değerleri etkin Gateway anlık görüntüsünden çözer. Gateway kullanılamıyorsa komut hızlı başarısız olur.
- Gateway sürüm uyuşmazlığı notu: bu komut yolu
secrets.resolvedestekleyen bir Gateway gerektirir; daha eski Gatewayler bilinmeyen yöntem hatası döndürür. - Zamanlanmış tarama sıklığını
dreaming.frequencyile ayarlayın. Deep yükseltme politikası, kaynak görünürlüğünü korurken yükseltilmiş kesit uzunluğunu sınırlayandreaming.phases.deep.maxPromotedSnippetTokensdışında dahili kalır. Tek seferlik manuel eşik geçersiz kılmalarına ihtiyacınız olduğundamemory promoteüzerinde CLI bayraklarını kullanın. memory rem-harness --path <file-or-dir> --grounded, hiçbir şey yazmadan tarihsel günlük notlardan temellendirilmişWhat Happened,ReflectionsvePossible Lasting Updatesönizlemesi yapar.memory rem-backfill --path <file-or-dir>, UI incelemesi için geri alınabilir temellendirilmiş günlük girdileriniDREAMS.mdiçine yazar.memory rem-backfill --path <file-or-dir> --stage-short-term, normal deep aşamasının bunları sıralayabilmesi için temellendirilmiş kalıcı adayları canlı kısa süreli yükseltme deposuna da eker.memory rem-backfill --rollback, daha önce yazılmış temellendirilmiş günlük girdilerini kaldırır vememory rem-backfill --rollback-short-term, daha önce aşamaya alınmış temellendirilmiş kısa süreli adayları kaldırır.- Tam aşama açıklamaları ve yapılandırma başvurusu için Dreaming bölümüne bakın.