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

bash

python3 scripts/cleanup_sessions.py

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

Remove ALL Subagent Sessions#

bash

python3 scripts/cleanup_sessions.py --all

Removes every subagent session entry regardless of transcript status.

Dry Run (preview only)#

bash

python3 scripts/cleanup_sessions.py --dry-run

Shows what would be removed without making changes.

Target Specific Agent#

bash

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:

text

Use the gateway tool: action=restart

Or via CLI: openclaw gateway restart

Then refresh the webchat page.