session-logs

• El usuario pregunta "¿de qué hablamos la semana pasada?" o hace referencia a una conversación anterior que no está en la memoria actual.
• Necesitas calcular los costos de sesión, contar mensajes o resumir el uso de herramientas en chats históricos.
• Quieres buscar una palabra clave o frase específica en todas las sesiones pasadas rápidamente.
• Necesitas identificar sesiones por fecha, tamaño o proveedor (Discord, WhatsApp, etc.) usando el índice sessions.json.

• El contexto que necesitas ya está disponible en la ventana de conversación actual o en los archivos de memoria — no es necesario acceder al sistema de archivos.
• Estás trabajando en un entorno donde el almacenamiento de sesiones ~/.openclaw/agents/ no existe o no es accesible.

Usa rg (ripgrep) para buscar una frase o palabra clave en todos los archivos JSONL de sesión con un solo comando. Localiza rápidamente qué sesiones contienen contenido relevante sin tener que leer cada archivo manualmente.

Extrae mensajes de usuario, respuestas del asistente, llamadas a herramientas o bloques de pensamiento de forma independiente usando selectores jq en los campos .message.role y .message.content[].type. Filtra automáticamente el ruido como los resultados de herramientas.

Agrega message.usage.cost.total en una sesión o en todas las sesiones por día para generar resúmenes de costos. También permite contar mensajes, calcular la duración de las sesiones y desglosar el uso de herramientas por frecuencia.

Lista todas las sesiones ordenadas por fecha y tamaño de archivo, encuentra sesiones de un día específico, o consulta sessions.json para mapear proveedores de chat (Discord, WhatsApp, etc.) a IDs de sesión.

Las sesiones son archivos JSONL de solo anexión que pueden crecer hasta varios MB. Los patrones de consulta del skill incluyen consejos de muestreo con head/tail y el uso de jq en modo streaming para evitar cargar archivos completos en memoria de forma innecesaria.

Cuando un usuario dice "¿recuerdas cuando hablamos de X el mes pasado?", el agente utiliza esta habilidad para buscar archivos de sesión por fecha o palabra clave y recuperar el intercambio relevante, incluso si ya no se encuentra en la ventana de contexto activa de session-logs.

Un desarrollador quiere entender cuánto cuesta cada conversación. Esta skill agrega cost.total por sesión y agrupa los resultados por día, produciendo un desglose de costos legible a lo largo de todo el historial del agente.

Un operador quiere saber qué herramientas llama el agente con mayor frecuencia. Esta habilidad extrae entradas toolCall de los registros de sesión, las cuenta y las clasifica — útil para depurar u optimizar el comportamiento del agente.

Un usuario pregunta si un tema en particular (por ejemplo, el nombre de un proyecto, una decisión) fue discutido alguna vez. El agente ejecuta una búsqueda con ripgrep en todos los archivos JSONL y devuelve las rutas de sesión coincidentes para una exploración posterior.