session-logs

Query historical session logs in JSONL files for past conversation context.

14|5|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/openclaw-easy/openclaw-easy-desktop --skill session-logs-openclaw-easy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/openclaw-easy/openclaw-easy-desktop/tree/main/openclaw/skills/session-logs
Command: npx skills add https://github.com/openclaw-easy/openclaw-easy-desktop --skill session-logs-openclaw-easy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Search and analyze your own session histories to reference older conversations and maintain context beyond memory.

Core Features & Use Cases

  • Efficiently locate and summarize past sessions from per-session JSONL files
  • Compare user and assistant messages across sessions to reveal context or patterns
  • Use Case: when a user asks about what was said earlier in a chat, retrieve and summarize relevant messages from prior sessions.

Quick Start

Use the session-logs skill to search and summarize conversations from ~/.openclaw/agents/<agentId>/sessions.

Frequently Asked Questions about session-logs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search past conversation history stored in JSONL files?

Search past conversation history by querying the sessions.json index and per-session JSONL files with jq and rg to extract messages, timestamps, and cost data from older interactions across multiple sessions.

What is the best way to summarize and compare messages across multiple sessions?

The best way to summarize and compare messages across multiple sessions is by reading per-session JSONL files to locate and extract relevant user and assistant messages, revealing context or patterns from past interactions.

Can I retrieve cost data and timestamps from older chat sessions?

Yes, you can retrieve cost data and timestamps from older chat sessions. The skill processes per-session JSONL files to extract messages, timestamps, and cost data for analysis across your complete session history.

Do I need jq and rg to analyze session logs?

Yes, you need jq and rg to analyze session logs. The skill relies on jq and rg for processing the sessions.json index and per-session JSONL structures to extract conversation context and data.

How do I find context from earlier in a chat when memory is exceeded?

To find context from earlier in a chat when memory is exceeded, query historical session logs stored as JSONL files to retrieve and summarize relevant messages from prior sessions, maintaining context beyond standard memory.

What are the limitations of searching session logs with this approach?

A limitation of searching session logs with this approach is that it requires sessions to be stored as JSONL files in a specific directory structure with a sessions.json index, and depends on jq and rg being installed.