Session Cleaner

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.

dvcrn Updated 32 repo stars

File contents

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

dvcrn/openclaw-skills-marketplace/tree/main/plugins/guoqunabc--session-cleaner/skills/session-cleaner commit 23c444d3d0

Frequently asked questions

npx skillmds@latest add dvcrn/session-cleaner