openclaw-backup
Encrypted backup and restore for OpenClaw Agent workspace files (SOUL.md, MEMORY.md, IDENTITY.md, AGENTS.md, TOOLS.md). Uses tar + openssl (AES-256-CBC) encryption and soul-upload.com API. Auto-generates a new random password for each backup (DO NOT reuse passwords). Use when the user needs to: (1) Back up or upload agent workspace files, (2) Restore or download a previous backup, (3) Delete a backup from remote storage, or (4) Manage encrypted agent persistence.
Security Assessment
Detected risks:
About openclaw-backup
The OpenClaw Backup skill provides a secure and automated solution for backing up and restoring workspace files of OpenClaw agents. It addresses the critical need for encrypted persistence of agent data, ensuring that sensitive information such as agent identity, memory, configuration, and tools are safely stored and can be reliably restored. By integrating file archiving and encryption tools, this skill protects agent data against accidental loss, corruption, or unauthorized access, making workspace management safer and more efficient for users who rely on OpenClaw agents for complex tasks.
The skill offers three main capabilities: uploading backups, downloading and decrypting backups, and deleting backups from remote storage. Each backup operation uses AES-256-CBC encryption via OpenSSL and generates a unique 32-character password automatically, eliminating the risk of password reuse. Users can specify which files to back up, or rely on a default set of workspace files including SOUL.md, MEMORY.md, IDENTITY.md, AGENTS.md, and TOOLS.md. During the upload process, the skill captures metadata such as backup ID, download URL, file size, SHA256 hash, and the generated password, storing this information in a recovery file for future reference. This ensures that even if a backup needs to be restored long after creation, all necessary credentials and identifiers are preserved.
This skill is particularly useful for developers, researchers, and AI practitioners who work with OpenClaw agents and require secure, versioned storage of agent workspaces. Typical use cases include routine workspace backups, migrating agent configurations between environments, restoring data after accidental deletion, and managing encrypted persistence for long-term projects. Its automation reduces the manual overhead associated with encryption and remote uploads, while maintaining a high level of security and traceability for sensitive agent files.
FAQ
Which files are backed up by default?
By default, the skill backs up SOUL.md, MEMORY.md, IDENTITY.md, AGENTS.md, and TOOLS.md. Users can also specify additional files to include in the backup.
What encryption method does the skill use?
All backups use AES-256-CBC encryption via OpenSSL, and each backup generates a unique 32-character random password.
What are the system requirements to run this skill?
The skill requires Python 3.7 or higher, the requests library, tar, openssl, and curl. These tools must be installed before executing backup operations.
How is the generated password stored?
The auto-generated password for each backup is stored in the recovery file named .openclaw-backup-recovery.txt. This file is critical for restoring backups.
Can backups be deleted from the remote storage?
Yes, the skill provides functionality to delete backups from soul-upload.com using the backup ID.
Install openclaw-backup
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
theagentservice/skills