session-logs

Parse OpenClaw session JSONL logs to extract messages, timestamps, and usage data.

1.0k|59|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/SafeAI-Lab-X/ClawKeeper --skill session-logs-safeai-lab-x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/SafeAI-Lab-X/ClawKeeper/tree/main/legacy/clawkeeper-watcher/skills/session-logs
Command: npx skills add https://github.com/SafeAI-Lab-X/ClawKeeper --skill session-logs-safeai-lab-x

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly locate and analyze prior conversations stored in session JSONL files to provide contextual history when users reference older chats or incomplete memory.

Core Features & Use Cases

  • Index and query session logs stored as JSONL files to surface past conversations.
  • Extract structured fields such as timestamps, user/assistant messages, and per-message usage data for auditing and context.
  • Use cases include retrieving context for a current thread, auditing chat history, and summarizing long conversations for knowledge continuity.

Quick Start

Review prior conversations by invoking the session-logs skill on your agent's session history.

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 past session logs stored as JSONL?

To search session logs stored as JSONL, you parse the sessions.json index to extract relevant messages, timestamps, and usage data. This retrieves historical context from prior conversations when memory is incomplete.

What is the best way to summarize older chat conversations for knowledge continuity?

Summarizing older chat conversations involves querying session JSONL files to locate past interactions and extracting structured fields like user and assistant messages. This provides contextual history for knowledge continuity.

Can I retrieve per-message usage data and timestamps from OpenClaw session history?

Yes, you can retrieve per-message usage data and timestamps from OpenClaw session history. The process extracts these structured fields directly from session JSONL files to support auditing and context retrieval.

Does parsing sessions.json work for auditing chat history in JSONL format?

Parsing sessions.json works for auditing chat history by indexing and querying session logs stored as JSONL files. It surfaces past conversations and extracts structured fields for comprehensive auditing.

Why does my agent lack context when I reference older chats not present in memory?

Your agent lacks context because older chats are not present in active memory. You can resolve this by retrieving relevant context from OpenClaw session logs stored as JSONL files to answer questions about prior conversations.