Przejdź do głównej treści

Pamięć Honcho

Honcho dodaje do OpenClaw pamięć natywną dla AI. Utrwala rozmowy w dedykowanej usłudze i z czasem buduje modele użytkownika oraz agenta, zapewniając agentowi kontekst między sesjami, który wykracza poza pliki Markdown obszaru roboczego.

Co zapewnia

  • Pamięć między sesjami — rozmowy są utrwalane po każdej turze, dzięki czemu kontekst jest przenoszony między resetami sesji, kompaktowaniem i przełączaniem kanałów.
  • Modelowanie użytkownika — Honcho utrzymuje profil dla każdego użytkownika (preferencje, fakty, styl komunikacji) oraz dla agenta (osobowość, wyuczone zachowania).
  • Wyszukiwanie semantyczne — wyszukiwanie obserwacji z wcześniejszych rozmów, a nie tylko bieżącej sesji.
  • Świadomość wielu agentów — agenci nadrzędni automatycznie śledzą uruchomione podagenty, a agenci nadrzędni są dodawani jako obserwatorzy w sesjach potomnych.

Dostępne narzędzia

Honcho rejestruje narzędzia, których agent może używać podczas rozmowy: Pobieranie danych (szybkie, bez wywołania LLM):
NarzędzieCo robi
honcho_contextPełna reprezentacja użytkownika między sesjami
honcho_search_conclusionsWyszukiwanie semantyczne zapisanych wniosków
honcho_search_messagesWyszukiwanie wiadomości między sesjami (filtrowanie według nadawcy, daty)
honcho_sessionHistoria i podsumowanie bieżącej sesji
Pytania i odpowiedzi (zasilane przez LLM):
NarzędzieCo robi
honcho_askZadawanie pytań o użytkownika. depth='quick' dla faktów, 'thorough' dla syntezy

Pierwsze kroki

Zainstaluj plugin i uruchom konfigurację:
openclaw plugins install @honcho-ai/openclaw-honcho
openclaw honcho setup
openclaw gateway --force
Polecenie konfiguracji prosi o dane uwierzytelniające API, zapisuje konfigurację i opcjonalnie migruje istniejące pliki pamięci obszaru roboczego.
Honcho może działać całkowicie lokalnie (self-hosted) lub przez zarządzane API pod adresem api.honcho.dev. Opcja self-hosted nie wymaga żadnych zewnętrznych zależności.

Konfiguracja

Ustawienia znajdują się w plugins.entries["openclaw-honcho"].config:
{
  plugins: {
    entries: {
      "openclaw-honcho": {
        config: {
          apiKey: "your-api-key", // pomiń dla self-hosted
          workspaceId: "openclaw", // izolacja pamięci
          baseUrl: "https://api.honcho.dev",
        },
      },
    },
  },
}
W przypadku instancji self-hosted ustaw baseUrl na lokalny serwer (na przykład http://localhost:8000) i pomiń klucz API.

Migracja istniejącej pamięci

Jeśli masz istniejące pliki pamięci obszaru roboczego (USER.md, MEMORY.md, IDENTITY.md, memory/, canvas/), openclaw honcho setup wykryje je i zaproponuje migrację.
Migracja jest nieniszcząca — pliki są przesyłane do Honcho. Oryginały nigdy nie są usuwane ani przenoszone.

Jak to działa

Po każdej turze AI rozmowa jest utrwalana w Honcho. Obserwowane są zarówno wiadomości użytkownika, jak i agenta, co pozwala Honcho z czasem budować i udoskonalać swoje modele. Podczas rozmowy narzędzia Honcho odpytują usługę w fazie before_prompt_build, wstrzykując odpowiedni kontekst, zanim model zobaczy prompt. Zapewnia to dokładne granice tur i trafne przywoływanie informacji.

Honcho a wbudowana pamięć

Wbudowana / QMDHoncho
PrzechowywaniePliki Markdown obszaru roboczegoDedykowana usługa (lokalna lub hostowana)
Między sesjamiPrzez pliki pamięciAutomatyczne, wbudowane
Modelowanie użytkownikaRęczne (zapis do MEMORY.md)Automatyczne profile
WyszukiwanieWektorowe + słowa kluczowe (hybrydowe)Semantyczne po obserwacjach
Wiele agentówNieśledzoneŚwiadomość relacji nadrzędny/potomny
ZależnościBrak (wbudowane) lub binarka QMDInstalacja pluginu
Honcho i wbudowany system pamięci mogą działać razem. Gdy skonfigurowano QMD, dostępne stają się dodatkowe narzędzia do przeszukiwania lokalnych plików Markdown obok pamięci między sesjami Honcho.

Polecenia CLI

openclaw honcho setup                        # Skonfiguruj klucz API i zmigruj pliki
openclaw honcho status                       # Sprawdź stan połączenia
openclaw honcho ask <question>               # Zapytaj Honcho o użytkownika
openclaw honcho search <query> [-k N] [-d D] # Wyszukiwanie semantyczne w pamięci

Dalsza lektura