← Back to Skills Marketplace
831
Downloads
0
Stars
2
Active Installs
6
Versions
Install in OpenClaw
/install safe-backup
Description
Backup OpenClaw state directory and workspace. Includes excluding sensitive files, packaging for backup. Triggered when user asks to backup, export, or save...
Usage Guidance
This skill appears to do what it says, but before installing or running: 1) verify rsync and tar are available on your environment (Windows may need Git Bash/MSYS/WSL); 2) review the generated tarball contents before uploading anywhere — the script excludes many sensitive patterns but you should still inspect the archive; 3) encrypt backups before storing in the cloud or a repo; 4) be aware auth-profiles.json and other credential files are intentionally excluded and you will need to re-authenticate services after restore; and 5) if you want automated remote upload, implement it separately and review its access requirements (this script does not perform remote uploads itself).
Capability Analysis
Type: OpenClaw Skill
Name: safe-backup
Version: 1.0.5
The 'safe-backup' skill is designed to securely back up OpenClaw state and workspace directories. Both the `SKILL.md` documentation and the `scripts/backup.sh` script explicitly define and implement extensive exclusion patterns for sensitive files such as API keys, credentials, environment variables, and SSH keys. The `backup.sh` script performs only local file system operations (copying with `rsync`, archiving with `tar`, and cleaning up temporary files) and does not initiate any network connections or data exfiltration. While `SKILL.md` suggests optional manual steps for storing backups to remote locations (e.g., private GitHub repositories or remote rsync servers), these are presented as post-backup user actions with security best practices (encryption, private repos) and are not part of the automated script's execution. There is no evidence of malicious intent, obfuscation, or prompt injection designed to compromise the agent or exfiltrate data.
Capability Assessment
Purpose & Capability
The name/description match the code and SKILL.md: the script copies ~/.openclaw and workspace, excludes sensitive patterns, and packages a tar.gz. The guidance about storing or pushing backups is advisory only and not automated.
Instruction Scope
Runtime instructions and the script operate on local filesystem paths and temporary directories and only produce a local tarball. The script reads optional environment variables OPENCLAW_STATE_DIR and OPENCLAW_WORKSPACE_DIR (not declared in metadata) and relies on standard commands (rsync, tar). It does not upload data or transmit secrets by itself, but it instructs the user how to push to a remote repo (manual steps).
Install Mechanism
No install spec (instruction-only with a shipped script) — low risk. The script uses standard system tools (rsync, tar). Note: rsync is assumed available but may be absent on some Windows setups; SKILL.md calls this out.
Credentials
The skill declares no required credentials or env vars, which is appropriate. The script optionally respects OPENCLAW_STATE_DIR and OPENCLAW_WORKSPACE_DIR and uses $HOME/$TMPDIR/$TEMP — reasonable for locating files. No secrets are requested or written by the skill. Users should note that excluded files (e.g., auth-profiles.json) are intentionally not backed up and must be re-authenticated after restore.
Persistence & Privilege
The skill is not forced-always, does not modify other skills or global agent settings, and does not persist credentials. Autonomous invocation is allowed (platform default) but the skill's actions are local and user-invocable.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install safe-backup - After installation, invoke the skill by name or use
/safe-backup - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.5
- Added comprehensive cross-platform and migration documentation, including Windows and macOS support details.
- Clarified temporary file locations for Linux, macOS, and Windows environments in backup output examples.
- Expanded and documented the list of excluded files/directories to improve backup security and avoid sensitive/cache files.
- Provided detailed migration checklist and platform-specific instructions for backup and restore on Git Bash, WSL, Linux, and macOS.
- Improved instructions for verifying and locating backup files, making workflows clearer for both regular backups and migrations.
v1.0.4
No changes in this release.
- Version bumped to 1.0.4 with no file changes detected.
- Functionality and documentation remain unchanged from the previous version.
v1.0.3
Version 1.0.3 of safe-backup contains no detected file changes.
- No updates, bugfixes, or documentation changes were made in this version.
- All functionality and usage remains the same as previous release.
v1.0.2
Version 1.0.2 of safe-backup
- No file changes detected from the previous version.
- Documentation content in SKILL.md remains unchanged.
v1.0.1
- Major documentation overhaul to improve clarity, safety, and backup/restore instructions.
- Added comprehensive security warnings and highlighted excluded highly sensitive files (auth, credentials).
- Detailed backup and storage workflows, including options for encryption and private GitHub repositories.
- Step-by-step restore process now covers authentication reconfiguration due to excluded credentials.
- Introduced environment variables and troubleshooting section for easier customization and support.
- Outlined best backup practices for safety and reliability.
v1.0.0
Initial release of safe-backup skill:
- Enables backup of OpenClaw state directory and workspace.
- Excludes log files and session data for privacy.
- Packages selected data for backup and integrates with GitHub workflows.
- Provides step-by-step instructions for backup, excluding sensitive files, and restoring state.
Metadata
Frequently Asked Questions
What is safe-backup?
Backup OpenClaw state directory and workspace. Includes excluding sensitive files, packaging for backup. Triggered when user asks to backup, export, or save... It is an AI Agent Skill for Claude Code / OpenClaw, with 831 downloads so far.
How do I install safe-backup?
Run "/install safe-backup" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is safe-backup free?
Yes, safe-backup is completely free (open-source). You can download, install and use it at no cost.
Which platforms does safe-backup support?
safe-backup is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created safe-backup?
It is built and maintained by AIWareTop (@hacksing); the current version is v1.0.5.
More Skills