Перейти до основного вмісту

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 нативну для ШІ пам’ять. Він зберігає розмови в окремому сервісі та з часом будує моделі користувача й агента, надаючи вашому агенту міжсесійний контекст, що виходить за межі Markdown-файлів робочого простору.

Що це надає

  • Міжсесійна пам’ять — розмови зберігаються після кожного ходу, тому контекст переноситься між скиданнями сесії, Compaction і перемиканням каналів.
  • Моделювання користувача — Honcho підтримує профіль для кожного користувача (уподобання, факти, стиль спілкування) і для агента (особистість, засвоєна поведінка).
  • Семантичний пошук — пошук за спостереженнями з минулих розмов, а не лише за поточною сесією.
  • Обізнаність про кількох агентів — батьківські агенти автоматично відстежують створених підлеглих агентів, а батьків додають як спостерігачів у дочірніх сесіях.

Доступні інструменти

Honcho реєструє інструменти, які агент може використовувати під час розмови: Отримання даних (швидко, без виклику LLM):
ІнструментЩо він робить
honcho_contextПовне представлення користувача між сесіями
honcho_search_conclusionsСемантичний пошук за збереженими висновками
honcho_search_messagesПошук повідомлень між сесіями (фільтр за відправником, датою)
honcho_sessionІсторія та підсумок поточної сесії
Запитання й відповіді (на основі LLM):
ІнструментЩо він робить
honcho_askПоставити запитання про користувача. depth='quick' для фактів, 'thorough' для узагальнення

Початок роботи

Установіть Plugin і виконайте налаштування:
openclaw plugins install @honcho-ai/openclaw-honcho
openclaw honcho setup
openclaw gateway --force
Команда налаштування запитує ваші API-облікові дані, записує конфігурацію та за бажанням переносить наявні файли пам’яті робочого простору.
Honcho може працювати повністю локально (self-hosted) або через керований API за адресою api.honcho.dev. Для варіанта self-hosted не потрібні жодні зовнішні залежності.

Конфігурація

Параметри містяться в plugins.entries["openclaw-honcho"].config:
{
  plugins: {
    entries: {
      "openclaw-honcho": {
        config: {
          apiKey: "your-api-key", // omit for self-hosted
          workspaceId: "openclaw", // memory isolation
          baseUrl: "https://api.honcho.dev",
        },
      },
    },
  },
}
Для self-hosted екземплярів вкажіть baseUrl на ваш локальний сервер (наприклад, http://localhost:8000) і не вказуйте API-ключ.

Перенесення наявної пам’яті

Якщо у вас уже є наявні файли пам’яті робочого простору (USER.md, MEMORY.md, IDENTITY.md, memory/, canvas/), openclaw honcho setup виявить їх і запропонує перенести.
Перенесення не є руйнівним — файли завантажуються до Honcho. Оригінали ніколи не видаляються й не переміщуються.

Як це працює

Після кожного ходу ШІ розмова зберігається в Honcho. Спостерігаються як повідомлення користувача, так і агента, що дозволяє Honcho будувати й уточнювати свої моделі з часом. Під час розмови інструменти Honcho звертаються до сервісу на фазі before_prompt_build, додаючи релевантний контекст до того, як модель побачить промпт. Це забезпечує точні межі ходів і релевантне відтворення.

Honcho проти вбудованої пам’яті

Вбудована / QMDHoncho
ЗберіганняMarkdown-файли робочого просторуОкремий сервіс (локальний або хостинговий)
МіжсесійністьЧерез файли пам’ятіАвтоматично, вбудовано
Моделювання користувачаВручну (запис у MEMORY.md)Автоматичні профілі
ПошукВекторний + за ключовими словами (гібридний)Семантичний за спостереженнями
Кілька агентівНе відстежуєтьсяОбізнаність про зв’язок батько/дочірній
ЗалежностіНемає (вбудовано) або двійковий QMDУстановлення Plugin
Honcho і вбудована система пам’яті можуть працювати разом. Коли налаштовано QMD, стають доступними додаткові інструменти для пошуку в локальних Markdown-файлах разом із міжсесійною пам’яттю Honcho.

Команди CLI

openclaw honcho setup                        # Configure API key and migrate files
openclaw honcho status                       # Check connection status
openclaw honcho ask <question>               # Query Honcho about the user
openclaw honcho search <query> [-k N] [-d D] # Semantic search over memory

Додаткові матеріали

Пов’язане