Sessions and memory
Honcho belleği
Honcho, OpenClaw'a AI-native bellek ekler. Konuşmaları özel bir hizmette kalıcılaştırır ve zaman içinde kullanıcı ile aracı modelleri oluşturur; böylece aracı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ılaştırılır, böylece bağlam oturum sıfırlamaları, Compaction ve kanal geçişleri boyunca korunur.
- Kullanıcı modelleme -- Honcho her kullanıcı için (tercihler, gerçekler, iletişim tarzı) ve aracı için (kişilik, öğrenilmiş davranışlar) bir profil tutar.
- Semantik arama -- yalnızca geçerli oturumda değil, geçmiş konuşmalardaki gözlemler üzerinde arama yapar.
- Çoklu aracı farkındalığı -- üst aracılar, oluşturulan alt aracıları otomatik olarak izler; üst aracılar 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ç | Ne yapar |
|---|---|
honcho_context |
Oturumlar arasında tam kullanıcı temsili |
honcho_search_conclusions |
Saklanan sonuçlar üzerinde semantik arama |
honcho_search_messages |
Oturumlar arasında mesaj bulur (gönderen, tarih ile filtreler) |
honcho_session |
Geçerli oturum geçmişi ve özeti |
Soru-cevap (LLM destekli):
| Araç | Ne yapar |
|---|---|
honcho_ask |
Kullanıcı hakkında soru sorar. Gerçekler için depth='quick', sentez için 'thorough' |
Başlarken
Plugin'i kurun ve kurulumu çalıştırın:
openclaw plugins install @honcho-ai/openclaw-honcho
openclaw honcho setup
openclaw gateway --force
Kurulum komutu API kimlik bilgilerinizi ister, config'i 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", // self-hosted için atlayın
workspaceId: "openclaw", // bellek yalıtımı
baseUrl: "https://api.honcho.dev",
},
},
},
},
}
Self-hosted örnekler için baseUrl değerini yerel sunucunuza yöneltin (ö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.
Nasıl çalışır
Her AI turundan sonra konuşma Honcho'ya kalıcılaştırılır. Hem kullanıcı hem de aracı mesajları gözlemlenir; bu da Honcho'nun zaman içinde modellerini oluşturup iyileştirmesine olanak tanır.
Konuşma sırasında Honcho araçları hizmeti before_prompt_build
aşamasında sorgular ve model prompt'u görmeden önce ilgili bağlamı enjekte eder.
Bu, doğru tur sınırlarını ve ilgili geri çağırmayı sağlar.
Honcho ve yerleşik bellek
| 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 içine yazarak) |
Otomatik profiller |
| Arama | Vektör + anahtar kelime (hibrit) | Gözlemler üzerinde semantik |
| Çoklu aracı | İzlenmez | Üst/alt farkındalığı |
| Bağımlılıklar | Yok (yerleşik) veya QMD ikili dosyası | Plugin kurulumu |
Honcho ile yerleşik bellek sistemi birlikte çalışabilir. QMD yapılandırıldığında, Honcho'nun oturumlar arası belleği yanında yerel Markdown dosyalarında arama yapmak için ek araçlar kullanılabilir olur.
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> # Kullanıcı hakkında Honcho'ya sorgu yap
openclaw honcho search <query> [-k N] [-d D] # Bellek üzerinde semantik arama
Daha fazla okuma
- Plugin source code
- Honcho documentation
- Honcho OpenClaw integration guide
- Memory -- OpenClaw bellek genel bakışı
- Context Engines -- Plugin bağlam motorlarının nasıl çalıştığı