Back to Registry View Author Profile
Official Verified
sessions-manager
Manage OpenClaw agent sessions - list active/completed sessions, view session details, and delete sessions by ID. Use when you need to inspect session state, clean up old sessions, or manage multiple concurrent sessions.
skill-install — Terminal
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/6eanut/sessions-managerOr
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
Metadata
AI Skill Finder
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skill Add to Configuration
Paste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-6eanut-sessions-manager": {
"enabled": true,
"auto_update": true
}
}
}Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.