โ† All skills
Tencent SkillHub ยท Developer Tools

ContextClaw Plugin Usage

Manage and analyze OpenClaw sessions by checking usage, pruning old sessions, cleaning orphaned files, and viewing stats via CLI or dashboard.

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

Manage and analyze OpenClaw sessions by checking usage, pruning old sessions, cleaning orphaned files, and viewing stats via CLI or dashboard.

โฌ‡ 0 downloads โ˜… 0 stars Unverified but indexed

Install for OpenClaw

Quick setup
  1. Download the package from Yavira.
  2. Extract the archive and review SKILL.md first.
  3. Import or place the package into your OpenClaw setup.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Yavira redirect
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
SKILL.md

Validation

  • Use the Yavira download entry.
  • Review SKILL.md after the package is downloaded.
  • Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

  1. Download the package from Yavira.
  2. Extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the extracted folder.
New install

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.

Upgrade existing

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.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
1.0.0

Documentation

ClawHub primary doc Primary doc: SKILL.md 19 sections Open source page

When to Use

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

Prerequisites

The ContextClaw plugin must be installed: npm install -g @rmruss2022/contextclaw openclaw plugins install @rmruss2022/contextclaw

Quick Start

Check if ContextClaw is installed and running: openclaw contextclaw status

Analyze Sessions

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

Prune Old 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

Clean Orphaned Sessions

Remove session files not referenced in sessions.json: # Dry run openclaw contextclaw clean-orphaned # Live run openclaw contextclaw clean-orphaned --dryRun false

Dashboard

Open the visual session management dashboard: openclaw contextclaw dashboard This opens http://localhost:18797

Quick Stats

Show brief status and statistics: openclaw contextclaw status

Configuration

Reconfigure port or OpenClaw home: openclaw contextclaw setup

Dashboard Features

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)

Example Usage

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

Session Types

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

Orphaned Sessions

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.

Best Practices

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

Troubleshooting

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

Technical Details

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

Analyze Command

๐Ÿ“Š Session Analysis โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Metric โ”‚ Value โ”‚ โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค โ”‚ Total Sessions โ”‚ 45 โ”‚ โ”‚ Total Messages โ”‚ 3,842 โ”‚ โ”‚ Total Tokens โ”‚ 156,234โ”‚ โ”‚ Total Size โ”‚ 12.4 MBโ”‚ โ”‚ Orphaned โ”‚ 8 โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

Prune Command

๐Ÿงน 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)

Repository

GitHub: https://github.com/rmruss2022/ContextClaw npm: @rmruss2022/contextclaw

Category context

Code helpers, APIs, CLIs, browser automation, testing, and developer operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
1 Docs
  • SKILL.md Primary doc