Búsqueda de sesiones

sessions_search busca el texto del usuario y del asistente en las sesiones anteriores propias. Cada resultado incluye una sessionKey, una marca de tiempo, un rol y un breve fragmento coincidente. Pase la sessionKey devuelta a sessions_history cuando necesite la conversación circundante.

Visibilidad y salida

La búsqueda utiliza las mismas reglas de visibilidad de sesiones que sessions_history. Los resultados fuera del árbol de sesiones visible para el llamador se eliminan antes de aplicar los límites de resultados. Los agentes en zona protegida siguen estando limitados a las sesiones que iniciaron cuando está habilitada la visibilidad de las sesiones iniciadas.

Los fragmentos se redactan antes de devolverse al modelo. Los resultados también están limitados por cantidad, longitud del fragmento y tamaño total de la respuesta.

Ciclo de vida del índice

OpenClaw almacena un índice de texto completo junto a las filas de transcripción en la base de datos SQLite de cada agente. Los mensajes nuevos del usuario y del asistente se indexan en la misma transacción que los conserva, por lo que el índice nunca queda rezagado respecto de las conversaciones activas; se excluyen los resultados de herramientas, los bloques de razonamiento y las imágenes. Solo se puede buscar en la rama activa de la transcripción.

Las transcripciones anteriores a la creación del índice (por ejemplo, las sesiones importadas por openclaw doctor) y las sesiones cuya rama activa se haya rebobinado se vuelven a indexar mediante una conciliación en segundo plano que comienza con la siguiente búsqueda. Por lo tanto, una respuesta con indexing: true puede estar incompleta; vuelva a intentarlo después de que termine la indexación. Al eliminar una sesión, sus entradas del índice se eliminan en la misma transacción.

Actualmente, la búsqueda utiliza el tokenizador de palabras Unicode de SQLite con eliminación de diacríticos. La tokenización por trigramas para la coincidencia de subcadenas CJK es una mejora futura.

Búsqueda de sesiones frente a búsqueda en memoria

Use sessions_search para buscar palabras o frases exactas en las transcripciones sin procesar de las sesiones. Use memory_search para archivos de memoria persistente y recuperación semántica. El corpus experimental de memoria de sesiones es el complemento semántico de esta búsqueda exacta en transcripciones.