---
read_when:
    - Necesita encontrar algo que se trató en una sesión anterior
    - Quiere comprender la privacidad o la indexación de la búsqueda de sesiones
summary: Busca transcripciones de sesiones anteriores y vuelve a abrir el contexto correspondiente
title: Búsqueda de sesiones
x-i18n:
    generated_at: "2026-07-26T04:37:15Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 3e9cda6b656b689eef0636592914f4890a64dca5e955aa03908377903aaa29c9
    source_path: concepts/session-search.md
    workflow: 16
---

# 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`](/es/concepts/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.