session-logs

Installation
Summary

Search and analyze your complete conversation history using jq and rg.

  • Session logs stored as append-only JSONL files at ~/.openclaw/agents/<agentId>/sessions/, indexed by session ID with full message transcripts including role, timestamp, content type, and token cost
  • Extract user messages, assistant responses, tool calls, and metadata using jq filters; search across all sessions or within specific files using rg for keyword matching
  • Common patterns provided for listing sessions by date, finding specific days, calculating session costs, counting messages, and analyzing tool usage breakdown
  • Supports filtering by message role ("user", "assistant", "toolResult") and content type ("text", "toolCall", "thinking") for targeted analysis
SKILL.md

session-logs

Search your complete conversation history stored in session JSONL files. Use this when a user references older/parent conversations or asks what was said before.

Trigger

Use this skill when the user asks about prior chats, parent conversations, or historical context that isn't in memory files.

Location

Session logs live under the active state directory: $OPENCLAW_STATE_DIR/agents/<agentId>/sessions/ (default: ~/.openclaw/agents/<agentId>/sessions/). Use the agent=<id> value from the system prompt Runtime line.

  • sessions.json - Index mapping session keys to session IDs
  • <session-id>.jsonl - Full conversation transcript per session

Structure

Related skills
Installs
1.6K
GitHub Stars
371.9K
First Seen
Jan 24, 2026