Reemplazando la Memoria Predeterminada de OpenClaw con Redis y Qdrant para Sistemas Multi-Agente en Producción

Escalando la Memoria de OpenClaw para Sistemas Multiagente en Producción

Un desarrollador que ejecutó OpenClaw en una configuración multiagente en producción en un VPS autohospedado durante dos meses descubrió que la capa de memoria predeterminada se volvió problemática a escala. Aunque el enfoque inicial con Markdown y posteriormente la memoria SQLite funcionan bien para uso local, colapsan con múltiples agentes ejecutándose en paralelo, sesiones que abarcan días y la necesidad de que los agentes recuperen contexto relevante de trabajos anteriores. Los problemas específicos incluyeron: falta de búsqueda semántica, ausencia de intercambio de memoria entre agentes y escrituras concurrentes desordenadas.

Solución de Arquitectura Redis + Qdrant

El desarrollador reconstruyó el sistema de memoria con la siguiente arquitectura:

• Redis para estado efímero activo: Tarea actual, ventana de contexto reciente, caché de llamadas a herramientas con TTL
• Qdrant para memoria vectorial persistente: Episodios pasados, observaciones, conocimiento extraído
• Tres colecciones en Qdrant: agent_episodes, agent_observations, agent_knowledge
• Intercambio de conocimiento entre agentes: Los episodios tienen alcance por agente, mientras que el conocimiento se comparte entre todos los agentes
• Reordenamiento con decaimiento temporal: Evita que recuerdos obsoletos contaminen la recuperación
• Redis pub/sub: Utilizado para señalización ligera de eventos entre agentes
• Incrustación por lotes + inserciones asíncronas en Qdrant: Evita que el ciclo del agente se bloquee en escrituras

Detalles de Implementación

El desarrollador documentó la implementación completa incluyendo decisiones de arquitectura, razonamiento de configuración HNSW, la clase del gestor de memoria, cómo se integró en el ciclo de observación y la estrategia de limpieza/poda. Para modelos de incrustación, están usando text-embedding-3-small y consideraron migrar completamente a local con nomic-embed-text pero aún no fue necesario.