Saltar al contenido principal

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 agrega memoria nativa de IA a OpenClaw. Conserva las conversaciones en un servicio dedicado y construye modelos de usuario y agente con el tiempo, dando a tu 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 entre restablecimientos de sesión, Compaction y cambios de canal.
  • Modelado de usuario — Honcho mantiene un perfil para cada usuario (preferencias, hechos, estilo de comunicación) y para el agente (personalidad, comportamientos aprendidos).
  • Búsqueda semántica — búsqueda sobre observaciones de conversaciones pasadas, no solo sobre la sesión actual.
  • Conciencia de múltiples agentes — los agentes padre rastrean automáticamente los subagentes generados, y los padres se agregan como observadores en las sesiones hijas.

​
Herramientas disponibles

Honcho registra herramientas que el agente puede usar durante la conversación: Recuperación de datos (rápida, sin llamada al LLM):
HerramientaQué hace
honcho_contextRepresentación completa del usuario entre sesiones
honcho_search_conclusionsBúsqueda semántica sobre conclusiones almacenadas
honcho_search_messagesBuscar mensajes entre sesiones (filtrar por remitente, fecha)
honcho_sessionHistorial y resumen de la sesión actual
Preguntas y respuestas (impulsado por LLM):
HerramientaQué hace
honcho_askHacer preguntas sobre el usuario. depth='quick' para hechos, 'thorough' para síntesis

​
Primeros pasos

Instala el Plugin y ejecuta la configuración: 
openclaw plugins install @honcho-ai/openclaw-honcho
openclaw honcho setup
openclaw gateway --force
El comando de configuración solicita tus credenciales de API, escribe la configuración y opcionalmente migra archivos de memoria existentes del espacio de trabajo.
Honcho puede ejecutarse completamente en local (autoalojado) o mediante la API gestionada en api.honcho.dev. No se requieren dependencias externas para la opción autoalojada.

​
Configuración

Los ajustes viven bajo 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",
        },
      },
    },
  },
}
Para instancias autoalojadas, apunta baseUrl a tu servidor local (por ejemplo http://localhost:8000) y omite la clave API.

​
Migrar memoria existente

Si tienes archivos de memoria existentes del espacio de trabajo (USER.md, MEMORY.md, IDENTITY.md, memory/, canvas/), openclaw honcho setup los detecta y ofrece migrarlos.
La migración no es destructiva — los archivos se cargan en Honcho. Los originales nunca se eliminan ni se mueven.

​
Cómo funciona

Después de cada turno de IA, la conversación se conserva en Honcho. Tanto los mensajes del usuario como los del agente se observan, lo que permite a Honcho construir y perfeccionar sus modelos con el tiempo. Durante la conversación, las herramientas de Honcho consultan el servicio en la fase before_prompt_build, inyectando contexto relevante antes de que el modelo vea el prompt. Esto garantiza límites de turno precisos y una recuperación relevante.

​
Honcho frente a la memoria integrada

Integrada / QMDHoncho
AlmacenamientoArchivos Markdown del espacio de trabajoServicio dedicado (local o alojado)
Entre sesionesMediante archivos de memoriaAutomático, integrado
Modelado de usuarioManual (escribir en MEMORY.md)Perfiles automáticos
BúsquedaVector + palabra clave (híbrida)Semántica sobre observaciones
Múltiples agentesSin seguimientoConciencia padre/hijo
DependenciasNinguna (integrada) o binario QMDInstalación de Plugin
Honcho y el sistema de memoria integrado pueden funcionar juntos. Cuando QMD está configurado, se habilitan herramientas adicionales para buscar en archivos Markdown locales junto con la memoria entre sesiones de Honcho.

​
Comandos CLI

openclaw honcho setup                        # Configurar clave API y migrar archivos
openclaw honcho status                       # Comprobar estado de conexión
openclaw honcho ask <question>               # Consultar a Honcho sobre el usuario
openclaw honcho search <query> [-k N] [-d D] # Búsqueda semántica sobre la memoria

​
Más información

​
Relacionado