SkillHub

session-cleaner

v1.0.0

Clean up stale OpenClaw session files. Keep the current main session and all group chat sessions; move everything else to a backup directory. Use when performing periodic maintenance, heartbeat cleanup, or when the user asks to clean up sessions.

Sourced from ClawHub, Authored by Madoka

Installation

Please help me install the skill `session-cleaner` from SkillHub official store. npx skills add guoqunabc/session-cleaner

Session Cleaner

Clean stale session transcript files from ~/.openclaw/agents/main/sessions/.

Rules

  • Always keep: current main session (the one with agent:main:main key that is active)
  • Always keep: all group chat sessions (target address contains oc_)
  • Move to backup: everything else (old main sessions, completed sub-agents, API sessions, cron/heartbeat transcripts)
  • Never delete: all moved files go to sessions/backup/, recoverable

Usage

bash scripts/clean-sessions.sh [--dry-run]
  • Default: move stale files to backup
  • --dry-run: only report what would be moved, no changes