Session Guardian 🛡️

Your Conversation Guardian - Enterprise-grade session backup + project management solution

Problem Statement

🔴 Model disconnections - Conversations lost, work wasted
🔴 Gateway restarts - Forgot what you were doing, task state lost
🔴 Cross-channel confusion - Private info sent to group chat, or vice versa
🔴 Complex task tracking - Tasks span multiple sessions, hard to track state
🔴 Multi-agent chaos - Multiple agents working simultaneously, unclear who's doing what
🔴 Large session files - Causing timeouts, slow responses, high token consumption

Quick Start

# Install
clawhub install session-guardian

# One-click deployment (auto-configure all cron jobs)
cd ~/.openclaw/workspace/skills/session-guardian
bash scripts/install.sh

# Verify
crontab -l | grep session-guardian
openclaw cron list

Use Cases

Scenario 1: Enterprise Multi-Agent Collaboration

Typical User: Enterprise teams with multiple agents working together

Example:

Main agent → Dev team lead → UI designer + Full-stack developer
Main agent → Finance team lead → Strategy research + Risk control + Execution
Main agent → Operations team lead → Content creation + Data analysis

Benefits:

✅ Collaboration tracking: Visualize task flow
✅ Collaboration health: Monitor team collaboration quality
✅ Knowledge base: Accumulate team best practices

Scenario 2: Personal Assistant Team

Typical User: Individual users with multiple specialized assistants

Example:

Research assistant: Find resources, organize literature
Coding assistant: Write code, debug issues
Writing assistant: Write articles, polish copy
Translation assistant: Multi-language translation

Benefits:

✅ Smart backup: Protect each assistant's memory
✅ Knowledge extraction: Each assistant accumulates expertise
✅ Collaboration tracking: Know which assistant has the task

Scenario 3: Single-Agent Deep Usage

Typical User: Users with one main agent

Example:

Personal AI assistant: Handle all daily tasks
Professional consultant: Deep conversations, long-term memory

Benefits:

✅ Smart backup: Prevent conversation loss
✅ Knowledge extraction: Accumulate personal best practices
✅ Task management: Track complex task states

Scenario 4: Enterprise Multi-Department Collaboration

Typical User: Enterprises with agents in different departments

Example:

Sales agent: Customer management, opportunity tracking
Support agent: Issue handling, ticket management
Tech agent: Technical support, troubleshooting
Finance agent: Report generation, data analysis

Benefits:

✅ Session isolation: Prevent cross-department information leakage
✅ Collaboration health: Monitor cross-department collaboration

Core Features

1. Five-Layer Protection System

Layer 1: Incremental Backup (Every 5 minutes)

Auto-backup new conversations
Minimal storage, fast recovery
Supports all agent sessions

Layer 2: Snapshot Backup (Every 1 hour)

Complete session snapshots
Version control, rollback support
Automatic cleanup of old versions

Layer 3: Smart Summary (Daily)

Extract key information from conversations
Auto-update MEMORY.md
Generate collaboration summaries

Layer 4: Health Check (Every 6 hours)

Monitor session file size
Detect abnormal token consumption
Alert on collaboration issues

Layer 5: Project Management

Task state tracking
Milestone management
Progress reports

2. Multi-Agent Collaboration Features (v2.0)

Collaboration Tracking

Visualize task flow: King → Team Lead → Members
Record collaboration links
Generate collaboration reports

Smart Backup Strategy

High-frequency agents: More frequent backups
Low-frequency agents: Reduce backup frequency
Save storage and token consumption

Knowledge Base Extraction

Extract best practices from conversations
Auto-update AGENTS.md
Generate FAQ

Collaboration Health Scoring

Communication efficiency
Task completion rate
Response time
Collaboration quality

3. Integration with Self-Improving-Agent

Complementary Design:

Session Guardian: Macro perspective, overall progress
Self-Improving-Agent: Micro perspective, specific issues

Workflow:

Self-Improving-Agent records errors and learnings in real-time (lightweight)
Session Guardian reads SI records during daily summary
Session Guardian extracts knowledge to MEMORY.md
Avoid duplicate analysis

Token Savings:

Before: ~30k tokens/day
After: ~10.5k tokens/day
Save 65% tokens

Installation

Method 1: ClawHub (Recommended)

clawhub install session-guardian

Method 2: Manual Installation

# Clone repository
git clone https://github.com/1052326311/session-guardian.git ~/.openclaw/workspace/skills/session-guardian

# Run installation script
cd ~/.openclaw/workspace/skills/session-guardian
bash scripts/install.sh

Method 3: npm Installation

npm install -g @openclaw/session-guardian

Configuration

Basic Configuration

Edit ~/.openclaw/workspace/skills/session-guardian/config.json:

{
  "backup": {
    "incremental": {
      "enabled": true,
      "interval": 5,
      "retention": 7
    },
    "snapshot": {
      "enabled": true,
      "interval": 60,
      "retention": 30
    }
  },
  "summary": {
    "enabled": true,
    "schedule": "0 0 * * *"
  },
  "healthCheck": {
    "enabled": true,
    "interval": 6
  },
  "collaboration": {
    "tracking": true,
    "healthScore": true
  },
  "integration": {
    "selfImprovingAgent": {
      "enabled": true,
      "readLearnings": true
    }
  }
}

Advanced Configuration

Custom Backup Path

{
  "backup": {
    "path": "/custom/backup/path"
  }
}

Agent-Specific Settings

{
  "agents": {
    "main": {
      "backup": {
        "interval": 3
      }
    },
    "dev-lead": {
      "backup": {
        "interval": 10
      }
    }
  }
}

Usage

Manual Backup

# Backup all sessions
openclaw skill run session-guardian backup

# Backup specific agent
openclaw skill run session-guardian backup --agent main

Manual Summary

# Generate daily summary
openclaw skill run session-guardian summary

# Generate weekly summary
openclaw skill run session-guardian summary --weekly

Health Check

# Run health check
openclaw skill run session-guardian health-check

# View health report
cat ~/.openclaw/workspace/Assets/SessionBackups/health-reports/latest.md

Restore Session

# List available backups
openclaw skill run session-guardian list-backups

# Restore from backup
openclaw skill run session-guardian restore --backup 2026-03-06-10-00

File Structure

~/.openclaw/workspace/
├── skills/
│   └── session-guardian/
│       ├── SKILL.md                    # This file
│       ├── config.json                 # Configuration
│       ├── scripts/
│       │   ├── install.sh              # Installation script
│       │   ├── incremental-backup.sh   # Incremental backup
│       │   ├── snapshot-backup.sh      # Snapshot backup
│       │   ├── daily-summary.sh        # Daily summary
│       │   ├── health-check.sh         # Health check
│       │   ├── collaboration-tracker.sh # Collaboration tracking
│       │   └── knowledge-extractor.sh  # Knowledge extraction
│       └── templates/
│           ├── summary.md              # Summary template
│           └── health-report.md        # Health report template
└── Assets/
    └── SessionBackups/
        ├── incremental/                # Incremental backups
        ├── snapshots/                  # Snapshot backups
        ├── summaries/                  # Daily summaries
        ├── health-reports/             # Health reports
        └── collaboration/              # Collaboration data

Cron Jobs

After installation, the following cron jobs are automatically configured:

# Incremental backup (every 5 minutes)
*/5 * * * * cd ~/.openclaw/workspace/skills/session-guardian && bash scripts/incremental-backup.sh

# Snapshot backup (every hour)
0 * * * * cd ~/.openclaw/workspace/skills/session-guardian && bash scripts/snapshot-backup.sh

# Daily summary (midnight)
0 0 * * * cd ~/.openclaw/workspace/skills/session-guardian && bash scripts/daily-summary.sh

# Health check (every 6 hours)
0 */6 * * * cd ~/.openclaw/workspace/skills/session-guardian && bash scripts/health-check.sh

# Collaboration tracking (every 30 minutes)
*/30 * * * * cd ~/.openclaw/workspace/skills/session-guardian && bash scripts/collaboration-tracker.sh

Best Practices

1. Regular Monitoring

Check health reports weekly
Review collaboration health scores
Monitor token consumption

2. Backup Management

Keep 7 days of incremental backups
Keep 30 days of snapshots
Archive important conversations

3. Knowledge Extraction

Review daily summaries
Update MEMORY.md regularly
Share best practices with team

4. Integration with Other Skills

Use with self-improving-agent for error learning
Use with project management tools
Integrate with notification systems

Troubleshooting

Backup Not Running

# Check cron jobs
crontab -l | grep session-guardian

# Check logs
tail -f ~/.openclaw/workspace/skills/session-guardian/logs/backup.log

Large Session Files

# Run health check
openclaw skill run session-guardian health-check

# View recommendations
cat ~/.openclaw/workspace/Assets/SessionBackups/health-reports/latest.md

Missing Summaries

# Manually generate summary
openclaw skill run session-guardian summary

# Check summary logs
tail -f ~/.openclaw/workspace/skills/session-guardian/logs/summary.log

Performance

Token Consumption

Incremental backup: ~100 tokens/run
Snapshot backup: ~500 tokens/run
Daily summary: ~5k tokens/run (with SI integration: ~8k)
Health check: ~200 tokens/run
Collaboration tracking: ~300 tokens/run

Total: ~10-15k tokens/day (with SI integration)

Storage

Incremental backup: ~10KB/session/day
Snapshot backup: ~100KB/session/day
Summaries: ~5KB/day
Health reports: ~2KB/report

Total: ~1-2MB/agent/month

Roadmap

v2.1 (Planned)

Web dashboard for visualization
Real-time collaboration monitoring
Advanced analytics
Custom alert rules

v2.2 (Planned)

Cloud backup support
Team collaboration features
API for third-party integration
Mobile app

Contributing

Contributions are welcome! Please:

Fork the repository
Create a feature branch
Submit a pull request

License

MIT License - see LICENSE file for details

Support

GitHub: https://github.com/1052326311/session-guardian
Issues: https://github.com/1052326311/session-guardian/issues
ClawHub: https://clawhub.com/session-guardian

Changelog

v2.0.0 (2026-03-05)

✨ Added collaboration tracking
✨ Added smart backup strategy
✨ Added knowledge extraction
✨ Added collaboration health scoring
✨ Integration with self-improving-agent
🐛 Fixed session isolation issues
📝 Improved documentation

v1.0.0 (2026-03-01)

🎉 Initial release
✨ Five-layer protection system
✨ Multi-agent support
✨ Project management features

中文版 / Chinese Version

核心功能

1. 五层防护体系

第1层：增量备份（每5分钟）

自动备份新对话
存储占用小，恢复快
支持所有agent的session

第2层：快照备份（每1小时）

完整session快照
版本控制，支持回滚
自动清理旧版本

第3层：智能总结（每天）

从对话中提取关键信息
自动更新MEMORY.md
生成协作总结

第4层：健康检查（每6小时）

监控session文件大小
检测异常token消耗
协作问题预警

第5层：项目管理

任务状态追踪
里程碑管理
进度报告

2. 多智能体协作功能（v2.0）

协作链路追踪

可视化任务流转：King → 团长 → 成员
记录协作链路
生成协作报告

智能备份策略

高频agent：更频繁备份
低频agent：降低备份频率
节省存储和token消耗

知识库沉淀

从对话中提取最佳实践
自动更新AGENTS.md
生成FAQ

协作健康度评分

沟通效率
任务完成率
响应时间
协作质量

3. 与Self-Improving-Agent集成

互补设计：

Session Guardian：宏观视角，看整体进展
Self-Improving-Agent：微观视角，看具体问题

工作流：

Self-Improving-Agent实时记录错误和学习（轻量级）
Session Guardian每日总结时读取SI记录
Session Guardian提取知识到MEMORY.md
避免重复分析

Token节省：

优化前：~30k tokens/天
优化后：~10.5k tokens/天
节省65% tokens

安装

方法1：ClawHub（推荐）

clawhub install session-guardian

方法2：手动安装

# 克隆仓库
git clone https://github.com/1052326311/session-guardian.git ~/.openclaw/workspace/skills/session-guardian

# 运行安装脚本
cd ~/.openclaw/workspace/skills/session-guardian
bash scripts/install.sh

配置

编辑 ~/.openclaw/workspace/skills/session-guardian/config.json:

{
  "backup": {
    "incremental": {
      "enabled": true,
      "interval": 5,
      "retention": 7
    },
    "snapshot": {
      "enabled": true,
      "interval": 60,
      "retention": 30
    }
  },
  "summary": {
    "enabled": true,
    "schedule": "0 0 * * *"
  },
  "healthCheck": {
    "enabled": true,
    "interval": 6
  },
  "collaboration": {
    "tracking": true,
    "healthScore": true
  },
  "integration": {
    "selfImprovingAgent": {
      "enabled": true,
      "readLearnings": true
    }
  }
}

使用

手动备份

# 备份所有session
openclaw skill run session-guardian backup

# 备份特定agent
openclaw skill run session-guardian backup --agent main

手动总结

# 生成每日总结
openclaw skill run session-guardian summary

# 生成每周总结
openclaw skill run session-guardian summary --weekly

健康检查

# 运行健康检查
openclaw skill run session-guardian health-check

# 查看健康报告
cat ~/.openclaw/workspace/Assets/SessionBackups/health-reports/latest.md

性能

Token消耗

增量备份：~100 tokens/次
快照备份：~500 tokens/次
每日总结：~5k tokens/次（集成SI后：~8k）
健康检查：~200 tokens/次
协作追踪：~300 tokens/次

总计：~10-15k tokens/天（集成SI后）

存储

增量备份：~10KB/session/天
快照备份：~100KB/session/天
总结：~5KB/天
健康报告：~2KB/报告

总计：~1-2MB/agent/月

支持

GitHub: https://github.com/1052326311/session-guardian
Issues: https://github.com/1052326311/session-guardian/issues
ClawHub: https://clawhub.com/session-guardian

更新日志

v2.0.0 (2026-03-05)

✨ 新增协作链路追踪
✨ 新增智能备份策略
✨ 新增知识库沉淀
✨ 新增协作健康度评分
✨ 集成self-improving-agent
🐛 修复session隔离问题
📝 改进文档

v1.0.0 (2026-03-01)

🎉 首次发布
✨ 五层防护体系
✨ 多智能体支持
✨ 项目管理功能