← Back to Skills Marketplace
140
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install hypercho-session-cleanup
Description
Clean up OpenClaw session storage across all agents. Removes tombstone files (.reset, .deleted, .bak), old cron session .jsonl files, orphan files, and stale...
README (SKILL.md)
Session Cleanup
Automated cleanup of OpenClaw session storage across all registered agents.
What It Cleans
- Tombstone files —
.reset.*,.deleted.*,.bak-*(always safe to remove) - Old cron sessions —
.jsonlfiles +sessions.jsonentries older than 7 days for cron-type sessions - Orphan files —
.jsonlfiles on disk not referenced bysessions.json - Stale entries —
sessions.jsonentries pointing to missing.jsonlfiles (cron sessions only)
Safety Guarantees
- Never touches
.lockfiles or their corresponding active.jsonl - Never deletes
sessions.jsonitself - Backs up
sessions.jsonbefore modifying - Never removes non-cron sessions under 30 days old
- Never removes main session entries
Usage
Run cleanup for all agents
python3 \x3Cskill_dir>/scripts/session_cleanup.py
Dry run (preview only)
python3 \x3Cskill_dir>/scripts/session_cleanup.py --dry-run
Single agent only
python3 \x3Cskill_dir>/scripts/session_cleanup.py --agent main
Agent Discovery
The script automatically discovers all agents by scanning ~/.openclaw/agents/*/sessions/. No hardcoded agent list needed — new agents are picked up automatically.
Cron Integration
Set up as a daily midnight cron job for automatic maintenance:
Schedule: 0 0 * * * (midnight local time)
Model: minimax/MiniMax-M2.7-highspeed
Thinking: low
Timeout: 600s
Cron task message:
Single task only: run session cleanup for all agents.
Command:
bash -lc 'python3 \x3Cskill_dir>/scripts/session_cleanup.py'
Return ONLY the command stdout (no extra commentary).
Output Format
The script prints a summary per agent showing what was cleaned, then a grand total:
Agents discovered: 22
ada: 165 tombstones (21.1 MB), 7 old crons (372 KB)
vera: 924 tombstones (31.6 MB), 4 old crons (252 KB)
✅ Session cleanup complete across 22 agents
Freed: 171.6 MB
Cleaned: ada, vera
Already clean: main, clio, argus
If nothing needs cleaning, it reports "Already clean. Nothing to do."
Retention Policy
| Session Type | Retention | Action |
|---|---|---|
| Tombstones (.reset/.deleted/.bak) | 0 days | Always delete |
| Cron session files | 7 days | Delete after 7 days |
| Non-cron sessions | 30 days | Keep (no auto-delete) |
| Main sessions | Forever | Never touched |
| Active sessions (.lock) | Forever | Never touched |
Usage Guidance
This skill appears to do exactly what it says (clean local OpenClaw session folders) and does not request credentials or network access, but take these precautions before enabling automatic runs: 1) Inspect the script yourself (it backs up sessions.json to sessions.json.json.bak) and confirm the deletion rules match your policies. 2) Always run the dry-run first: python3 <skill_dir>/scripts/session_cleanup.py --dry-run and review output. 3) Verify sessions.json backup behavior and that backups are created where you expect. 4) Test on a single agent (python3 ... --agent <name>) before running across all agents. 5) Be aware the cron recommendation will run unattended; only add it to cron after tests. 6) Note the script classifies cron sessions by substring match ('cron' in key) — if your session keys use different naming, confirm it won't remove needed data. If you want extra safety, run the script under a user/account with limited access or add additional logging/notification before deleting.
Capability Analysis
Type: OpenClaw Skill
Name: hypercho-session-cleanup
Version: 1.1.0
The skill bundle provides a maintenance utility for cleaning up temporary and expired session files within the OpenClaw environment (~/.openclaw/agents/). The script (session_cleanup.py) implements targeted file deletion of 'tombstone' files and old cron logs, includes safety mechanisms like file backups and retention policies, and lacks any indicators of data exfiltration, unauthorized network access, or malicious execution.
Capability Assessment
Purpose & Capability
Name/description, SKILL.md, and the included Python script all focus on scanning ~/.openclaw/agents/*/sessions/ and deleting tombstones, old cron .jsonl files, orphan .jsonl files, and stale sessions.json entries. There are no unrelated environment variables, binaries, or external services requested.
Instruction Scope
Instructions are scoped to local session storage and provide a dry-run mode and single-agent target. Minor concerns: the SKILL.md includes cron scheduling/model metadata (scheduling the skill to run automatically) and the script uses a simple substring check for cron sessions (is_cron_session returns True if 'cron' appears anywhere in the key), which could misclassify some entries. Otherwise the instructions do not request unrelated files or secrets.
Install Mechanism
No install spec or external downloads; this is an instruction-only skill with a local Python script included. Nothing will be fetched from remote URLs during install.
Credentials
No environment variables, credentials, or external config paths are required. The script reads and writes only within user home ~/.openclaw/agents/*/sessions/ (and writes a local backup .json.bak). That access level is proportionate to a session-cleanup tool, but it does have broad filesystem scope limited to OpenClaw agent folders.
Persistence & Privilege
The skill is not always:true and does not request permanent platform privileges, but SKILL.md explicitly recommends adding a daily cron job for automatic runs. Combined with the ability for the agent to invoke skills autonomously (platform default), this means the script can be scheduled to run unattended — ensure you want automatic deletion across all agents.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install hypercho-session-cleanup - After installation, invoke the skill by name or use
/hypercho-session-cleanup - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Added setup prompt for easy onboarding — copy-paste into OpenClaw chat to install and configure.
v1.0.0
Initial release: automated OpenClaw session storage cleanup across all agents. Removes tombstones, old cron sessions, orphans, and stale entries. Supports --dry-run, --agent, and auto-discovery.
Metadata
Frequently Asked Questions
What is Session Cleanup (Hypercho)?
Clean up OpenClaw session storage across all agents. Removes tombstone files (.reset, .deleted, .bak), old cron session .jsonl files, orphan files, and stale... It is an AI Agent Skill for Claude Code / OpenClaw, with 140 downloads so far.
How do I install Session Cleanup (Hypercho)?
Run "/install hypercho-session-cleanup" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Session Cleanup (Hypercho) free?
Yes, Session Cleanup (Hypercho) is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Session Cleanup (Hypercho) support?
Session Cleanup (Hypercho) is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Session Cleanup (Hypercho)?
It is built and maintained by Duola (@duolahypercho); the current version is v1.1.0.
More Skills