Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.1.0 2026-03-14

Added

• Session replay, metrics, event logs and shareable snapshot cards for OpenClaw agents
• Live session viewer with sub-agent tree, token usage, and context progress
• Metrics charts: sessions, tokens (per-model), errors, uptime over 30m/1h/6h/12h/24h
• Structured event log viewer with density heatmap, type filtering, and search
• Gateway control operations: restart, update
• Screenshot API: POST /api/snapshot — capture dashboard as PNG/SVG/JSON
  • Detail levels: compact, standard, full
  • Themes: dark, light
  • Languages: en, zh
  • Server-side rendering via Satori + resvg (zero browser dependency)
  • Graceful degradation with safeCollect() pattern and X-Snapshot-Degraded-Sources header
• Snapshot Visual Design (V2 Glassmorphism)
  • Inter font with 5 weights (400–800)
  • Unified 390px viewport for all detail levels (mobile-first)
  • Indigo/violet color scheme with gradient progress bars
  • Glass card styling (Satori-compatible)
  • Header: OpenClaw brand with companion time and online/offline status
  • Footer: version + full datetime
  • Per-model token breakdown with stacked progress bar and colored legend
  • Token usage trend indicator (↑/↓ N% vs previous period, ⚠️ for spikes >100%)
• Lifetime Stats: companion days, total sessions/tokens/messages
  • lifetimeStats GraphQL query with Float types for large token counts
  • Two-phase transcript scanning: full scan + incremental watch
• Pipeline engine: event-sourced token tracking with delta aggregation
  • 5 component roles: Source, Managed, Processor, Service, Port
  • Declarative wiring and lifecycle management
• Event bus system: TokenEventBus + MessageEventBus with batch buffering
• Session turn count display (💬 N turns) from persistent message event tracking
• message_events table for persistent per-message tracking
• GraphQL API with subscriptions (SSE) for real-time data
  • Source-centric schema v2 with system, sources, source root queries
  • Session transcript query with cursor-based pagination
• Token-based authentication (auto-generated, URL-based)
  • Auth session rotation with stable Bearer token + rotating session cookie
  • Access logging
• useRetryWithBackoff hook: exponential backoff for gateway failures
• Platform adapters: darwin (ps aux) + linux (/proc) + mock
• Data retention service with configurable retention
• Database abstraction layer with DI and migration compression
• Dark / Light theme with CSS variable theming
• English and Chinese (中文) i18n
• SQLite-based metrics storage with configurable retention
• Health endpoint: GET /health
• Structured logging across all server modules (pino)
• Agent skill files: claw-insights-install and claw-insights-snapshot
• CLI: start, stop, status, logs, restart, snapshot
• E2E test suite with mock CLI + fixture data isolation
• Integration test suite: GraphQL resolvers with real server
• Comprehensive test suite: 1370+ tests across server and web packages

Security

• Auth enabled by default in production (auto-generated token)
• API token minimum 32 characters enforced
• Rotating session cookie with configurable intervals
• No-auth mode requires explicit opt-in + localhost-only for snapshot endpoint