Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Nasıl çalışır?

Agentinizin bellekle ilgili üç dosyası vardır:
  • MEMORY.md — uzun vadeli bellek. Kalıcı olgular, 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ünün notları otomatik olarak yüklenir.
  • DREAMS.md (isteğe bağlı) — insan incelemesi için Dream Diary ve dreaming tarama özetleri; temellendirilmiş geçmişe dönük doldurma girdileri dahil.
Bu dosyalar agent çalışma alanında bulunur (varsayılan ~/.openclaw/workspace).

​
Ne nereye gider?

MEMORY.md kompakt, düzenlenmiş katmandır. Kalıcı olgular, tercihler, sürekli geçerli kararlar ve ana özel oturumun başında kullanılabilir olması gereken kısa özetler için kullanın. Ham bir transkript, günlük kayıt veya kapsamlı arşiv olması amaçlanmaz. memory/YYYY-MM-DD.md dosyaları çalışma katmanıdır. Ayrıntılı günlük notlar, gözlemler, oturum özetleri ve daha sonra hâlâ yararlı olabilecek ham bağlam için kullanın. Bu dosyalar memory_search ve memory_get için dizinlenir, ancak her turda normal başlangıç istemine enjekte edilmez. Zamanla agentin, günlük notlardaki yararlı materyali MEMORY.md içine damıtması ve eskimiş uzun vadeli girdileri kaldırması beklenir. Üretilen çalışma alanı talimatları ve Heartbeat akışı bunu periyodik olarak yapabilir; hatırlanan her ayrıntı için MEMORY.md dosyasını elle düzenlemeniz gerekmez. MEMORY.md başlangıç dosyası bütçesini aşarsa OpenClaw dosyayı diskte olduğu gibi tutar, ancak model bağlamına enjekte edilen kopyayı kırpar. Bunu, ayrıntılı materyali yeniden memory/*.md içine taşımanız, MEMORY.md içinde yalnızca kalıcı özeti tutmanız veya açıkça daha fazla istem bütçesi harcamak istiyorsanız başlangıç sınırlarını yükseltmeniz gerektiğine dair bir işaret olarak değerlendirin. Ham ve enjekte edilen boyutları ve kırpma durumunu görmek için /context list, /context detail veya openclaw doctor kullanın.
Agentinizin bir şeyi hatırlamasını istiyorsanız, ona söylemeniz yeterli: “TypeScript tercih ettiğimi hatırla.” Bunu uygun dosyaya yazar.

​
Çıkarılan taahhütler

Bazı gelecekteki takipler kalıcı olgular değildir. Yarın bir görüşmeden söz ederseniz 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ı agent ve kanalla sınırlar ve zamanı gelen kontrolleri Heartbeat üzerinden iletir. Açık hatırlatıcılar yine zamanlanmış görevler kullanır.

​
Bellek araçları

Agentin bellekle çalışmak için iki aracı vardır:
  • memory_search — ifade özgün metinden 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 tamamlayıcı plugin’i

Kalıcı belleğin yalnızca ham notlar yerine 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:
  • belirlenimci sayfa yapısı
  • yapılandırılmış iddialar ve kanıtlar
  • çelişki ve güncellik takibi
  • üretilen panolar
  • agent/çalışma zamanı tüketicileri için derlenmiş özetler
  • wiki_search, wiki_get, wiki_apply ve wiki_lint gibi wiki-yerel araçlar
Etkin bellek plugin’inin yerini almaz. Etkin bellek plugin’i hatırlama, yükseltme ve Dreaming sahipliğini sürdürür. memory-wiki bunun yanına köken bilgisi açısından zengin bir bilgi katmanı ekler. Bkz. Memory Wiki.

​
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 API anahtarınız olduğunda bu, kutudan çıktığı gibi çalışır.
OpenClaw, mevcut API anahtarlarından embedding sağlayıcınızı otomatik algılar. Yapılandırılmış bir OpenAI, Gemini, Voyage veya Mistral anahtarınız varsa bellek araması otomatik olarak etkinleştirilir.
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ı

Yerleşik (varsayılan)

SQLite tabanlıdır. Anahtar sözcük araması, vektör benzerliği ve hibrit aramayla 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 dizinleme yeteneği sunan yerel öncelikli sidecar.

Honcho

Kullanıcı modelleme, anlamsal arama ve çoklu agent farkındalığı içeren AI-yerel oturumlar arası bellek. Plugin kurulumu.

LanceDB

OpenAI uyumlu embedding’ler, otomatik hatırlama, otomatik yakalama ve yerel Ollama embedding desteği içeren, birlikte gelen LanceDB destekli bellek.

​
Bilgi wiki katmanı

Memory Wiki

Kalıcı belleği iddialar, panolar, köprü modu ve Obsidian dostu iş akışlarıyla köken bilgisi açısından zengin bir wiki kasasına derler.

​
Otomatik bellek boşaltma

Compaction konuşmanızı özetlemeden önce OpenClaw, agente ö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. 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 oturum yedek zincirini devralmaz.
Bellek boşaltma, Compaction sırasında bağlam kaybını önler. Agentinizin konuşmada henüz bir dosyaya yazılmamış önemli olguları varsa, özetleme gerçekleşmeden önce otomatik olarak kaydedilirler.

​
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 nitelikli öğeleri uzun vadeli belleğe (MEMORY.md) yükseltir. 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 tek bir cron işini otomatik yönetir.
  • Eşikli: yükseltmeler puan, hatırlama sıklığı ve sorgu çeşitliliği kapılarından 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ş geçmişe dönük doldurma ve canlı yükseltme

Dreaming sisteminin 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 neyin MEMORY.md içine yükselebileceğine karar verirken kullandığı şeydir.
  • Temellendirilmiş geçmişe dönük 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 içine yazar.
Temellendirilmiş geçmişe dönük doldurma, eski notları yeniden oynatmak ve MEMORY.md dosyasını elle düzenlemeden sistemin neleri kalıcı gördüğünü 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 yükseltilmez. Normal derin aşamanın zaten kullandığı aynı kısa vadeli Dreaming deposuna hazırlanırlar. 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 yükseltme tarafından yazılır.
Yeniden oynatmanın yararlı olmadığına karar verirseniz, olağan günlük girdilerine veya normal hatırlama durumuna dokunmadan hazırlanan 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

​
İlgili