Honcho добавляет AI-нативную память в OpenClaw. Он сохраняет
диалоги в выделенном сервисе и со временем строит модели пользователя и агента,
давая вашему агенту межсессионный контекст, который выходит за пределы Markdown-файлов
рабочей области.
Что он предоставляет
- Межсессионная память — диалоги сохраняются после каждого хода, поэтому
контекст переносится между сбросами сеанса, Compaction и переключениями каналов.
- Моделирование пользователя — Honcho поддерживает профиль для каждого пользователя (предпочтения,
факты, стиль общения) и для агента (личность, усвоенные
модели поведения).
- Семантический поиск — поиск по наблюдениям из прошлых диалогов, а не
только по текущему сеансу.
- Осведомленность о нескольких агентах — родительские агенты автоматически отслеживают порожденных
субагентов, при этом родители добавляются как наблюдатели в дочерние сеансы.
Доступные инструменты
Honcho регистрирует инструменты, которые агент может использовать во время диалога:
Получение данных (быстро, без вызова LLM):
| Инструмент | Что он делает |
|---|
honcho_context | Полное представление пользователя между сеансами |
honcho_search_conclusions | Семантический поиск по сохраненным выводам |
honcho_search_messages | Поиск сообщений между сеансами (фильтр по отправителю, дате) |
honcho_session | История и сводка текущего сеанса |
| Инструмент | Что он делает |
|---|
honcho_ask | Задать вопрос о пользователе. depth='quick' для фактов, 'thorough' для синтеза |
Начало работы
Установите Plugin и запустите настройку:
openclaw plugins install @honcho-ai/openclaw-honcho
openclaw honcho setup
openclaw gateway --force
Honcho может работать полностью локально (на собственном хостинге) или через управляемый API на
api.honcho.dev. Для варианта на собственном хостинге внешние зависимости не требуются.
Конфигурация
Настройки находятся в 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",
},
},
},
},
}
baseUrl ваш локальный сервер (например
http://localhost:8000) и опустите ключ API.
Перенос существующей памяти
Если у вас есть существующие файлы памяти рабочей области (USER.md, MEMORY.md,
IDENTITY.md, memory/, canvas/), openclaw honcho setup обнаружит их и
предложит перенести.
Миграция неразрушительна — файлы загружаются в Honcho. Оригиналы
никогда не удаляются и не перемещаются.
Как это работает
После каждого хода AI диалог сохраняется в Honcho. Сообщения как пользователя, так и
агента наблюдаются, что позволяет Honcho со временем строить и уточнять свои модели.
Во время диалога инструменты Honcho запрашивают сервис на этапе before_prompt_build,
вставляя релевантный контекст до того, как модель увидит промпт. Это обеспечивает
точные границы ходов и релевантное припоминание.
Honcho и встроенная память
| Встроенная / QMD | Honcho |
|---|
| Хранилище | Markdown-файлы рабочей области | Выделенный сервис (локальный или размещенный) |
| Межсессионность | Через файлы памяти | Автоматическая, встроенная |
| Моделирование пользователя | Вручную (запись в MEMORY.md) | Автоматические профили |
| Поиск | Векторный + ключевой (гибридный) | Семантический по наблюдениям |
| Несколько агентов | Не отслеживается | Осведомленность о родителе/дочернем агенте |
| Зависимости | Нет (встроено) или бинарный файл QMD | Установка Plugin |
Команды 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
Дополнительное чтение
См. также
