openclaw session viewer

v1.0.0

Generate an interactive HTML viewer to review and analyze OpenClaw conversation sessions, including history, tool calls, token usage, and debugging details.

1· 272· 1 versions· 2 current· 2 all-time· Updated 4h ago· MIT-0
byNan Wang@nan-wang

Install

openclaw skills install openclaw-session-viewer

OpenClaw Session Viewer

Generate an interactive HTML viewer for OpenClaw session logs with full conversation history, tool calls, and results.

Quick Start

# Extract and view current session
python3 ~/.openclaw/skills/session-viewer/scripts/extract_session.py
open /tmp/session_viewer.html

Commands

Extract current session

python3 ~/.openclaw/skills/session-viewer/scripts/extract_session.py [--agent main] [--output /tmp/session_viewer.html]

Extract specific session by ID

python3 ~/.openclaw/skills/session-viewer/scripts/extract_session.py --session-id <uuid>

List available sessions

python3 ~/.openclaw/skills/session-viewer/scripts/extract_session.py --list

Output

The viewer includes:

  • Sidebar: All conversation turns with search
  • User messages: Full raw text
  • Assistant responses: Text + collapsible thinking blocks
  • Tool calls: Full arguments JSON
  • Tool results: Full output with status/exit code
  • Stats: Token usage, cost, models used

Session Log Location

~/.openclaw/agents/<agentId>/sessions/
├── sessions.json          # Index: session keys → IDs
└── <session-id>.jsonl     # Conversation log

Tips

  • Use keyboard navigation: ↑/↓ or j/k to browse turns
  • Search filters across all fields (messages, tools, results)
  • Click thinking header to expand/collapse

Version tags

latestvk97a913rr4dab3a3ks8q9aw19s82rcbq