← Back to Skills Marketplace
Session Guardian — Never Lose a Conversation Again
by
1052326311
· GitHub ↗
· v3.1.0
· MIT-0
615
Downloads
1
Stars
1
Active Installs
8
Versions
Install in OpenClaw
/install session-guardian
Description
Never lose a conversation again. Auto-backup, smart recovery, and health monitoring for OpenClaw sessions. Protects against gateway crashes, model disconnect...
Usage Guidance
What to check before installing:
1) Inspect scripts/install.sh and scripts/*.sh yourself (or with a trusted admin) before running — install.sh will add cron jobs that run frequently and will read all session files under ~/.openclaw/agents.
2) Open and edit config.sh defaults before deployment:
- Set DELIVERY_ENABLED=false (default is true) if you do not want any automatic push of summaries/backups to chat channels or external endpoints.
- Ensure REMOTE_SYNC_ENABLED=false unless you deliberately want to sync backups to a remote host; if you do, provide and verify credentials securely.
- If you want backups encrypted, set ENCRYPTION_ENABLED=true and configure GPG_KEY_ID before running.
- If you do not want token/LLM usage, disable KNOWLEDGE_EXTRACTION_ENABLED and any SUMMARY_MODEL settings (SKILL.md's "zero token cost" claim is inconsistent with these enabled defaults).
3) Confirm required system tools are present (jq, rsync or rclone, gzip/pigz, cron) — the package scripts use jq and rsync-like behavior but the skill metadata declares no required binaries.
4) Run installation in a safe environment or test account first (to confirm behavior and verify no unintended pushes or remote syncs occur).
5) Audit the backup directory permissions (~/.openclaw/workspace/Assets/SessionBackups) and logs after a test run; verify backups are stored where you expect and not transmitted externally.
6) If you need stronger guarantees, ask the maintainer for minimal configuration examples that explicitly disable delivery/remote sync and LLM calls, and for a signed release or repository URL to verify provenance.
Capability Analysis
Type: OpenClaw Skill
Name: session-guardian
Version: 3.1.0
The session-guardian skill bundle is a comprehensive backup and monitoring utility that requires high-risk capabilities, including broad read access to all agent session logs (conversation history) and modification of the system crontab for persistence (install.sh). It also contains potential shell injection vulnerabilities in scripts like plan-manager.sh and install.sh, where un-sanitized variables are used in sed or eval commands. While these behaviors are aligned with the stated purpose of protecting session data and monitoring agent health, the combination of system-level modifications and access to sensitive data warrants a cautious classification.
Capability Assessment
Purpose & Capability
The declared purpose (local backups, snapshots, health checks) matches the included scripts that read ~/.openclaw/agents/*/sessions and create local backups. However the repo also includes delivery/remote-sync/summary configuration (DELIVERY_ENABLED=true, REMOTE_SYNC_* options, SUMMARY_MODEL, KNOWLEDGE_EXTRACTION_ENABLED=true) that extend beyond pure local backups. SKILL.md claims "All backups stay local" and "Zero Token Cost", but config and scripts enable push/summary/extraction features that can call models or push data to external channels — this is an incoherence between claimed purpose and default capabilities.
Instruction Scope
SKILL.md instructs running install.sh which will configure cron jobs and run scripts that read all agent session files (~/.openclaw/agents/*/sessions). The instructions claim backups are local and non-networked, yet config.sh contains delivery and remote-sync settings and templates for SUMMARY_PROMPT_TEMPLATE and SUMMARY_MODEL (which imply LLM usage). The runtime instructions do not call out that daily summaries / knowledge extraction / delivery may send conversation data outside the machine if those features are enabled.
Install Mechanism
No external download/install spec is declared and scripts are included in the package (no network fetch of arbitrary code). install.sh (present in repo) will modify crontab/OpenClaw cron and create directories under ~/.openclaw/workspace/skills/session-guardian and Assets/SessionBackups. This is expected for a backup tool but you should inspect install.sh before running because it will create scheduled jobs that run frequently (every 5 minutes / hourly / daily).
Credentials
Registry metadata lists no required env vars or credentials, but config.sh defines many optional external integration fields (ALERT_WEBHOOK, REMOTE_RSYNC_HOST/USER/PATH, REMOTE_RCLONE_REMOTE, DELIVERY_CHANNEL/TARGET, GPG_KEY_ID, SUMMARY_MODEL). Defaults enable DELIVERY_ENABLED=true and KNOWLEDGE_EXTRACTION_ENABLED=true and set SUMMARY_MODEL to an external model name — meaning sensitive conversation content could be routed or summarized by external services if the defaults are left as-is. Additionally, scripts rely on tools (jq, rsync, gzip/pigz, find, cron) but the skill declares no required binaries — a mismatch that may cause failures or hidden behavior.
Persistence & Privilege
The skill does not request 'always: true' and uses standard cron for persistence; that is expected for a backup tool. It will gain ongoing presence via scheduled jobs and access to all agent session directories under the user's home, which is proportional to its stated goal but increases blast radius (frequent automated reads of all sessions).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install session-guardian - After installation, invoke the skill by name or use
/session-guardian - Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.1.0
v3.1.0: Complete SKILL.md rewrite (16KB→8KB), bilingual EN+CN, concise ClawHub-optimized format, fixed health-check auto-modify bug, removed hardcoded model names
v3.0.0
v3.0.0: AI-powered intelligent compaction with personalized token thresholds (55-70%). 30-50% token savings. Complete English description rewrite for better discoverability.
v2.0.1
English version with Chinese translation. Integration with self-improving-agent. Save 65% tokens.
v2.0.0
v2.0.0: Multi-Agent Collaboration Management - New features: Collaboration tracking, Smart backup strategy, Knowledge extraction, Collaboration health scoring. Fully backward compatible with v1.0.
v1.0.3
Fix: Update contact info (Email: [email protected], WeChat: sixsixsix_666-). Remove old contact info.
v1.0.2
Add bilingual support (English + Chinese). Use English as default for international audience. 新增中英文双语支持,默认使用英文面向国际用户。
v1.0.1
优化介绍和文档结构,突出使用场景和痛点解决方案。更新联系方式。
v1.0.0
首次发布:企业级对话备份 + 项目管理解决方案。解决模型掉线对话丢失、Gateway重启任务丢失、跨渠道混淆、复杂任务难追踪等痛点。五层防护:增量备份、快照、智能总结、健康检查、项目管理。
Metadata
Frequently Asked Questions
What is Session Guardian — Never Lose a Conversation Again?
Never lose a conversation again. Auto-backup, smart recovery, and health monitoring for OpenClaw sessions. Protects against gateway crashes, model disconnect... It is an AI Agent Skill for Claude Code / OpenClaw, with 615 downloads so far.
How do I install Session Guardian — Never Lose a Conversation Again?
Run "/install session-guardian" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Session Guardian — Never Lose a Conversation Again free?
Yes, Session Guardian — Never Lose a Conversation Again is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Session Guardian — Never Lose a Conversation Again support?
Session Guardian — Never Lose a Conversation Again is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Session Guardian — Never Lose a Conversation Again?
It is built and maintained by 1052326311 (@1052326311); the current version is v3.1.0.
More Skills