ClawdScan is a diagnostic utility designed to maintain the health of AI agent environments by identifying session bloat and reclaiming storage.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install clawdscan
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install clawdscan using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is ClawdScan?
ClawdScan serves as a vital maintenance utility for developers working with Openclaw Skills. It acts as a zero-dependency Python CLI that deep-scans session JSONL files to pinpoint performance bottlenecks, such as zombie sessions that were never utilized or stale files consuming unnecessary disk space.
By providing granular visibility into how AI models and tools are used, it ensures that your agentic workflows remain lean and efficient. This skill is essential for anyone running long-term AI deployments where session data can quickly accumulate and impact system performance. It offers a suite of commands to inspect individual sessions, track historical trends, and automate the cleanup of problematic data points within the Openclaw Skills ecosystem.
ClawdScan Use Cases
- Identifying and archiving zombie sessions that were created but never used to save space.
- Analyzing tool usage patterns to see which Openclaw Skills are most frequently invoked by your agents.
- Monitoring storage growth and session bloat to prevent disk exhaustion in production environments.
- Deep-diving into specific session metadata to debug model switching behavior or message count issues.
How ClawdScan Works
- The user triggers a scan via the CLI or an automated heartbeat configuration within the Openclaw Skills framework.
- ClawdScan parses the local session JSONL files located within the agent directories.
- The tool calculates metrics for session size, message counts, and inactivity periods based on defined thresholds.
- It aggregates data on tool calls and model usage to identify patterns or potential inefficiencies.
- A comprehensive health report is generated with actionable cleanup recommendations for the environment.
- If requested, the tool executes safe cleanup operations, creating backups before deleting stale or zombie data.
ClawdScan Setup
To install ClawdScan as part of your Openclaw Skills library, use the built-in package manager:
clawdbot skill install clawdscan
Alternatively, you can run it as a standalone Python script:
chmod +x clawdscan.py
./clawdscan.py --help
You may also configure environment variables like CLAWDBOT_DIR to point the scanner to a custom directory.
ClawdScan Data Schema & Taxonomy
ClawdScan analyzes session data and can export reports in JSON format. It organizes data based on the following taxonomy:
| Data Type | Description | Location |
|---|---|---|
| Session Logs | JSONL files containing message history | agents/*/sessions/ |
| Meta Reports | Summary of health scans and issues | output.json |
| History | Historical trends and growth metrics | CLI output/JSON |
| Metadata | Timestamps, tool IDs, and model names | Extracted from JSONL |
The tool specifically tracks thresholds for bloat (sessions over 1MB or 300 messages), zombies (created but unused for 48 hours), and staleness (inactive for 7+ days).
ClawdScan Advanced Features
- Automated Heartbeat Integration for scheduled health checks and automated monitoring alerts.
- Trend Analysis to track session count and storage growth over 7, 30, or 90-day windows.
- Tool Analytics to find which Openclaw Skills are causing the most significant session bloat.
- Safe Cleanup mode with mandatory previews and backup creation before any destructive action.
- JSON Export capabilities for integration into external monitoring dashboards or custom Python scripts.
SKILL.md
Loading
Related Openclaw Skills
Claude Code Mastery
A comprehensive toolkit to deploy, optimize, and manage a professional AI development team within Claude Code.
xbird
A comprehensive MCP server providing 34 tools for AI agents to interact with Twitter/X through local residential IPs and micropayments.
NicheHunter Ultra
A headless market intelligence engine for detecting underserved app store niches and generating data-driven MVP specifications.
PDF Contract Redactor
A high-precision OCR tool that redacts sensitive values from scanned PDF contracts while leaving field labels intact.
ClawGuard
An advanced security blacklist system designed to protect AI agents from malicious commands, scams, and prompt injection attacks.
tokenmeter
A local, privacy-first CLI tool for Openclaw Skills that tracks LLM token consumption and provides real-time cost analysis across multiple providers.
METADATA
Featured*
