A robust backup and recovery system for OpenClaw workspace SOUL files featuring versioning and automated validation.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install soul-backup-skill
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 soul-backup-skill 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 SOUL Backup Skill?
The SOUL Backup Skill is a critical utility designed to protect the core configuration files of your AI agent workspace. By targeting essential SOUL files such as agent personalities, user preferences, and tool configurations, this tool ensures that your development environment remains resilient against accidental data loss or corruption.
It provides a structured approach to maintaining workspace integrity, making it an indispensable part of the ecosystem for developers working with Openclaw Skills. The skill handles the complexities of versioning and provides a sanitized backup of configuration files, ensuring that sensitive information like API tokens is redacted while preserving the structural integrity of your setup.
SOUL Backup Skill Use Cases
- Backing up workspace configurations before major refactors or migrations.
- Recovering accidentally deleted SOUL.md or USER.md files.
- Rolling back to a previous stable state after a failed configuration change.
- Automating daily or weekly backups via system cron jobs.
- Ensuring data integrity across multiple Openclaw Skills environments through validation checks.
How SOUL Backup Skill Works
- The backup script identifies core workspace files including SOUL.md, AGENTS.md, and sanitized configuration data.
- A timestamped or named directory is created within the backup folder to store the current state.
- The system generates a manifest.json file containing metadata, file sizes, and SHA-256 checksums for validation.
- Users can list or validate existing backups to ensure consistency across their Openclaw Skills setup.
- During restoration, the skill can perform a dry-run preview or a full recovery, creating an automatic rollback point before applying changes.
SOUL Backup Skill Setup
To get started with this skill within your Openclaw Skills environment, follow these steps:
# Navigate to your workspace directory
cd ~/.openclaw/your-workspace
# Clone the skill repository
git clone https://github.com/X-RayLuan/soul-backup-skill
# Create your first backup
cd soul-backup-skill
node scripts/backup.mjs --name "initial-setup"
SOUL Backup Skill Data Schema & Taxonomy
The skill organizes backups in a structured directory format to ensure easy manual or automated recovery:
| Component | Description |
|---|---|
backups/ |
Root directory containing all timestamped and named backup folders. |
manifest.json |
Metadata including timestamp, workspace path, and SHA-256 file hashes. |
*.md |
Copies of SOUL.md, USER.md, AGENTS.md, IDENTITY.md, TOOLS.md, etc. |
openclaw.sanitized.json |
A copy of the workspace config with sensitive fields (tokens, keys) redacted. |
SOUL Backup Skill Advanced Features
- Automated pre-restore backups to allow for immediate rollbacks if a recovery fails.
- Deep validation scripts that verify SHA-256 hashes and manifest consistency to prevent data corruption.
- Sanitization logic that automatically strips secrets from openclaw.json before storage.
- Support for custom descriptions and naming conventions for easier version tracking within Openclaw Skills.
- Integration hooks for pre-deployment or git-based automation workflows to ensure state is captured before changes.
SKILL.md
Loading
Related Openclaw Skills
GEO Tracker
An automated monitoring tool designed to track and optimize brand presence across major generative search engines.
iMessage Image Sender
A specialized automation tool to send images from a macOS environment directly to mobile devices via iMessage.
images-sender
A macOS-specific automation for seamlessly sending images to phone numbers via the native iMessage application.
Skiplagged Flights (MCP)
A travel intelligence skill that identifies hidden-city flight deals and flexible itineraries using the Skiplagged Model Context Protocol server.
Agent Hardening
A self-contained security testing suite designed to validate an AI agent's input sanitization and defense against common injection attacks.
MoltComm
A decentralized, peer-to-peer protocol enabling secure, signed agent-to-agent communication without central servers.
Featured*
