Sessions Manager
Manage OpenClaw agent sessions through CLI commands.
Commands
List Sessions
List all sessions with their status, model, and duration:
python3 ~/.openclaw/workspace/skills/sessions-manager/scripts/sessions_cli.py list
For verbose output (includes channel info):
python3 ~/.openclaw/workspace/skills/sessions-manager/scripts/sessions_cli.py list -v
Delete Session
Delete a session by session ID or session key:
python3 ~/.openclaw/workspace/skills/sessions-manager/scripts/sessions_cli.py delete <session-id-or-key>
Example:
python3 ~/.openclaw/workspace/skills/sessions-manager/scripts/sessions_cli.py delete agent:main:subagent:5adb35d1-d8e3-4ab7-b9b9-c69a7f891fb3
Output Format
The list command shows:
- 📌 Session key (e.g.,
agent:main:main,agent:main:subagent:xxx) - Session ID (UUID)
- Label (if set, e.g., "bsv-lsp 常量展开实现")
- Status (running, completed, timeout, etc.)
- Model being used
- Start time
- Duration
Session Files
Sessions are stored in:
- Metadata:
~/.openclaw/agents/main/sessions/sessions.json - History:
~/.openclaw/agents/main/sessions/<session-id>.jsonl
The delete command removes both the metadata entry and the history file.
Use Cases
- Debug stuck sessions - Check which subagents are still running
- Clean up old sessions - Remove completed or timed-out sessions
- Monitor concurrent work - See what subagents are active
- Free resources - Delete sessions that are no longer needed