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ı hâle getirir ve zaman içinde kullanıcı ile ajan modelleri oluşturarak ajanınıza çalışma alanındaki Markdown dosyalarının ötesine geçen oturumlar arası bağlam sağlar.
Sağladıkları
- Oturumlar arası bellek - konuşmalar her etkileşimden sonra kalıcı hâle gelir; böylece bağlam, oturum sıfırlamaları, Compaction ve kanal geçişleri boyunca korunur.
- Kullanıcı modelleme - Honcho, her kullanıcı (tercihler, olgular, iletişim tarzı) ve ajan (kişilik, öğrenilmiş davranışlar) için bir profil tutar.
- Anlamsal arama - yalnızca geçerli oturumda değil, geçmiş konuşmalardan elde edilen gözlemlerde de arama yapar.
- Çok ajanlı farkındalık - üst ajanlar, oluşturulan alt ajanları otomatik olarak izler ve 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ç | İşlevi |
|---|---|
honcho_context |
Oturumlar genelindeki eksiksiz kullanıcı temsili |
honcho_search_conclusions |
Saklanan sonuçlar üzerinde anlamsal arama |
honcho_search_messages |
Oturumlar genelinde mesajları bulur (gönderene ve tarihe göre filtreleme) |
honcho_session |
Geçerli oturumun geçmişi ve özeti |
Soru-cevap (LLM destekli):
| Araç | İşlevi |
|---|---|
honcho_ask |
Kullanıcı hakkında soru sorar. Olgular için depth='quick', sentez için 'thorough' |
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", // kendi sunucunuzda çalıştırıyorsanız atlayın workspaceId: "openclaw", // bellek yalıtımı baseUrl: "https://api.honcho.dev", }, }, }, },}Kendi sunucunuzdaki örneklerde baseUrl değerini yerel sunucunuza (örneğin http://localhost:8000) yönlendirin ve API anahtarını atlayın.
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.
Çalışma şekli
Her yapay zekâ etkileşiminden sonra konuşma Honcho'da kalıcı hâle getirilir. Hem kullanıcı hem de ajan mesajları gözlemlenir; böylece Honcho zaman içinde modellerini oluşturabilir ve iyileştirebilir.
Honcho araçları, konuşma sırasında OpenClaw'ın before_prompt_build plugin kancasında hizmeti sorgulayarak model istemi görmeden önce ilgili bağlamı ekler.
Honcho ve 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 | Manuel (MEMORY.md dosyasına yazma) | Otomatik profiller |
| Arama | Vektör + anahtar kelime (karma) | Gözlemler üzerinde anlamsal |
| Çok ajanlı | İzlenmez | Üst/alt ajan 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 # API anahtarını yapılandırın ve dosyaları taşıyınopenclaw honcho status # Bağlantı durumunu kontrol edinopenclaw honcho ask <question> # Honcho'ya kullanıcı hakkında sorgu gönderinopenclaw honcho search <query> [-k N] [-d D] # Bellekte anlamsal arama yapın