OpenSkillIndex← back to search
claude-codeopenclawautomation

Skills 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.

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/6eanut/sessions-manager" ~/.claude/skills/openclaw-skills-sessions-manager && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/6eanut/sessions-manager" ~/.openclaw/skills/openclaw-skills-sessions-manager && rm -rf "$T"
manifest: skills/6eanut/sessions-manager/SKILL.md
tags
#session-management#cli#agent-control#debugging#automation
source content

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

  1. Debug stuck sessions - Check which subagents are still running
  2. Clean up old sessions - Remove completed or timed-out sessions
  3. Monitor concurrent work - See what subagents are active
  4. Free resources - Delete sessions that are no longer needed