session-logs

Search and analyze OpenClaw session logs with jq and rg.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/wuv-dreamguide/openclaw --skill session-logs-wuv-dreamguide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/wuv-dreamguide/openclaw/tree/main/skills/session-logs
Command: npx skills add https://github.com/wuv-dreamguide/openclaw --skill session-logs-wuv-dreamguide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps you quickly locate, summarize, and analyze older or parent conversations stored in session logs so you can recall decisions and context without wading through raw transcripts.

Core Features & Use Cases

  • Search historical conversations: Find references, quotes, or decisions across sessions using jq and ripgrep.
  • Context extraction: Extract summarized insights or user intents from long transcripts.
  • Use Case: When a user asks about a previous topic, retrieve relevant conversations and highlight key points.

Quick Start

Search your session logs for references to a topic and summarize the key points.

Frequently Asked Questions about session-logs

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

FAQPage Schema
How do I search and extract context from previous session logs?

To search session logs and extract context, this skill analyzes JSONL files within the OpenClaw state directory. It uses ripgrep for text search and jq for structured extraction to surface prior conversations, references, and decisions.

What is the best way to locate past decisions in OpenClaw JSONL transcripts?

The best way to locate past decisions in JSONL transcripts is by searching the session history in the OpenClaw state directory. The skill applies jq extraction and rg text search to find and summarize specific past decisions.

Can I use jq and ripgrep to find specific quotes across older conversations?

Yes, you can use jq and ripgrep to locate specific quotes across older conversations. The skill searches session logs stored as JSONL files, applying rg for text search and jq to extract and output structured summaries of matching quotes.

Does this session history search require any specific environment setup?

Searching session history requires access to the OpenClaw state directory where older parent conversations are stored as JSONL files. The skill operates directly on these logs using jq and rg without needing external components.

How do I summarize user intents from long historical session transcripts?

You can summarize user intents from long historical session transcripts by applying jq to extract relevant insights from the JSONL data. The skill processes these older conversations to output structured summaries of key points and intents.

When should I not use jq to analyze session logs?

You should not use jq to analyze session logs if your conversation history is not stored as JSONL files in the OpenClaw state directory. This skill specifically targets structured JSONL transcripts for rg text search and jq extraction.