Honcho Memory
Honcho, OpenClaw’a AI-native bellek ekler. Konuşmaları özel bir hizmete kalıcı olarak kaydeder ve zaman içinde kullanıcı ile ajan modelleri oluşturur; böylece ajanınıza, çalışma alanı Markdown dosyalarının ötesine geçen oturumlar arası bağlam sağlar.
Sağladıkları
- Oturumlar arası bellek — konuşmalar her turdan sonra kalıcı olarak kaydedilir; böylece bağlam, oturum sıfırlamaları, sıkıştırma ve kanal değişiklikleri arasında korunur.
- Kullanıcı modelleme — Honcho, her kullanıcı için (tercihler, gerçekler, iletişim tarzı) ve ajan için (kişilik, öğrenilmiş davranışlar) bir profil tutar.
- Anlamsal arama — yalnızca mevcut oturum üzerinde değil, geçmiş konuşmalardan elde edilen gözlemler üzerinde arama yapar.
- Çoklu ajan farkındalığı — üst ajanlar, oluşturdukları alt ajanları otomatik olarak izler; üst ajanlar alt oturumlara gözlemci olarak eklenir.
Kullanılabilir araçlar
Honcho, ajanın konuşma sırasında kullanabileceği araçlar kaydeder:
Veri alma (hızlı, LLM çağrısı yok):
| Araç | Ne yapar |
|---|
honcho_context | Oturumlar arasında tam kullanıcı temsili |
honcho_search_conclusions | Kaydedilmiş sonuçlar üzerinde anlamsal arama yapar |
honcho_search_messages | Oturumlar arasında mesaj bulur (gönderene, tarihe göre filtreler) |
honcho_session | Mevcut oturum geçmişi ve özeti |
| Araç | Ne yapar |
|---|
honcho_ask | Kullanıcı hakkında soru sorar. Gerçekler için depth='quick', sentez için 'thorough' |
Başlarken
Eklentiyi yükleyin ve kurulumu çalıştırın:
openclaw plugins install @honcho-ai/openclaw-honcho
openclaw honcho setup
openclaw gateway --force
Honcho tamamen yerel olarak (self-hosted) veya api.honcho.dev adresindeki yönetilen API üzerinden çalışabilir. Self-hosted seçeneği için harici bağımlılık gerekmez.
Yapılandırma
Ayarlar plugins.entries["openclaw-honcho"].config altında bulunur:
{
plugins: {
entries: {
"openclaw-honcho": {
config: {
apiKey: "your-api-key", // self-hosted için atlayın
workspaceId: "openclaw", // bellek yalıtımı
baseUrl: "https://api.honcho.dev",
},
},
},
},
}
baseUrl değerini yerel sunucunuza yönlendirin (örneğin http://localhost:8000) ve API anahtarını atlayın.
Mevcut belleği taşıma
Mevcut çalışma alanı bellek dosyalarınız varsa (USER.md, MEMORY.md,
IDENTITY.md, memory/, canvas/), openclaw honcho setup bunları algılar ve
taşımayı önerir.
Taşıma yıkıcı değildir — dosyalar Honcho’ya yüklenir. Orijinaller asla silinmez veya taşınmaz.
Nasıl çalışır
Her AI turundan sonra konuşma Honcho’ya kalıcı olarak kaydedilir. Hem kullanıcı hem de ajan 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ı, hizmeti before_prompt_build
aşamasında sorgular ve model istemi görmeden önce ilgili bağlamı ekler. Bu, doğru tur sınırları ve ilgili hatırlama sağlar.
Honcho ile yerleşik bellek 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 | El ile (MEMORY.md içine yazılır) | Otomatik profiller |
| Arama | Vektör + anahtar kelime (hibrit) | Gözlemler üzerinde anlamsal |
| Çoklu ajan | İzlenmez | Üst/alt farkındalığı |
| Bağımlılıklar | Yok (yerleşik) veya QMD ikilisi | Eklenti kurulumu |
CLI komutları
openclaw honcho setup # API anahtarını yapılandır ve dosyaları taşı
openclaw honcho status # Bağlantı durumunu kontrol et
openclaw honcho ask <question> # Honcho'ya kullanıcı hakkında soru sor
openclaw honcho search <query> [-k N] [-d D] # Bellek üzerinde anlamsal arama
Daha fazla bilgi
