Ana içeriğe atla

Memory Overview

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

Nasıl çalışır

Aracınızın anıları depolamak için iki yeri vardır:
  • MEMORY.md — uzun süreli bellek. Kalıcı gerçekler, tercihler ve kararlar. Her DM oturumunun başında yüklenir.
  • memory/YYYY-MM-DD.md — günlük notlar. Devam eden bağlam ve gözlemler. Bugünün ve dünkü notlar otomatik olarak yüklenir.
Bu dosyalar aracının çalışma alanında bulunur (varsayılan ~/.openclaw/workspace).
Aracınızın bir şeyi hatırlamasını istiyorsanız ona söylemeniz yeterlidir: “TypeScript tercih ettiğimi hatırla.” Bunu uygun dosyaya yazar.

Bellek araçları

Aracının bellekle çalışmak için iki aracı vardır:
  • memory_search — özgün ifadeden farklı olsa bile anlam tabanlı 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).

Bellek araması

Bir embedding 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ştirmesiyle (kimlikler ve kod sembolleri gibi tam terimler) birleştirir. Desteklenen herhangi bir sağlayıcı için bir API key’iniz olduğunda bu kutudan çıktığı gibi çalışır.
OpenClaw, kullanılabilir API key’lerden embedding sağlayıcınızı otomatik algılar. OpenAI, Gemini, Voyage veya Mistral anahtarınız yapılandırılmışsa bellek araması otomatik olarak etkinleştirilir.
Aramanın nasıl çalıştığı, ayar seçenekleri ve sağlayıcı kurulumu hakkında ayrıntılar için bkz. Memory Search.

Bellek arka uçları

Yerleşik (varsayılan)

SQLite tabanlıdır. Anahtar sözcük araması, vektör benzerliği ve hibrit arama ile kutudan çıktığı gibi çalışır. Ek bağımlılık yoktur.

QMD

Yeniden sıralama, sorgu genişletme ve çalışma alanı dışındaki dizinleri dizine ekleme yeteneğine sahip local-first yan hizmet.

Honcho

Kullanıcı modelleme, anlamsal arama ve çoklu aracı farkındalığı ile AI-native oturumlar arası bellek. Plugin kurulumu.

Otomatik bellek boşaltma

Compaction konuşmanızı özetlemeden önce OpenClaw, aracıya önemli bağlamı bellek dosyalarına kaydetmesini hatırlatan sessiz bir tur çalıştırır. Bu varsayılan olarak açıktır — herhangi bir şey yapılandırmanız gerekmez.
Bellek boşaltma, compaction sırasında bağlam kaybını önler. Aracınızın konuşmada henüz bir dosyaya yazılmamış önemli gerçekleri varsa, özetleme gerçekleşmeden önce bunlar otomatik olarak kaydedilir.

Dreaming (deneysel)

Dreaming, bellek için isteğe bağlı bir arka plan sağlamlaştırma geçişidir. Günlük dosyalarındaki (memory/YYYY-MM-DD.md) kısa süreli hatırlamaları yeniden gözden geçirir, puanlar ve yalnızca uygun öğeleri uzun süreli belleğe (MEMORY.md) yükseltir. Uzun süreli belleği yüksek sinyalli tutmak için tasarlanmıştır:
  • İsteğe bağlı katılım: varsayılan olarak kapalıdır.
  • Zamanlanmış: etkinleştirildiğinde, memory-core yinelenen görevi otomatik olarak yönetir.
  • Eşikli: yükseltmeler puan, hatırlama sıklığı ve sorgu çeşitliliği kapılarını geçmelidir.
Mod davranışı (off, core, rem, deep), puanlama sinyalleri ve ayar düğmeleri için bkz. Dreaming (experimental).

CLI

openclaw memory status          # Dizin durumunu ve sağlayıcıyı kontrol et
openclaw memory search "query"  # Komut satırından ara
openclaw memory index --force   # Dizini yeniden oluştur

Daha fazla bilgi