Búsqueda de sesiones

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

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 entornos aislados siguen limitados a las sesiones que iniciaron cuando la visibilidad de las sesiones iniciadas está habilitada.

Los fragmentos se censuran antes de devolverse al modelo. Los resultados también están limitados por cantidad, longitud de los fragmentos 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 nuevos mensajes del usuario y del asistente se indexan en la misma transacción que los conserva, por lo que el índice nunca queda rezagado respecto a las conversaciones activas; se excluyen los resultados de herramientas, los bloques de razonamiento y las imágenes. Solo se pueden buscar las ramas activas de las transcripciones.

Las transcripciones anteriores a la creación del índice (por ejemplo, las sesiones importadas mediante openclaw doctor) y las sesiones cuya rama activa se ha 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, se eliminan sus entradas del índice en la misma transacción.

Actualmente, la búsqueda utiliza el tokenizador de palabras Unicode de SQLite con eliminación de signos 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

Utilice sessions_search para buscar palabras o frases exactas en las transcripciones sin procesar de las sesiones. Utilice 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.