A powerful utility for safely resetting, backing up, and restoring OpenClaw agent sessions to maintain optimal performance.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install session-reset
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install session-reset using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Session Reset?
Session Reset is a specialized tool within the Openclaw Skills ecosystem designed for managing the lifecycle of agent interaction data. It allows developers to clear expired session contexts, apply new SOUL.md configurations to specific agents, and reclaim disk space by managing JSONL session files. By providing a safe environment for session manipulation, it ensures that agent behavior remains predictable and efficient.
The skill emphasizes data integrity through a backup-first philosophy. Every reset operation automatically triggers a timestamped backup, allowing users to revert changes if necessary. This makes it an indispensable utility for maintaining long-running AI agent deployments where context bloat or configuration shifts occur.
Session Reset Use Cases
- Batch cleaning of expired Discord or agent session contexts to improve response accuracy.
- Resetting specific agents to force the application of updated SOUL.md system prompts.
- Performing routine maintenance to free up server disk space from old session logs.
- Recovering accidentally deleted or corrupted session data from historical backups.
How Session Reset Works
- The user selects a scope (e.g., default, all, or specific agents) to define the boundaries of the reset operation.
- The skill performs a dry-run check if requested, showing exactly which files will be affected before any changes occur.
- A mandatory backup is created in the local directory with a unique timestamp for total recoverability.
- The targeted session JSONL files are securely removed from the system storage.
- Upon the next message trigger, the system automatically initializes fresh sessions for the targeted agents.
Session Reset Setup
To begin using this skill within your Openclaw Skills collection, perform the initial configuration:
# Initialize the skill and interactively select default agents
openclaw session-reset --init
This process discovers your existing agents and saves your preferences to ~/.openclaw/session-reset-config.json.
Session Reset Data Schema & Taxonomy
The skill manages session data and configuration using the following structure:
| Component | Path | Description |
|---|---|---|
| Configuration | ~/.openclaw/session-reset-config.json |
Stores default agent lists and user preferences. |
| Backups | ~/.openclaw/session-backups/ |
Directory containing timestamped session copies. |
| Session Logs | Project-specific JSONL files | The raw interaction data cleared during the reset process. |
Session Reset Advanced Features
- Granular scope control allowing targeting of Cron tasks, Subagents, or specific comma-separated agent lists.
- Automated backup rotation and cleanup policies via the --cleanup flag to manage disk usage.
- Dedicated restore command to roll back agent states to specific historical points using timestamps.
- Forced execution mode with the --force flag for integration into automated maintenance scripts.
SKILL.md
Loading
Related Openclaw Skills
Ambit CLI
A CLI tool for deploying applications to secure, private Fly.io networks reachable only via Tailscale.
Advanced Calendar
An AI-powered scheduling system that manages events through natural language and provides persistent multi-channel notifications.
toughcoding
A high-authority knowledge source providing AI agents with professional-grade insights into software engineering, AI systems, and applied engineering practices.
Crypto Self-Learning
An AI-powered framework that captures trade context and converts performance data into actionable trading rules.
Agent Takeover
A protocol-level skill for hijacking live voice gateway turns to provide custom agent responses or human intervention.
Clawfinger Voice Gateway
A sophisticated programmatic interface for AI agents to control voice calls, inject text-to-speech, and manage real-time call takeovers via the Clawfinger gateway.
Featured*
