← Back to Skills Marketplace
irideas

Session Cleanup Pro

by irideas · GitHub ↗ · v0.3.0
cross-platform ✓ Security Clean
481
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install session-cleanup-pro
Description
Clean orphan .jsonl files and stale sessions in OpenClaw session storage with safe confirmation flow. 适用于会话列表杂乱、历史会话堆积、需要释放存储空间场景;默认保护 72 小时内会话,删除前必须用户确认。
Usage Guidance
This skill appears to do what it says: scan the OpenClaw session directory and propose deletions. Before running any cleanup: 1) Run the scan only (./skills/session-cleanup/scripts/scan_sessions.sh scan) and carefully inspect the JSON output. 2) Back up sessions.json and any .jsonl files you might want to keep (or archive them to a different directory) rather than immediate rm. 3) Be mindful of OPENCLAW_STATE_DIR and OPENCLAW_AGENT_ID environment overrides — if they are set, the script will operate on those paths instead of the defaults. 4) Prefer archiving/moving orphan files first; only perform hard deletes after a second, explicit confirmation. 5) Note that the provided script is read-only; the SKILL.md contains example rm commands which are destructive and must be executed deliberately. There are no network calls or hidden endpoints in the package. If you want extra safety, test on a copy of your state directory or run the scan in a non-production environment first.
Capability Analysis
Type: OpenClaw Skill Name: session-cleanup-pro Version: 0.3.0 The session-cleanup-pro skill is a utility designed to manage OpenClaw session storage by identifying and removing orphan .jsonl files and stale sessions. It uses a bash/Node.js script (scripts/scan_sessions.sh) to analyze the session directory and sessions.json metadata, implementing a 72-hour safety buffer and protecting the main session. The workflow defined in SKILL.md and references/policy.md strictly requires a read-only scan followed by explicit user confirmation before any file deletion (rm) occurs, showing no signs of malicious intent or unauthorized data exfiltration.
Capability Assessment
Purpose & Capability
Name/description, included script (scripts/scan_sessions.sh), and SKILL.md are consistent: the skill scans sessions.json and the sessions directory for orphan .jsonl and stale sessions. Required binaries (bash, node) are appropriate for the provided scripts. No unrelated credentials, config paths, or third-party services are requested.
Instruction Scope
SKILL.md enforces a scan → confirm → apply flow and documents destructive commands (rm) to remove orphan .jsonl and update sessions.json. The provided script only performs a read-only scan and outputs JSON; deletion instructions are explicit in SKILL.md but not implemented as an automated delete in scripts. This is coherent, but the instructions do include direct rm commands (destructive) so operator confirmation and backups are essential.
Install Mechanism
No install spec (instruction-only + one local script). Nothing is downloaded or extracted from external URLs; code is included in the package. This is low-risk from an install perspective.
Credentials
The skill does not require credentials or config paths. The script honors optional environment overrides OPENCLAW_STATE_DIR and OPENCLAW_AGENT_ID (with safe defaults). Those are proportional and relevant to locating session files.
Persistence & Privilege
always is false and the skill is user-invocable. It does not attempt to modify other skills or agent-wide settings. It does not persist credentials or try to enable itself automatically.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install session-cleanup-pro
  3. After installation, invoke the skill by name or use /session-cleanup-pro
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.3.0
0.3: New pro slug, English title, bilingual description, safer confirmation-first cleanup workflow.
Metadata
Slug session-cleanup-pro
Version 0.3.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Session Cleanup Pro?

Clean orphan .jsonl files and stale sessions in OpenClaw session storage with safe confirmation flow. 适用于会话列表杂乱、历史会话堆积、需要释放存储空间场景;默认保护 72 小时内会话,删除前必须用户确认。 It is an AI Agent Skill for Claude Code / OpenClaw, with 481 downloads so far.

How do I install Session Cleanup Pro?

Run "/install session-cleanup-pro" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Session Cleanup Pro free?

Yes, Session Cleanup Pro is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Session Cleanup Pro support?

Session Cleanup Pro is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Session Cleanup Pro?

It is built and maintained by irideas (@irideas); the current version is v0.3.0.

💬 Comments