--- read_when: - Birlikte gelen memory-lancedb Plugin'ini yapılandırıyorsunuz - Otomatik geri çağırma veya otomatik yakalama özellikli LanceDB destekli uzun süreli bellek istiyorsunuz - Ollama gibi yerel OpenAI uyumlu embedding'ler kullanıyorsunuz sidebarTitle: Memory LanceDB summary: Paketle birlikte gelen LanceDB bellek Plugin'ini, yerel Ollama uyumlu gömmeler dahil olacak şekilde yapılandırın title: Bellek LanceDB x-i18n: generated_at: "2026-05-02T09:02:30Z" model: gpt-5.5 provider: openai source_hash: 671daa20e4f070f9beb0187ff76db9368297b3bc78873ebf3f09ac7ccffa00a2 source_path: plugins/memory-lancedb.md workflow: 16 --- `memory-lancedb`, uzun süreli belleği LanceDB içinde saklayan ve geri çağırma için gömmeler kullanan paketle gelen bir bellek Plugin'idir. Bir model turundan önce ilgili anıları otomatik olarak geri çağırabilir ve bir yanıttan sonra önemli olguları yakalayabilir. Bellek için yerel bir vektör veritabanı istediğinizde, OpenAI uyumlu bir gömme uç noktasına ihtiyaç duyduğunuzda veya bellek veritabanını varsayılan yerleşik bellek deposunun dışında tutmak istediğinizde bunu kullanın. `memory-lancedb` bir Active Memory Plugin'idir. `plugins.slots.memory = "memory-lancedb"` ile bellek yuvasını seçerek etkinleştirin. `memory-wiki` gibi eşlik eden Plugin'ler onun yanında çalışabilir, ancak etkin bellek yuvasının sahibi yalnızca bir Plugin olabilir. ## Hızlı başlangıç ```json5 { plugins: { slots: { memory: "memory-lancedb", }, entries: { "memory-lancedb": { enabled: true, config: { embedding: { provider: "openai", model: "text-embedding-3-small", }, autoRecall: true, autoCapture: false, }, }, }, }, } ``` Plugin yapılandırmasını değiştirdikten sonra Gateway'i yeniden başlatın: ```bash openclaw gateway restart ``` Ardından Plugin'in yüklendiğini doğrulayın: ```bash openclaw plugins list ``` ## Sağlayıcı destekli gömmeler `memory-lancedb`, `memory-core` ile aynı bellek gömme sağlayıcısı bağdaştırıcılarını kullanabilir. Sağlayıcının yapılandırılmış kimlik doğrulama profilini, ortam değişkenini veya `models.providers..apiKey` değerini kullanmak için `embedding.provider` değerini ayarlayın ve `embedding.apiKey` değerini atlayın. ```json5 { plugins: { slots: { memory: "memory-lancedb", }, entries: { "memory-lancedb": { enabled: true, config: { embedding: { provider: "openai", model: "text-embedding-3-small", }, autoRecall: true, }, }, }, }, } ``` Bu yol, gömme kimlik bilgilerini açığa çıkaran sağlayıcı kimlik doğrulama profilleriyle çalışır. Örneğin, Copilot profili/planı gömmeleri desteklediğinde GitHub Copilot kullanılabilir: ```json5 { plugins: { slots: { memory: "memory-lancedb", }, entries: { "memory-lancedb": { enabled: true, config: { embedding: { provider: "github-copilot", model: "text-embedding-3-small", }, }, }, }, }, } ``` OpenAI Codex / ChatGPT OAuth (`openai-codex`), bir OpenAI Platform gömme kimlik bilgisi değildir. OpenAI gömmeleri için bir OpenAI API anahtarı kimlik doğrulama profili, `OPENAI_API_KEY` veya `models.providers.openai.apiKey` kullanın. Yalnızca OAuth kullanan kullanıcılar, GitHub Copilot veya Ollama gibi gömme destekli başka bir sağlayıcı kullanabilir. ## Ollama gömmeleri Ollama gömmeleri için paketle gelen Ollama gömme sağlayıcısını tercih edin. Yerel Ollama `/api/embed` uç noktasını kullanır ve [Ollama](/tr/providers/ollama) içinde belgelenen Ollama sağlayıcısıyla aynı kimlik doğrulama/temel URL kurallarını izler. ```json5 { plugins: { slots: { memory: "memory-lancedb", }, entries: { "memory-lancedb": { enabled: true, config: { embedding: { provider: "ollama", baseUrl: "http://127.0.0.1:11434", model: "mxbai-embed-large", dimensions: 1024, }, recallMaxChars: 400, autoRecall: true, autoCapture: false, }, }, }, }, } ``` Standart olmayan gömme modelleri için `dimensions` değerini ayarlayın. OpenClaw, `text-embedding-3-small` ve `text-embedding-3-large` boyutlarını bilir; LanceDB'nin vektör sütununu oluşturabilmesi için özel modellerde bu değerin yapılandırmada bulunması gerekir. Küçük yerel gömme modellerinde, yerel sunucudan bağlam uzunluğu hataları görürseniz `recallMaxChars` değerini düşürün. ## OpenAI uyumlu sağlayıcılar Bazı OpenAI uyumlu gömme sağlayıcıları `encoding_format` parametresini reddederken, bazıları bunu yok sayar ve her zaman `number[]` vektörleri döndürür. Bu nedenle `memory-lancedb`, gömme isteklerinde `encoding_format` değerini atlar ve hem kayan noktalı dizi yanıtlarını hem de base64 ile kodlanmış float32 yanıtlarını kabul eder. Paketle gelen bir sağlayıcı bağdaştırıcısı olmayan ham bir OpenAI uyumlu gömme uç noktanız varsa `embedding.provider` değerini atlayın (veya `openai` olarak bırakın) ve `embedding.apiKey` ile `embedding.baseUrl` değerlerini ayarlayın. Bu, doğrudan OpenAI uyumlu istemci yolunu korur. Model boyutları yerleşik olmayan sağlayıcılar için `embedding.dimensions` değerini ayarlayın. Örneğin, ZhiPu `embedding-3`, `2048` boyut kullanır: ```json5 { plugins: { entries: { "memory-lancedb": { enabled: true, config: { embedding: { apiKey: "${ZHIPU_API_KEY}", baseUrl: "https://open.bigmodel.cn/api/paas/v4", model: "embedding-3", dimensions: 2048, }, }, }, }, }, } ``` ## Geri çağırma ve yakalama sınırları `memory-lancedb` için iki ayrı metin sınırı vardır: | Ayar | Varsayılan | Aralık | Uygulandığı yer | | ----------------- | ---------- | --------- | ------------------------------------------- | | `recallMaxChars` | `1000` | 100-10000 | geri çağırma için gömme API'sine gönderilen metin | | `captureMaxChars` | `500` | 100-10000 | yakalama için uygun asistan mesajı uzunluğu | `recallMaxChars`; otomatik geri çağırmayı, `memory_recall` aracını, `memory_forget` sorgu yolunu ve `openclaw ltm search` komutunu denetler. Otomatik geri çağırma, turdaki en son kullanıcı mesajını tercih eder ve yalnızca kullanıcı mesajı yoksa tam isteme geri döner. Bu, kanal meta verilerini ve büyük istem bloklarını gömme isteğinin dışında tutar. `captureMaxChars`, bir yanıtın otomatik yakalama için değerlendirilecek kadar kısa olup olmadığını denetler. Geri çağırma sorgusu gömmelerini sınırlamaz. ## Komutlar `memory-lancedb` etkin bellek Plugin'i olduğunda `ltm` CLI ad alanını kaydeder: ```bash openclaw ltm list openclaw ltm search "project preferences" openclaw ltm stats ``` Plugin ayrıca `openclaw memory` komutunu, doğrudan LanceDB tablosunda çalışan vektör olmayan bir `query` alt komutuyla genişletir: ```bash openclaw memory query --cols id,text,createdAt --limit 20 openclaw memory query --filter "category = 'preference'" --order-by createdAt:desc ``` - `--cols `: virgülle ayrılmış sütun izin listesi (varsayılanlar: `id`, `text`, `importance`, `category`, `createdAt`). - `--filter `: SQL tarzı WHERE koşulu; 200 karakterle sınırlıdır ve alfasayısal karakterler, karşılaştırma işleçleri, tırnak işaretleri, parantezler ve küçük bir güvenli noktalama kümesiyle kısıtlanır. - `--limit `: pozitif tamsayı; varsayılan `10`. - `--order-by :`: filtreden sonra uygulanan bellek içi sıralama; sıralama sütunu projeksiyona otomatik olarak eklenir. Agent'lar ayrıca etkin bellek Plugin'inden LanceDB bellek araçlarını alır: - LanceDB destekli geri çağırma için `memory_recall` - önemli olguları, tercihleri, kararları ve varlıkları kaydetmek için `memory_store` - eşleşen anıları kaldırmak için `memory_forget` ## Depolama Varsayılan olarak LanceDB verileri `~/.openclaw/memory/lancedb` altında bulunur. Yolu `dbPath` ile geçersiz kılın: ```json5 { plugins: { entries: { "memory-lancedb": { enabled: true, config: { dbPath: "~/.openclaw/memory/lancedb", embedding: { apiKey: "${OPENAI_API_KEY}", model: "text-embedding-3-small", }, }, }, }, }, } ``` `storageOptions`, LanceDB depolama arka uçları için dize anahtar/değer çiftlerini kabul eder ve `${ENV_VAR}` genişletmesini destekler: ```json5 { plugins: { entries: { "memory-lancedb": { enabled: true, config: { dbPath: "s3://memory-bucket/openclaw", storageOptions: { access_key: "${AWS_ACCESS_KEY_ID}", secret_key: "${AWS_SECRET_ACCESS_KEY}", endpoint: "${AWS_ENDPOINT_URL}", }, embedding: { apiKey: "${OPENAI_API_KEY}", model: "text-embedding-3-small", }, }, }, }, }, } ``` ## Çalışma zamanı bağımlılıkları `memory-lancedb`, yerel `@lancedb/lancedb` paketine bağlıdır. Paketlenmiş OpenClaw bu paketi Plugin paketinin parçası olarak ele alır. Gateway başlangıcı Plugin bağımlılıklarını onarmaz; bağımlılık eksikse Plugin paketini yeniden yükleyin veya güncelleyin ve Gateway'i yeniden başlatın. Eski bir kurulum, Plugin yüklemesi sırasında eksik `dist/package.json` veya eksik `@lancedb/lancedb` hatası günlüğe yazarsa OpenClaw'ı yükseltin ve Gateway'i yeniden başlatın. Plugin, LanceDB'nin `darwin-x64` üzerinde kullanılamadığını günlüğe yazarsa bu makinede varsayılan bellek arka ucunu kullanın, Gateway'i desteklenen bir platforma taşıyın veya `memory-lancedb` değerini devre dışı bırakın. ## Sorun giderme ### Girdi uzunluğu bağlam uzunluğunu aşıyor Bu genellikle gömme modelinin geri çağırma sorgusunu reddettiği anlamına gelir: ```text memory-lancedb: recall failed: Error: 400 the input length exceeds the context length ``` Daha düşük bir `recallMaxChars` değeri ayarlayın, ardından Gateway'i yeniden başlatın: ```json5 { plugins: { entries: { "memory-lancedb": { config: { recallMaxChars: 400, }, }, }, }, } ``` Ollama için gömme sunucusuna Gateway ana makinesinden erişilebildiğini de doğrulayın: ```bash curl http://127.0.0.1:11434/v1/embeddings \ -H "Content-Type: application/json" \ -d '{"model":"mxbai-embed-large","input":"hello"}' ``` ### Desteklenmeyen gömme modeli `dimensions` olmadan yalnızca yerleşik OpenAI gömme boyutları bilinir. Yerel veya özel gömme modelleri için `embedding.dimensions` değerini o model tarafından bildirilen vektör boyutuna ayarlayın. ### Plugin yükleniyor ancak anı görünmüyor `plugins.slots.memory` değerinin `memory-lancedb` değerini gösterdiğini denetleyin, ardından şunu çalıştırın: ```bash openclaw ltm stats openclaw ltm search "recent preference" ``` `autoCapture` devre dışıysa Plugin mevcut anıları geri çağırır, ancak yenilerini otomatik olarak depolamaz. Otomatik yakalama istiyorsanız `memory_store` aracını kullanın veya `autoCapture` değerini etkinleştirin. ## İlgili - [Belleğe genel bakış](/tr/concepts/memory) - [Active Memory](/tr/concepts/active-memory) - [Bellek araması](/tr/concepts/memory-search) - [Memory Wiki](/tr/plugins/memory-wiki) - [Ollama](/tr/providers/ollama)