Session Cleaner

Clean up OpenClaw sessions and reset to a clean state. This skill handles:

Closing all sub-agent sessions
Clearing current context
Killing background processes
Resetting the system

Triggers (Keywords)

English:

"close all sessions"
"kill all agents"
"clear context"
"clean up sessions"
"reset everything"
"start fresh"
"wipe everything"

Chinese:

"关掉所有子agent"
"关闭所有会话"
"清空上下文"
"关闭所有session"
"清理会话"
"重置系统"
"重新开始"
"全部关掉"

Usage

Quick Cleanup (Keep Current Session)

# 1. List all sessions
openclaw sessions list

# 2. Stop Gateway
pkill -9 -f "openclaw-gateway"

# 3. Clean sessions.json (Python script)
python3 ~/clawd/skills/session-cleaner/scripts/clean_sessions.py

# 4. Restart Gateway
openclaw gateway start

Full Reset (Including Current Session)

# User should send: /new
# Then run the cleanup above

Manual Steps

Step 1: Check Current Sessions

openclaw sessions list

Step 2: Stop Gateway (kills all session processes)

pkill -9 -f "openclaw-gateway"

Step 3: Clean Session Registry

python3 ~/clawd/skills/session-cleaner/scripts/clean_sessions.py

Step 4: Restart Gateway

openclaw gateway start

Step 5: Clear Current Context (User Action)

Tell user to send: /new or /reset

Important Notes

Always backup sessions.json before cleaning
Current session is preserved by default (agent:main:main)
Sub-agents, cron jobs, group chats are all cleaned
Gateway restart is required to fully clear memory
Context reset (/new) is a separate user action

Safety Checklist

Backup sessions.json
Confirm with user before destructive operations
Preserve current session unless user says "clear everything"
Restart Gateway after cleaning
Instruct user to send /new for context reset

Examples

Example 1: Clean all other sessions

User: "关掉所有子agent"
Agent: "正在清理... [执行 cleanup 脚本]"

Example 2: Full reset

User: "重置所有，包括当前会话"
Agent: "确认？这将清除所有历史。[用户确认后执行]"

Files

scripts/clean_sessions.py - Python script to clean sessions.json
SKILL.md - This documentation

Version

v1.0.0 - Initial release

session-cleaner

Safety Notice

Copy this and send it to your AI assistant to learn