| name | session-cleaner |
| description | 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. |
Permission Setup Review
python scripts/_prepare_workspace.py is an optional setup helper for the Session Cleaner skill. It may apply broad filesystem permissions for compatibility. Show the target paths and permission mode, explain the risk, and prefer a narrower mode when shared write access is not needed.
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
