Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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_contextOturumlar arasında tam kullanıcı temsili
honcho_search_conclusionsSaklanan sonuçlar üzerinde semantik arama
honcho_search_messagesOturumlar arasında mesaj bulur (gönderen, tarih ile filtreler)
honcho_sessionGeçerli oturum geçmişi ve özeti
Soru-cevap (LLM destekli):
AraçNe yapar
honcho_askKullanı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.
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",
        },
      },
    },
  },
}
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.
Taşıma yıkıcı değildir — dosyalar Honcho’ya yüklenir. Asılları asla silinmez veya taşınmaz.

​
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 / QMDHoncho
DepolamaÇalışma alanı Markdown dosyalarıÖzel hizmet (yerel veya barındırılan)
Oturumlar arasıBellek dosyaları aracılığıylaOtomatik, yerleşik
Kullanıcı modellemeManuel (MEMORY.md içine yazarak)Otomatik profiller
AramaVektör + anahtar kelime (hibrit)Gözlemler üzerinde semantik
Çoklu aracıİzlenmezÜst/alt farkındalığı
BağımlılıklarYok (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

​
İlgili