Session Cleanup

Remove stale subagent session entries from OpenClaw's sessions.json index so they disappear from the webchat sidebar.

When to Use

• Subagent sessions remain visible in webchat sidebar after completion
• User asks to "remove subagent", "clear subagent list", "delete subagent sessions"
• Sidebar is cluttered with old subagent entries

How It Works

OpenClaw tracks sessions in ~/.openclaw/agents/<agent>/sessions/sessions.json. Subagent entries with missing transcript files are "ghost" sessions that still show in the UI. This skill removes those entries from the index.

Usage

Quick Clean (remove stale sessions only)

python3 scripts/cleanup_sessions.py

Removes subagent sessions whose transcript .jsonl files no longer exist on disk.

Remove ALL Subagent Sessions

python3 scripts/cleanup_sessions.py --all

Removes every subagent session entry regardless of transcript status.

Dry Run (preview only)

python3 scripts/cleanup_sessions.py --dry-run

Shows what would be removed without making changes.

Target Specific Agent

python3 scripts/cleanup_sessions.py --agent main

Only clean sessions for the main agent.

After Cleanup

Always restart the gateway for changes to take effect:

Use the gateway tool: action=restart

Or via CLI: openclaw gateway restart

Then refresh the webchat page.