Sessions and memory
Honcho belleği
Honcho, harici bir Plugin aracılığıyla OpenClaw'a yapay zekâya özgü bellek ekler. Konuşmaları özel bir hizmette kalıcı olarak saklar ve zaman içinde kullanıcı ile aracı modelleri oluşturarak aracınıza çalışma alanındaki Markdown dosyalarının ötesine geçen oturumlar arası bağlam sağlar.
Neler sunar
- Oturumlar arası bellek - konuşmalar her etkileşimden sonra kalıcı olarak saklanır; böylece bağlam, oturum sıfırlamaları, Compaction ve kanal geçişleri boyunca korunur.
- Kullanıcı modelleme - Honcho her kullanıcı (tercihler, bilgiler, iletişim tarzı) ve aracı (kişilik, öğrenilmiş davranışlar) için bir profil tutar.
- Anlamsal arama - yalnızca geçerli oturumda değil, geçmiş konuşmalardaki gözlemler üzerinde arama yapar.
- Çok aracılı farkındalık - üst aracılar, oluşturulan alt aracıları otomatik olarak takip eder ve alt oturumlara gözlemci olarak eklenir.
Kullanılabilir araçlar
Honcho, aracının konuşma sırasında kullanabileceği araçları kaydeder:
Veri alma (hızlı, LLM çağrısı yok):
| Araç | İşlevi |
|---|---|
honcho_context |
Oturumlar genelindeki eksiksiz kullanıcı temsili |
honcho_search_conclusions |
Saklanan sonuçlar üzerinde anlamsal arama |
honcho_search_messages |
Oturumlar genelinde mesajları bulma (gönderen ve tarihe göre filtreleme) |
honcho_session |
Geçerli oturum geçmişi ve özeti |
Soru-cevap (LLM destekli):
| Araç | İşlevi |
|---|---|
honcho_ask |
Kullanıcı hakkında soru sorun. Bilgiler için depth='quick', sentez için 'thorough' kullanın |
Başlarken
Plugin'i yükleyin ve kurulumu çalıştırın:
openclaw plugins install @honcho-ai/openclaw-honchoopenclaw honcho setupopenclaw gateway --forceKurulum komutu API kimlik bilgilerinizi ister, yapılandırmayı yazar ve isteğe bağlı olarak mevcut çalışma alanı bellek dosyalarını taşır.
Yapılandırma
Ayarlar plugins.entries["openclaw-honcho"].config altında bulunur:
{ plugins: { entries: { "openclaw-honcho": { config: { apiKey: "your-api-key", // omit for self-hosted workspaceId: "openclaw", // memory isolation baseUrl: "https://api.honcho.dev", }, }, }, },}Kendi sunucunuzda çalışan örnekler için baseUrl değerini yerel sunucunuza (örneğin http://localhost:8000) yönlendirin ve API anahtarını belirtmeyin.
Mevcut belleği taşıma
Mevcut çalışma alanı bellek dosyalarınız (USER.md, MEMORY.md, IDENTITY.md, memory/, canvas/) varsa openclaw honcho setup bunları algılar ve taşıma seçeneği sunar.
Nasıl çalışır
Her yapay zekâ etkileşiminden sonra konuşma Honcho'da kalıcı olarak saklanır. Hem kullanıcı hem de aracı mesajları gözlemlenir; bu da Honcho'nun zaman içinde modellerini oluşturmasına ve iyileştirmesine olanak tanır.
Konuşma sırasında Honcho araçları, OpenClaw'ın before_prompt_build Plugin kancası üzerinden hizmeti sorgular ve model istemi görmeden önce ilgili bağlamı ekler.
Honcho ile yerleşik belleğin karşılaştırması
| Yerleşik / QMD | Honcho | |
|---|---|---|
| Depolama | Çalışma alanı Markdown dosyaları | Özel hizmet (yerel veya barındırılan) |
| Oturumlar arası | Bellek dosyaları aracılığıyla | Otomatik, yerleşik |
| Kullanıcı modelleme | Manuel (MEMORY.md dosyasına yazılır) |
Otomatik profiller |
| Arama | Vektör + anahtar sözcük (karma) | Gözlemler üzerinde anlamsal arama |
| Çok aracılı | İzlenmez | Üst/alt aracı farkındalığı |
| Bağımlılıklar | Yok (yerleşik) veya QMD ikili dosyası | Plugin kurulumu |
Honcho ve yerleşik bellek sistemi birlikte çalışabilir. QMD yapılandırıldığında, Honcho'nun oturumlar arası belleğinin yanı sıra yerel Markdown dosyalarında arama yapmak için ek araçlar kullanılabilir hâle gelir.
CLI komutları
openclaw honcho setup # Configure API key and migrate filesopenclaw honcho status # Check connection statusopenclaw honcho ask <question> # Query Honcho about the useropenclaw honcho search <query> [-k N] [-d D] # Semantic search over memory