# 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.

- Skill: `knownasnaffy/session-cleaner-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add knownasnaffy/session-cleaner-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/knownasnaffy/session-cleaner-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: knownasnaffy (https://skillmd.com/u/knownasnaffy)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/knownasnaffy/session-cleaner-2

---


# 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
bash scripts/clean-sessions.sh [--dry-run]
```

- Default: move stale files to backup
- `--dry-run`: only report what would be moved, no changes