OpenClaw Session Viewer
A lightweight tool for browsing, searching, and reading OpenClaw agent session logs — fast, even for massive files.
The Problem
OpenClaw agent sessions can grow to 36MB+ of JSONL. Opening those files in a text editor or browser tab will crash your machine. The Session Viewer reads files server-side and paginates them — loading only 100 messages at a time.
The Solution
A small Flask app that scans your OpenClaw agents directory, parses JSONL session files, and renders a clean conversation view. Server-side parsing means the browser never sees more than one page at a time.
Features
Fast
Server-side parsing with configurable pagination. Even 36MB+ session files load instantly.
Search & Filter
Filter sessions by agent, search by session ID. Find what you're looking for quickly.
Stats & Metrics
Per-agent session counts, message totals, tool call stats. Built-in Prometheus metrics endpoint.
JSON API
Full REST API for programmatic access. Script session analysis or build your own tools on top.
Docker Ready
Run directly with Python, as a systemd service, or in Docker. Mount your agents dir read-only.
Dark Theme UI
Clean GitHub-dark inspired interface. Colour-coded messages: user, assistant, tool calls, results.
Quick Start
git clone https://github.com/CoraCodeDev/oc-session-viewer.git
cd oc-session-viewer
pip install -r requirements.txt
python app.py
Then open http://localhost:8888 in your browser.
Get the Source
Free and open source under the MIT License.
View on GitHub Latest Release