Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Enterprise-grade OpenClaw skill for cleaning up orphaned subagent processes, archiving transcripts to SuperMemory, and freeing disk space without losing work. Features dry-run mode, configurable retention policies, and comprehensive safety checks.
Enterprise-grade OpenClaw skill for cleaning up orphaned subagent processes, archiving transcripts to SuperMemory, and freeing disk space without losing work. Features dry-run mode, configurable retention policies, and comprehensive safety checks.
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.
Enterprise-grade cleanup tool for OpenClaw subagent management.
Automatically identifies and cleans up orphaned subagent sessions while preserving important work through SuperMemory archival.
Scan: Analyze session directory for orphaned/abandoned subagents Archive: Save transcripts to SuperMemory before deletion Clean: Safely remove orphaned sessions freeing disk space Report: Generate detailed cleanup reports
This skill implements multiple safety layers: β Never deletes active sessions β checks process status β Dry-run mode β preview changes before executing β SuperMemory backup β transcripts archived before deletion β Configurable retention β customize age thresholds β Detailed logging β full audit trail of all actions
# Preview what would be cleaned (dry-run) python3 scripts/swarm_janitor.py --dry-run # Archive old sessions to SuperMemory, then clean python3 scripts/swarm_janitor.py --archive --clean # Custom retention (7 days instead of default 3) python3 scripts/swarm_janitor.py --retention-days 7 --clean
Copy this skill to your OpenClaw workspace: cp -r skills/swarm-janitor ~/.openclaw/workspace/skills/ Configure retention policy (optional): # Edit config to customize nano references/config.yaml Run first scan: python3 ~/.openclaw/workspace/skills/swarm-janitor/scripts/swarm_janitor.py --dry-run
# Run daily at 3 AM, archive sessions older than 3 days 0 3 * * * python3 ~/.openclaw/workspace/skills/swarm-janitor/scripts/swarm_janitor.py --archive --clean --retention-days 3 >> /var/log/swarm-janitor.log 2>&1
# See what would be deleted python3 scripts/swarm_janitor.py --dry-run --verbose # Archive transcripts to SuperMemory python3 scripts/swarm_janitor.py --archive # Clean without archiving (not recommended) python3 scripts/swarm_janitor.py --clean --no-archive # Full report python3 scripts/swarm_janitor.py --report --output json
# Aggressive cleanup with 1-day retention python3 scripts/swarm_janitor.py --clean --retention-days 1 --force
See references/config.yaml for: Retention policies Archive destinations Safety thresholds Logging options
Discovery: Scans ~/.openclaw/agents/main/sessions/ Analysis: Determines session age, activity status, size Classification: Identifies orphaned vs active sessions Archival: Saves transcripts to SuperMemory (if enabled) Cleanup: Safely removes orphaned session files Reporting: Generates summary of actions taken
CheckDescriptionProcess CheckVerifies no active process owns the sessionAge VerificationOnly processes sessions older than thresholdSize LimitsWarns on unusually large deletionsDry-Run DefaultPreview mode is default β explicit action requiredBackup FirstArchives to SuperMemory before any deletion
Q: It says "permission denied" A: Ensure you have write access to the sessions directory Q: Sessions not being detected A: Check the path in config.yaml matches your OpenClaw installation Q: SuperMemory archive failing A: Verify SuperMemory skill is configured with valid API key
Audit Logging: All actions logged with timestamps Configurable Policies: YAML-based configuration Metrics Export: JSON/CSV output for monitoring Dry-Run Mode: Test changes before applying Retention Policies: Age-based and count-based rules
MIT - Created by OpenClawdad (Redclay) for the OpenClaw community.
Agent frameworks, memory systems, reasoning layers, and model-native orchestration.
Largest current source with strong distribution and engagement signals.