Sessions and memory
Memoria de Honcho
Honcho añade memoria nativa para IA a OpenClaw mediante un plugin externo. Conserva las conversaciones en un servicio dedicado y crea modelos del usuario y del agente con el tiempo, lo que proporciona al agente contexto entre sesiones que va más allá de los archivos Markdown del espacio de trabajo.
Qué proporciona
- Memoria entre sesiones - las conversaciones se conservan después de cada turno, por lo que el contexto se mantiene tras reinicios de sesión, Compaction y cambios de canal.
- Modelado del usuario - Honcho mantiene un perfil para cada usuario (preferencias, datos, estilo de comunicación) y para el agente (personalidad, comportamientos aprendidos).
- Búsqueda semántica - permite buscar entre observaciones de conversaciones anteriores, no solo en la sesión actual.
- Conocimiento de múltiples agentes - los agentes principales realizan automáticamente el seguimiento de los subagentes generados, y se añaden como observadores en las sesiones secundarias.
Herramientas disponibles
Honcho registra herramientas que el agente puede utilizar durante la conversación:
Recuperación de datos (rápida, sin llamadas a un LLM):
| Herramienta | Qué hace |
|---|---|
honcho_context |
Representación completa del usuario entre sesiones |
honcho_search_conclusions |
Búsqueda semántica entre las conclusiones almacenadas |
honcho_search_messages |
Busca mensajes entre sesiones (por remitente o fecha) |
honcho_session |
Historial y resumen de la sesión actual |
Preguntas y respuestas (con tecnología LLM):
| Herramienta | Qué hace |
|---|---|
honcho_ask |
Consulta información sobre el usuario. depth='quick' para datos, 'thorough' para síntesis |
Primeros pasos
Instala el plugin y ejecuta la configuración:
openclaw plugins install @honcho-ai/openclaw-honchoopenclaw honcho setupopenclaw gateway --forceEl comando de configuración solicita las credenciales de la API, escribe la configuración y permite migrar, de forma opcional, los archivos de memoria existentes del espacio de trabajo.
Configuración
Los ajustes se encuentran en plugins.entries["openclaw-honcho"].config:
{ plugins: { entries: { "openclaw-honcho": { config: { apiKey: "your-api-key", // omitir para alojamiento propio workspaceId: "openclaw", // aislamiento de la memoria baseUrl: "https://api.honcho.dev", }, }, }, },}En las instancias con alojamiento propio, establece baseUrl en el servidor local (por ejemplo,
http://localhost:8000) y omite la clave de API.
Migración de la memoria existente
Si tienes archivos de memoria existentes en el espacio de trabajo (USER.md, MEMORY.md,
IDENTITY.md, memory/, canvas/), openclaw honcho setup los detecta y
ofrece migrarlos.
Cómo funciona
Después de cada turno de la IA, la conversación se conserva en Honcho. Se observan tanto los mensajes del usuario como los del agente, lo que permite a Honcho crear y perfeccionar sus modelos con el tiempo.
Durante la conversación, las herramientas de Honcho consultan el servicio mediante el hook del plugin
before_prompt_build de OpenClaw e incorporan el contexto pertinente antes de que el modelo
vea el prompt.
Honcho frente a la memoria integrada
| Integrada/QMD | Honcho | |
|---|---|---|
| Almacenamiento | Archivos Markdown del espacio de trabajo | Servicio dedicado (local o alojado) |
| Entre sesiones | Mediante archivos de memoria | Automático e integrado |
| Modelado del usuario | Manual (escribir en MEMORY.md) | Perfiles automáticos |
| Búsqueda | Vectores + palabras clave (híbrida) | Semántica entre observaciones |
| Múltiples agentes | Sin seguimiento | Conocimiento de relaciones principal/secundario |
| Dependencias | Ninguna (integrada) o binario de QMD | Instalación del plugin |
Honcho y el sistema de memoria integrado pueden funcionar juntos. Cuando QMD está configurado, hay herramientas adicionales disponibles para buscar en archivos Markdown locales junto con la memoria entre sesiones de Honcho.
Comandos de la CLI
openclaw honcho setup # Configure API key and migrate filesopenclaw honcho status # Check connection statusopenclaw honcho ask <question> # Query Honcho about the useropenclaw honcho search <query> [-k N] [-d D] # Semantic search over memory