Bellek yapılandırma başvurusu

Bu sayfa, OpenClaw bellek araması için tüm yapılandırma seçeneklerini listeler. Kavramsal genel bakışlar için bkz.:

Tüm paylaşılan bellek ayarları, openclaw.json içindeki üst düzey memory altında bulunur. Arama varsayılanları memory.search; aracı başına arama geçersiz kılmaları ise agents.entries.*.memory.search kullanır.

Konuşmalar arasında hatırlama

Yalnızca güvenilir bir kişisel aracının konuşmalar arası transkript hatırlamasını kullanması gerektiğinde bunu aracı başına yapılandırın:

{  agents: {    entries: {      personal: {        memory: {          search: {            rememberAcrossConversations: true,          },        },      },    },  },}

Değer, aracı başına geçersiz kılmayla normal memory.search devralmasını izler. Ayarlanmadığında, yalnızca genel session.dmScope ayarlanmamışsa veya "main" ise ve hiçbir bağlamada session.dmScope geçersiz kılması yoksa varsayılan olarak açılır. Yapılandırılmış herhangi bir DM yalıtımı, varsayılan olarak bunu kapatır. Açıkça belirtilen true veya false her zaman önceliklidir. Etkinleştirilmesi, oturum transkripti dizinlemeyi gerektirir ve aracının çözümlenmiş bellek kaynaklarına sessions ekler. QMD ile ayrıca o aracının oturum dışa aktarımını etkinleştirir; bu mod için ayrı bir memory.qmd.sessions.enabled ayarı gerekmez.

OpenClaw'ın yerleşik bellek sağlayıcısı, bu korumalı yolu hem yerleşik hem de QMD arka uçlarıyla destekler. Alternatif bellek sağlayıcıları kendi hatırlama kancalarını ve gelişmiş Active Memory araçlarını kullanmaya devam edebilir, ancak geçerli sağlayıcı korumalı özel transkript hatırlamayı desteklemediği sürece bu ayar atlanır. openclaw doctor, desteklenmeyen bir sağlayıcıyı veya memory_search öğesini içermeyen açık bir Active Memory toolsAllow listesini bildirir.

Getirme sınırı, genel oturum aramasından daha dardır:

• yalnızca aynı aracının tanınan özel konuşmaları uygundur
• yanıtlanan konuşma hariç tutulur
• gruplar ve kanallar kaynak ve hedef olarak hariç tutulur
• bilinmeyen konuşma türleri güvenli biçimde reddedilir
• korumalı alandaki hatırlama, özel konuşmalar arası yetkilendirmeyi kullanamaz

Bu ayar; tools.sessions.visibility, oturum anahtarları, transkript depolama, teslim yönlendirme veya sessions_list, sessions_history ve sessions_send izinlerini değiştirmez. Active Memory, sınırlı ve salt okunur bir getirme geçişi gerçekleştirir; kullanılamayan veya zaman aşımına uğrayan getirme, yanıtı engellemez.

Sağlayıcı seçimi

provider ayarlanmadığında OpenClaw, OpenAI gömmelerini kullanır. Bedrock, DeepInfra, Gemini, GitHub Copilot, Mistral, Ollama, Voyage, yerel bir GGUF modeli veya OpenAI uyumlu bir /v1/embeddings uç noktası kullanmak için provider değerini açıkça ayarlayın. Hâlâ provider: "auto" belirten eski yapılandırmalar openai olarak çözümlenir.

provider ayarlanmamışsa, eski provider: "auto" mevcutsa veya provider: "none" bilinçli olarak yalnızca FTS modunu seçiyorsa, gömmeler kullanılamadığında bellekten hatırlama yine de sözcüksel FTS sıralamasını kullanabilir.

Açıkça belirtilen yerel olmayan sağlayıcılar güvenli biçimde reddedilir. memory.search.provider değerini Bedrock, DeepInfra, Gemini, GitHub Copilot, LM Studio, Mistral, Ollama, OpenAI, Voyage veya OpenAI uyumlu özel sağlayıcı gibi uzak destekli somut bir sağlayıcıya ayarlarsanız ve bu sağlayıcı çalışma zamanında kullanılamazsa, memory_search sessizce yalnızca FTS hatırlamayı kullanmak yerine kullanılamıyor sonucu döndürür. Sağlayıcı/kimlik doğrulama yapılandırmasını düzeltin, erişilebilir bir sağlayıcıya geçin veya bilinçli olarak yalnızca FTS hatırlama istiyorsanız provider: "none" değerini ayarlayın.

Özel sağlayıcı kimlikleri

memory.search.provider; ollama gibi belleğe özgü sağlayıcı bağdaştırıcıları veya openai-responses / openai-completions gibi OpenAI uyumlu model API'leri için özel bir models.providers.<id> girdisini gösterebilir. OpenClaw, uç nokta, kimlik doğrulama ve model öneki işlemleri için özel sağlayıcı kimliğini korurken gömme bağdaştırıcısına ait sağlayıcının api sahibini çözümler. Bu, çoklu GPU veya çoklu ana makine kurulumlarının bellek gömmelerini belirli bir yerel uç noktaya ayırmasına olanak tanır:

{  models: {    providers: {      "ollama-5080": {        api: "ollama",        baseUrl: "http://gpu-box.local:11435",        apiKey: "ollama-local",        models: [{ id: "qwen3-embedding:0.6b", name: "Qwen3 Embedding 0.6B" }],      },    },  },  memory: {    search: {      provider: "ollama-5080",      model: "qwen3-embedding:0.6b",    },  },}

API anahtarı çözümleme

Uzak gömmeler bir API anahtarı gerektirir. Bedrock bunun yerine AWS SDK varsayılan kimlik bilgisi zincirini kullanır (örnek rolleri, SSO, erişim anahtarları veya Bedrock API anahtarı).

Uzak uç nokta yapılandırması

Genel OpenAI sohbet kimlik bilgilerini devralmaması gereken genel, OpenAI uyumlu bir /v1/embeddings sunucusu için provider: "openai-compatible" kullanın.

{  memory: {    search: {      provider: "openai-compatible",      model: "text-embedding-3-small",      remote: {        baseUrl: "https://api.example.com/v1/",        apiKey: "YOUR_KEY",      },    },  },}

Sağlayıcıya özgü yapılandırma

{  memory: {    search: {      provider: "openai-compatible",      remote: {        baseUrl: "https://embeddings.example/v1",        apiKey: "${EMBEDDINGS_API_KEY}",      },      model: "asymmetric-embedder",      queryInputType: "query",      documentInputType: "passage",    },  },}

{  memory: {    search: {      provider: "bedrock",      model: "amazon.titan-embed-text-v2:0",    },  },}

{  "Effect": "Allow",  "Action": "bedrock:InvokeModel",  "Resource": "*"}

arn:aws:bedrock:*::foundation-model/amazon.titan-embed-text-v2:0

openclaw memory status --deep --agent mainopenclaw memory index --force --agent main

İndeksleme davranışı

Bellek motorları eşitleme, toplu işleme, izleme ve Compaction sonrası indeksleme buluşsal yöntemlerini yönetir. OpenClaw, kurulum başına zamanlama anahtarları sunmak yerine bu davranışları bakımı yapılan varsayılanlarla etkin tutar.

Karma arama yapılandırması

Tümü memory.search.query altında:

Karma getirme etkin kalır; MMR ve zamansal azalma, yerleşik motor politikası tarafından devre dışı bırakılmış olarak kalır.

Tam örnek

{  memory: {    search: {      query: {        maxResults: 6,        minScore: 0.35,      },    },  },}

Ek bellek yolları

{  memory: {    search: {      extraPaths: ["../team-docs", "/srv/shared-notes"],    },  },}

Yollar mutlak veya çalışma alanına göre olabilir. Dizinler, .md dosyaları için özyinelemeli olarak taranır. Sembolik bağlantıların işlenmesi etkin arka uca bağlıdır: yerleşik motor sembolik bağlantıları atlarken QMD, temel QMD tarayıcısının davranışını izler.

Aracı kapsamındaki aracılar arası transkript araması için memory.qmd.paths yerine agents.entries.*.memory.search.qmd.extraCollections kullanın. Bu ek koleksiyonlar aynı { path, name, pattern? } biçimini izler ancak aracı başına birleştirilir ve yol geçerli çalışma alanının dışını gösterdiğinde açık paylaşılan adları koruyabilir. Aynı çözümlenmiş yol hem memory.qmd.paths hem de memory.search.qmd.extraCollections içinde görünürse QMD ilk girdiyi tutar ve yineleneni atlar.

Çok modlu bellek (Gemini)

Gemini Embedding 2 kullanarak Markdown'ın yanı sıra görüntüleri ve sesleri de indeksleyin:

Desteklenen biçimler: .jpg, .jpeg, .png, .webp, .gif, .heic, .heif (görüntüler); .mp3, .wav, .ogg, .opus, .m4a, .aac, .flac (ses).

Gömme önbelleği

Yeniden indeksleme veya transkript güncellemeleri sırasında değişmemiş metnin yeniden gömülmesini önler.

Toplu indeksleme

gemini, openai ve voyage için kullanılabilir. OpenAI toplu işleme, büyük geriye dönük doldurma işlemleri için genellikle en hızlı ve en ucuz seçenektir.

Eşzamanlılık, yoklama ve zaman aşımı davranışı sağlayıcı tarafından yönetilir.

Oturum belleği araması

Oturum transkriptlerini indeksleyin ve memory_search aracılığıyla kullanıma sunun:

Model tarafından çağrılan sıradan oturum transkripti araması tools.sessions.visibility ayarına uyar. Varsayılan tree görünürlüğü geçerli oturumu, onun başlattığı oturumları ve ortam grup farkındalığı aracılığıyla izlenen aynı ajana ait grup oturumlarını açığa çıkarır. İlgisiz diğer oturumlar agent görünürlüğünü gerektirir (veya yalnızca ajanlar arası hatırlama da gerektiğinde ve ajanlar arası politika buna izin verdiğinde all).

rememberAcrossConversations bu ayarın kapsamını genişletmez. Sınırlı Active Memory geçişi sırasında aynı ajana ait özel transkriptlerle sınırlı, yalnızca çalışma zamanında geçerli ayrı bir yetkilendirme sağlar.

Aşağıdaki örneklerde bu ayarlar üst düzey memory.search altında yer alır. Yalnızca bir ajanın oturum transkriptlerini indekslemesi ve araması gerekiyorsa eşdeğer ayarları ajan başına memory.search geçersiz kılmasında da uygulayabilirsiniz.

Aynı ajan için gateway'den DM'e hatırlama:

{  memory: {    search: {      experimental: { sessionMemory: true },      sources: ["memory", "sessions"],    },  },  tools: {    sessions: { visibility: "agent" },  },}

{  memory: {    backend: "qmd",    search: {      experimental: { sessionMemory: true },      sources: ["memory", "sessions"],    },    qmd: {      sessions: { enabled: true },    },  },  tools: {    sessions: { visibility: "agent" },  },}

QMD kullanılırken sources: ["sessions"] tek başına transkriptleri QMD'ye dışa aktarmaz. memory.qmd.sessions.enabled: true ayarını da yapın. Üst düzey rememberAcrossConversations: true ayarı istisnadır: ilgili ajan için gerekli QMD oturum dışa aktarımını dolaylı olarak etkinleştirir. Dolaylı dışa aktarımlar özel kalır: her zaman varsayılan dahili dışa aktarma konumunu kullanırlar (yapılandırılmış sessions.exportDir yalnızca açık dışa aktarımlar için geçerlidir), yalnızca ilgili ajanın konuşmalar arası hatırlaması sırasında aranırlar ve sıradan memory_get bunları okuyamaz. Açık memory.qmd.sessions.enabled: true mevcut davranışını korur ve dışa aktarılan transkriptleri sıradan bellek bütüncesinin parçası hâline getirir.

SQLite vektör hızlandırması (sqlite-vec)

sqlite-vec kullanılamadığında OpenClaw otomatik olarak işlem içi kosinüs benzerliğine geri döner.

İndeks depolama

Yerleşik bellek indeksleri her ajanın OpenClaw SQLite veritabanında agents/<agentId>/agent/openclaw-agent.sqlite konumunda bulunur.

QMD arka uç yapılandırması

Etkinleştirmek için memory.backend = "qmd" ayarını yapın. Tüm QMD ayarları memory.qmd altında bulunur:

searchMode: "search" yalnızca sözcüksel/BM25'tir. OpenClaw, memory status --deep sırasında da dâhil olmak üzere bu mod için anlamsal vektör hazır olma yoklamaları veya QMD gömme bakımı çalıştırmaz; vsearch ve query QMD vektör hazırlığını ve gömmeleri gerektirmeye devam eder.

rerank: false yalnızca QMD query modunu değiştirir ve QMD 2.1 veya daha yenisini gerektirir. Doğrudan CLI modunda OpenClaw --no-rerank değerini; mcporter destekli MCP modunda ise QMD'nin birleşik sorgu aracına rerank: false değerini iletir. QMD'nin varsayılan sorgu yeniden sıralama davranışını kullanmak için ayarlamadan bırakın.

OpenClaw güncel QMD koleksiyon ve MCP sorgu biçimlerini tercih eder ancak gerektiğinde uyumlu koleksiyon kalıbı bayraklarını ve eski MCP araç adlarını deneyerek eski QMD sürümlerinin çalışmasını sağlar. QMD birden fazla koleksiyon filtresini desteklediğini bildirdiğinde aynı kaynağa ait koleksiyonlar tek bir QMD işlemiyle aranır; eski QMD derlemeleri koleksiyon başına uyumluluk yolunu korur. Aynı kaynak, kalıcı bellek koleksiyonlarının (varsayılan bellek dosyaları ve özel yollar) birlikte gruplandırılması anlamına gelir; oturum transkripti koleksiyonları ise kaynak çeşitlendirmesinin her iki girdiyi de koruması için ayrı bir grup olarak kalır.

{  memory: {    qmd: {      scope: {        default: "deny",        rules: [{ action: "allow", match: { chatType: "direct" } }],      },    },  },}

QMD, bellek ilk kez kullanıldığında tembel olarak başlatılır; yenileme ve gömme zamanlamalarını bağdaştırıcısı yönetir.

Tam QMD örneği

{  memory: {    backend: "qmd",    citations: "auto",    qmd: {      includeDefaultMemory: true,      update: { interval: "5m", debounceMs: 15000 },      limits: { maxResults: 4, timeoutMs: 4000 },      scope: {        default: "deny",        rules: [{ action: "allow", match: { chatType: "direct" } }],      },      paths: [{ name: "docs", path: "~/notes", pattern: "**/*.md" }],    },  },}

Dreaming

Dreaming, memory.search altında değil, plugins.entries.memory-core.config.dreaming altında yapılandırılır.

Dreaming, zamanlanmış tek bir tarama olarak çalışır ve dahili hafif/derin/REM aşamalarını uygulama ayrıntısı olarak kullanır.

Kavramsal davranış ve eğik çizgi komutları için Dreaming sayfasına bakın.

Kullanıcı ayarları

Örnek

{  plugins: {    entries: {      "memory-core": {        subagent: {          allowModelOverride: true,          allowedModels: ["anthropic/claude-sonnet-4-6"],        },        config: {          dreaming: {            enabled: true,            frequency: "0 3 * * *",            model: "anthropic/claude-sonnet-4-6",          },        },      },    },  },}

İlgili

• Yapılandırma başvurusu
• Belleğe genel bakış
• Bellek araması