Belleğe genel bakış

OpenClaw, bir şeyleri ajanınızın çalışma alanına düz Markdown dosyaları yazarak hatırlar. Model yalnızca diske kaydedilenleri "hatırlar"; gizli durum yoktur.

# Nasıl çalışır

Ajanınızda bellekle ilgili üç dosya vardır:

• MEMORY.md — uzun vadeli bellek. Kalıcı bilgiler, tercihler ve kararlar. Her DM oturumunun başında yüklenir.
• memory/YYYY-MM-DD.md — günlük notlar. Süregelen bağlam ve gözlemler. Bugünün ve dünün notları otomatik olarak yüklenir.
• DREAMS.md (isteğe bağlı) — insan incelemesi için Dream Diary ve dreaming taraması özetleri; temellendirilmiş tarihsel geri doldurma girdileri dahil.

Bu dosyalar ajan çalışma alanında bulunur (varsayılan ~/.openclaw/workspace).

# Çıkarılan taahhütler

Bazı gelecekteki takipler kalıcı bilgiler değildir. Yarın bir görüşmeden bahsederseniz, yararlı bellek "bunu sonsuza dek MEMORY.md içinde sakla" değil, "görüşmeden sonra kontrol et" olabilir.

Taahhütler, bu durum için isteğe bağlı, kısa ömürlü takip bellekleridir. OpenClaw bunları gizli bir arka plan geçişinde çıkarır, aynı ajan ve kanalla sınırlar ve zamanı gelen kontrolleri Heartbeat üzerinden iletir. Açık hatırlatıcılar hâlâ zamanlanmış görevleri kullanır.

# Bellek araçları

Ajanın bellekle çalışmak için iki aracı vardır:

• memory_search — ifade biçimi özgünden farklı olsa bile, anlamsal arama kullanarak ilgili notları bulur.
• memory_get — belirli bir bellek dosyasını veya satır aralığını okur.

Her iki araç da etkin bellek Plugin'i tarafından sağlanır (varsayılan: memory-core).

# Memory Wiki eşlikçi Plugin'i

Kalıcı belleğin yalnızca ham notlar olmaktan çok, bakımı yapılan bir bilgi tabanı gibi davranmasını istiyorsanız, birlikte gelen memory-wiki Plugin'ini kullanın.

memory-wiki, kalıcı bilgiyi şu özelliklere sahip bir wiki kasasına derler:

• deterministik sayfa yapısı
• yapılandırılmış iddialar ve kanıtlar
• çelişki ve güncellik takibi
• oluşturulan panolar
• ajan/çalışma zamanı tüketicileri için derlenmiş özetler
• wiki_search, wiki_get, wiki_apply ve wiki_lint gibi wikiye özgü araçlar

Etkin bellek Plugin'inin yerini almaz. Etkin bellek Plugin'i hatırlama, terfi ve Dreaming sahipliğini sürdürür. memory-wiki, bunun yanına köken bilgisi zengin bir bilgi katmanı ekler.

Bkz. Memory Wiki.

# Bellek araması

Bir gömme sağlayıcısı yapılandırıldığında, memory_search hibrit arama kullanır: vektör benzerliğini (anlamsal anlam) anahtar sözcük eşleştirmeyle (ID'ler ve kod sembolleri gibi tam terimler) birleştirir. Desteklenen herhangi bir sağlayıcı için bir API anahtarınız olduğunda bu kutudan çıktığı gibi çalışır.

Aramanın nasıl çalıştığı, ayarlama seçenekleri ve sağlayıcı kurulumu hakkında ayrıntılar için bkz. Bellek Araması.

# Bellek arka uçları

# Bilgi wiki katmanı

# Otomatik bellek boşaltma

Compaction konuşmanızı özetlemeden önce OpenClaw, ajana önemli bağlamı bellek dosyalarına kaydetmesini hatırlatan sessiz bir tur çalıştırır. Bu varsayılan olarak açıktır; hiçbir şey yapılandırmanız gerekmez.

Bu bakım turunu yerel bir modelde tutmak için tam bir bellek boşaltma modeli geçersiz kılması ayarlayın:

{
  "agents": {
    "defaults": {
      "compaction": {
        "memoryFlush": {
          "model": "ollama/qwen3:8b"
        }
      }
    }
  }
}

Geçersiz kılma yalnızca bellek boşaltma turuna uygulanır ve etkin oturumun yedek zincirini devralmaz.

# Dreaming

Dreaming, bellek için isteğe bağlı bir arka plan pekiştirme geçişidir. Kısa vadeli sinyalleri toplar, adayları puanlar ve yalnızca uygun öğeleri uzun vadeli belleğe (MEMORY.md) terfi ettirir.

Uzun vadeli belleği yüksek sinyalli tutmak için tasarlanmıştır:

• İsteğe bağlı: varsayılan olarak devre dışıdır.
• Zamanlanmış: etkinleştirildiğinde memory-core, tam bir dreaming taraması için yinelenen bir cron işini otomatik olarak yönetir.
• Eşikli: terfiler puan, hatırlama sıklığı ve sorgu çeşitliliği kapılarını geçmelidir.
• İncelenebilir: aşama özetleri ve günlük girdileri insan incelemesi için DREAMS.md dosyasına yazılır.

Aşama davranışı, puanlama sinyalleri ve Dream Diary ayrıntıları için bkz. Dreaming.

# Temellendirilmiş geri doldurma ve canlı terfi

Dreaming sisteminde artık yakından ilişkili iki inceleme hattı vardır:

• Canlı dreaming, memory/.dreams/ altındaki kısa vadeli dreaming deposundan çalışır ve normal derin aşamanın MEMORY.md dosyasına neyin geçebileceğine karar verirken kullandığı yoldur.
• Temellendirilmiş geri doldurma, geçmiş memory/YYYY-MM-DD.md notlarını bağımsız gün dosyaları olarak okur ve yapılandırılmış inceleme çıktısını DREAMS.md dosyasına yazar.

Temellendirilmiş geri doldurma, eski notları yeniden oynatmak ve sistemin neyi kalıcı gördüğünü MEMORY.md dosyasını elle düzenlemeden incelemek istediğinizde yararlıdır.

Şunu kullandığınızda:

openclaw memory rem-backfill --path ./memory --stage-short-term

temellendirilmiş kalıcı adaylar doğrudan terfi ettirilmez. Normal derin aşamanın zaten kullandığı aynı kısa vadeli dreaming deposuna sahnelenirler. Bunun anlamı:

• DREAMS.md, insan inceleme yüzeyi olarak kalır.
• kısa vadeli depo, makineye dönük sıralama yüzeyi olarak kalır.
• MEMORY.md hâlâ yalnızca derin terfi tarafından yazılır.

Yeniden oynatmanın yararlı olmadığına karar verirseniz, sıradan günlük girdilerine veya normal hatırlama durumuna dokunmadan sahnelenen artifaktları kaldırabilirsiniz:

openclaw memory rem-backfill --rollback
openclaw memory rem-backfill --rollback-short-term

# CLI

openclaw memory status          # Check index status and provider
openclaw memory search "query"  # Search from the command line
openclaw memory index --force   # Rebuild the index

# Ek okuma

• Yerleşik bellek motoru: varsayılan SQLite arka ucu.
• QMD bellek motoru: gelişmiş yerel öncelikli sidecar.
• Honcho belleği: AI-native oturumlar arası bellek.
• Memory LanceDB: OpenAI uyumlu gömmelere sahip LanceDB destekli Plugin.
• Memory Wiki: derlenmiş bilgi kasası ve wikiye özgü araçlar.
• Bellek araması: arama hattı, sağlayıcılar ve ayarlama.
• Dreaming: kısa vadeli hatırlamadan uzun vadeli belleğe arka plan terfisi.
• Bellek yapılandırması başvurusu: tüm yapılandırma düğmeleri.
• Compaction: Compaction'ın bellekle nasıl etkileştiği.

# İlgili

• Active Memory
• Bellek araması
• Yerleşik bellek motoru
• Honcho belleği
• Memory LanceDB
• Taahhütler