Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Manage and analyze OpenClaw sessions by checking usage, pruning old sessions, cleaning orphaned files, and viewing stats via CLI or dashboard.
Manage and analyze OpenClaw sessions by checking usage, pruning old sessions, cleaning orphaned files, and viewing stats via CLI or dashboard.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Use this skill when the user asks about: Session management or cleanup Context usage or token consumption Storage space used by sessions Pruning old sessions Cleaning up orphaned session files Session analysis or statistics Which sessions are taking up space How many messages/tokens in sessions
The ContextClaw plugin must be installed: npm install -g @rmruss2022/contextclaw openclaw plugins install @rmruss2022/contextclaw
Check if ContextClaw is installed and running: openclaw contextclaw status
Get comprehensive analysis of all sessions: openclaw contextclaw analyze This shows: Total sessions, messages, tokens, storage size Largest sessions (top 10) Oldest sessions (top 10) Orphaned sessions
Clean up sessions older than N days (default: 30): # Dry run (preview only, safe) openclaw contextclaw prune --days 30 # Live run (actually deletes) openclaw contextclaw prune --days 30 --dryRun false Safety features: Dry run by default (previews before deleting) Always keeps main agent sessions Always keeps cron sessions Shows confirmation before deleting
Remove session files not referenced in sessions.json: # Dry run openclaw contextclaw clean-orphaned # Live run openclaw contextclaw clean-orphaned --dryRun false
Open the visual session management dashboard: openclaw contextclaw dashboard This opens http://localhost:18797
Show brief status and statistics: openclaw contextclaw status
Reconfigure port or OpenClaw home: openclaw contextclaw setup
The dashboard at http://localhost:18797 provides: Session statistics - Total sessions, messages, tokens, storage Multiple views - All, Largest, Oldest, Orphaned, Charts Bar charts - Visual size distribution Type breakdown - Sessions by agent type (main, cron, sub-agent) Quick actions - Prune and clean from UI (preview only)
User asks: "How much storage are my sessions using?" Response: openclaw contextclaw analyze Look at the "Total Size" metric in the summary table. User asks: "Clean up old sessions" Response: # First preview what would be deleted openclaw contextclaw prune --days 30 # If approved, run live: openclaw contextclaw prune --days 30 --dryRun false User asks: "Which sessions are taking up the most space?" Response: openclaw contextclaw analyze Check the "Largest Sessions" table, or open the dashboard: openclaw contextclaw dashboard User asks: "Remove orphaned session files" Response: # Preview first openclaw contextclaw clean-orphaned # If user approves, run live: openclaw contextclaw clean-orphaned --dryRun false
ContextClaw categorizes sessions as: main - Main agent session (protected from pruning) cron - Cron job sessions (protected from pruning) subagent - Spawned sub-agent sessions (can be pruned) unknown - Unrecognized session types
A session is orphaned if: .jsonl file exists in sessions directory Session ID is NOT in sessions.json Common causes: Completed sub-agent removed from index Manual file operations Crashed sessions Development/testing Orphaned sessions are safe to delete.
Analyze regularly - Weekly or monthly: openclaw contextclaw analyze Always dry-run first - Preview before deleting Adjust age threshold - 30 days is default, adjust as needed Review orphaned - Check before cleaning Backup if worried - Though main/cron are protected
If dashboard won't load: openclaw contextclaw status # Check if running openclaw contextclaw start # Start if stopped If port is in use: openclaw contextclaw setup # Choose a different port
Port: 18797 (default, configurable) Analysis: Parses all .jsonl files in ~/.openclaw/agents/main/sessions/ Token estimation: 1 token โ 4 characters (approximate) Storage: Read-only, no database
๐ Session Analysis โโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโ โ Metric โ Value โ โโโโโโโโโโโโโโโโโโโโผโโโโโโโโโค โ Total Sessions โ 45 โ โ Total Messages โ 3,842 โ โ Total Tokens โ 156,234โ โ Total Size โ 12.4 MBโ โ Orphaned โ 8 โ โโโโโโโโโโโโโโโโโโโโดโโโโโโโโโ
๐งน Session Pruning โ ๏ธ DRY RUN MODE - No files will be deleted Sessions older than 30 days: โ Would delete: 12 - Would keep: 33 - Space freed: 4.2 MB ? Run prune in LIVE mode (actually delete files)? (y/N)
GitHub: https://github.com/rmruss2022/ContextClaw npm: @rmruss2022/contextclaw
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.