session-guardian
Never lose a conversation again. Auto-backup, smart recovery, and health monitoring for OpenClaw sessions. Protects against gateway crashes, model disconnections, and token overflow. Use this skill when: - User worries about losing conversations after gateway restart or model crash - User mentions session backup, conversation recovery, session protection, or data loss - User's agent is slow or timing out (likely token overflow from large sessions) - User runs multiple agents and needs to track collaboration across sessions - User asks about session health, backup strategy, or disaster recovery - User mentions "对话丢失", "会话备份", "上下文溢出", "token超限", "Gateway重启后记忆丢失" - Even if user just says "my agent lost everything after a restart" — this is the skill
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/1052326311/session-guardianWhat This Skill Does
Session Guardian is an essential infrastructure utility for OpenClaw users, designed to prevent data loss and maintain agent continuity. It operates as a background supervisor that implements a multi-layered protection protocol for your AI sessions. The core functionality includes incremental auto-backups every five minutes, hourly full-session snapshots, and proactive health monitoring. It specifically targets common failure points such as gateway crashes, model disconnections, and performance degradation caused by token overflow. By running in the background, it ensures that your conversation history is not just stored, but organized through daily smart summaries and knowledge extraction. Whether you are managing complex multi-agent workflows or simply don't want to lose progress during long-running tasks, Session Guardian provides the reliability needed for professional-grade AI operations.
Installation
To get started, ensure you have the clawhub CLI installed. Run the following commands in your terminal:
- Install the package:
clawhub install openclaw/skills/skills/1052326311/session-guardian - Navigate to the installation directory:
cd ~/.openclaw/workspace/skills/session-guardian - Execute the deployment script to initialize cron jobs:
bash scripts/install.sh - Verify the setup by running the status check script:
bash scripts/status.sh
Use Cases
- Disaster Recovery: You have been working on a complex coding task for three hours, and the OpenClaw gateway unexpectedly restarts. With Session Guardian, you can restore your session to the exact state it was in five minutes before the crash.
- Preventing Token Overflow: Your agent has become sluggish because the conversation history is massive. Session Guardian detects the high token count and alerts you to summarize the context before a crash occurs.
- Multi-Agent Orchestration: When running a chain of agents (e.g., Lead Agent to Sub-agents), use the tool to track collaboration and ensure that the memory of the task flow remains intact even if specific model nodes disconnect.
- Session Maintenance: You need a clean way to audit what your agents have learned or produced, utilizing the auto-generated daily knowledge extraction files.
Example Prompts
- "My agent just crashed and I lost everything! Can you restore my session using Session Guardian?"
- "Check the health of my current session—is there a risk of token overflow with the current conversation history?"
- "I noticed the agent is slowing down. Can you perform a recovery check and show me the latest backup status?"
Tips & Limitations
- Minimal Overhead: The skill is designed to be lightweight, consuming roughly 10-15k tokens/day and 1-2MB of storage per agent/month.
- Regular Checks: We recommend running
status.shat least once a week to ensure all cron jobs are firing correctly, especially after system updates. - Privacy: While this tool performs file-read and file-write operations to manage your backups, your data stays locally within your OpenClaw workspace; it does not transmit session data to third-party servers.
Metadata
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 skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-1052326311-session-guardian": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-write, file-read