session-logs

Search and analyze your complete conversation history using jq and rg. 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. Use this skill when the user asks about prior chats, parent conversations, or historical context that isn't in memory files. Session logs live under the active state directory: $OPENCLAW_STATE_DIR/agents/ /sessions/ (default: ~/.openclaw/agents/ /sessions/ ). Use the agent= value from the system prompt Runtime line. Each .jsonl file contains messages with: - Session logs stored as append-only JSONL files at ~/.openclaw/agents/ /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 - sessions.json - Index mapping session keys to session IDs - .jsonl - Full conversation transcript per session - type : "session"...