Bellek yapılandırması başvurusu

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

Aksi belirtilmedikçe tüm bellek araması ayarları openclaw.json dosyasında agents.defaults.memorySearch altında (veya aracı başına agents.list[].memorySearch geçersiz kılması olarak) bulunur.

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" kullanan eski yapılandırmalar openai olarak çözümlenir.

provider ayarlanmadığında, eski provider: "auto" bulunduğunda veya provider: "none" bilerek yalnızca FTS modunu seçtiğinde, gömmeler kullanılamasa bile bellekten geri çağırma sözcüksel FTS sıralamasını kullanabilir.

Açıkça belirtilen yerel olmayan sağlayıcılar hata durumunda kapalı kalır. memorySearch.provider değerini Bedrock, DeepInfra, Gemini, GitHub Copilot, LM Studio, Mistral, Ollama, OpenAI, Voyage veya OpenAI uyumlu özel bir sağlayıcı gibi somut ve uzak destekli bir sağlayıcıya ayarlarsanız ve bu sağlayıcı çalışma zamanında kullanılamıyorsa memory_search, sessizce yalnızca FTS tabanlı geri çağırmayı 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 tabanlı geri çağırma istiyorsanız provider: "none" ayarını kullanın.

Özel sağlayıcı kimlikleri

memorySearch.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ı için ilgili sağlayıcının api sahibini çözümler. Bu, birden fazla GPU veya ana bilgisayar kullanılan kurulumları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" }],      },    },  },  agents: {    defaults: {      memorySearch: {        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 amaçlı, OpenAI uyumlu bir /v1/embeddings sunucusu için provider: "openai-compatible" kullanın.

{  agents: {    defaults: {      memorySearch: {        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

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

{  agents: {    defaults: {      memorySearch: {        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

Satır içi gömme zaman aşımı

İndeksleme davranışı

Belirtilmediği sürece tümü memorySearch.sync altındadır:

Hibrit arama yapılandırması

Tümü memorySearch.query altında:

Ayrıca memorySearch.query.hybrid altında:

Tam örnek

{  agents: {    defaults: {      memorySearch: {        query: {          maxResults: 6,          minScore: 0.35,          hybrid: {            vectorWeight: 0.7,            textWeight: 0.3,            mmr: { enabled: true, lambda: 0.7 },            temporalDecay: { enabled: true, halfLifeDays: 30 },          },        },      },    },  },}

Ek bellek yolları

{  agents: {    defaults: {      memorySearch: {        extraPaths: ["../team-docs", "/srv/shared-notes"],      },    },  },}

Yollar mutlak veya çalışma alanına göreli 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.

Ajan kapsamlı ajanlar arası transkript araması için memory.qmd.paths yerine agents.list[].memorySearch.qmd.extraCollections kullanın. Bu ek koleksiyonlar aynı { path, name, pattern? } yapısını izler, ancak ajan başına birleştirilir ve yol geçerli çalışma alanının dışını gösterdiğinde açıkça belirtilen paylaşılan adları koruyabilir. Aynı çözümlenmiş yol hem memory.qmd.paths hem de memorySearch.qmd.extraCollections içinde görünürse QMD ilk girdiyi tutar ve yinelenen girdiyi atlar.

Çok modlu bellek (Gemini)

Gemini Embedding 2 kullanarak görüntüleri ve sesleri Markdown ile birlikte dizinleyin:

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. Sınırsız bir önbellek için maxEntries değerini ayarlamadan bırakın; disk alanındaki büyüme, en yüksek yeniden indeksleme hızından daha önemliyse bu değeri ayarlayın. Ayarlandığında, önbellek sınırı aştığı anda en eski girdiler (son güncelleme zamanına göre) önce temizlenir.

Toplu indeksleme

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

remote.nonBatchConcurrency, sağlayıcının toplu işlem API'leri etkin olmadığında yerel/kendi barındırdığınız sağlayıcılar ve barındırılan sağlayıcılar tarafından kullanılan satır içi gömme çağrılarını denetler. Ollama, daha küçük yerel ana makineleri aşırı yüklememek için toplu olmayan indekslemede varsayılan olarak 1 değerini kullanır; daha büyük makinelerde daha yüksek bir değer ayarlayın.

Bu ayar, satır içi gömme çağrılarının zaman aşımını denetleyen sync.embeddingBatchTimeoutSeconds ayarından ayrıdır.

Oturum belleğinde arama (deneysel)

Oturum transkriptlerini indeksleyin ve memory_search aracılığıyla erişilebilir hâle getirin:

Oturum transkripti eşleşmeleri de tools.sessions.visibility ayarına uyar. Varsayılan tree görünürlüğü yalnızca mevcut oturumu ve onun başlattığı oturumları erişilebilir kılar. DM gibi farklı bir oturumdan, aynı aracıya ait ve Gateway tarafından yönlendirilmiş ilgisiz bir oturumu hatırlamak için görünürlüğü bilinçli olarak agent düzeyine genişletin (veya yalnızca aracılar arası hatırlama da gerekliyse ve aracılar arası politika buna izin veriyorsa all kullanın).

Aşağıdaki örnekler bu ayarları agents.defaults altına yerleştirir. Yalnızca tek bir aracının oturum transkriptlerini indeksleyip araması gerekiyorsa eşdeğer memorySearch ayarlarını aracı başına geçersiz kılma yapılandırmasında da uygulayabilirsiniz.

Aynı aracıda Gateway'den DM'e hatırlama için:

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

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

QMD kullanırken agents.defaults.memorySearch.experimental.sessionMemory ve sources: ["sessions"] tek başlarına transkriptleri QMD'ye aktarmaz. Ayrıca memory.qmd.sessions.enabled: true ayarını da yapın.

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

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

Dizin depolama

Yerleşik bellek dizinleri, 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" değerini ayarlayın. Tüm QMD ayarları memory.qmd altında bulunur:

searchMode: "search" yalnızca sözcüksel/BM25 araması yapar. OpenClaw, memory status --deep sırasında da dâhil olmak üzere bu mod için anlamsal vektör hazır olma yoklamalarını veya QMD gömme bakımını ç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 yeni bir sürüm gerektirir. Doğrudan CLI modunda OpenClaw --no-rerank seçeneğini iletir; 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 bu ayarı belirtmeyin.

OpenClaw güncel QMD koleksiyonu 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ı sürdürür. QMD birden fazla koleksiyon filtresini desteklediğini bildirdiğinde aynı kaynaktaki koleksiyonlar tek bir QMD süreciyle aranır; eski QMD derlemeleri koleksiyon başına uyumluluk yolunu kullanmaya devam eder. Aynı kaynak, kalıcı bellek koleksiyonlarının (varsayılan bellek dosyaları ve özel yollar) birlikte gruplandırılması anlamına gelir; oturum dökümü koleksiyonları ise kaynak çeşitlendirmesinde her iki girdinin de korunması için ayrı bir grup olarak kalır.

mcporter entegrasyonu

Tümü memory.qmd.mcporter altında bulunur. QMD aramalarını her sorguda qmd başlatmak yerine uzun ömürlü bir mcporter MCP daemon'u üzerinden yönlendirerek daha büyük modellerin soğuk başlatma ek yükünü azaltır.

mcporter uygulamasının kurulmuş ve PATH üzerinde olmasının yanı sıra qmd mcp çalıştıran yapılandırılmış bir mcporter sunucusu gerektirir. Sorgu başına süreç başlatma maliyetinin kabul edilebilir olduğu daha basit yerel kurulumlarda devre dışı bırakın.

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

Gateway başlangıcında QMD başlatma etkinleştirildiğinde OpenClaw, QMD'yi yalnızca uygun aracılar için başlatır. update.onBoot doğruysa ve herhangi bir aralık/gömme bakımı yapılandırılmamışsa başlangıç, açılış yenilemesi için tek seferlik bir yönetici kullanır ve ardından yöneticiyi kapatır. Bir güncelleme veya gömme aralığı yapılandırılmışsa başlangıç, izleyicinin ve aralık zamanlayıcılarının yönetimini üstlenebilmesi için uzun ömürlü QMD yöneticisini açar; update.onBoot: false yalnızca anlık açılış yenilemesini atlar.

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, agents.defaults.memorySearch 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ı bir 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ı