← Back to Skills Marketplace
x-rayluan

OpenClaw Backup & Restore

by X-RayLuan · GitHub ↗ · v1.5.4 · MIT-0
cross-platform ⚠ suspicious
353
Downloads
1
Stars
0
Active Installs
6
Versions
Install in OpenClaw
/install openclaw-workspace-backup-restore
Description
This skill should be used when the user asks for OpenClaw backup, restore, rollback, validation, GitHub backup, off-machine backup, workspace recovery, or pr...
Usage Guidance
This skill appears to do what it claims, but take these precautions before installing or enabling automation: 1) Inspect scripts/backup-and-push.mjs and scripts/backup.mjs yourself — search for any network endpoints, unexpected HTTP/HTTPS requests, or obfuscated code. 2) Verify the openclaw.json sanitization logic (patterns listed in CHANGELOG) and test backups to ensure secrets are redacted; avoid using --raw-openclaw-config unless you understand the consequences. 3) Do not push backups to a public GitHub repo; use a private repo or encrypted/off-machine storage. 4) Check package.json for added dependencies before running. 5) Run backups and validate in a safe environment (local VM or disposable workspace) and confirm validate.mjs detects corruption and redaction as promised. 6) Ensure backups/ directory permissions are restrictive (700) and consider encrypting backups at rest. 7) Note the minor documentation tension: .gitignore is said to exclude backups/ yet the skill documents scripts to add/push backups — decide whether you will track backups in git. If you want to proceed, test manual runs first and only enable cron/GitHub Actions after confirming sanitization and repository privacy.
Capability Analysis
Type: OpenClaw Skill Name: openclaw-workspace-backup-restore Version: 1.5.4 This skill bundle provides a comprehensive and professional-grade backup and restore utility for OpenClaw workspaces. It includes scripts for creating timestamped backups (scripts/backup.mjs), listing them (scripts/list.mjs), validating integrity via SHA-256 hashes (scripts/validate.mjs), and restoring files with automatic safety rollbacks (scripts/restore.mjs). It also features a remote synchronization script (scripts/backup-and-push.mjs) that pushes backups to a user-configured Git repository. While the tool handles sensitive configuration files like openclaw.json, it includes a robust sanitization mechanism to redact API keys and tokens by default. The high-risk capabilities (file system access and remote Git operations) are clearly aligned with the stated purpose and are accompanied by extensive documentation, safety warnings, and dry-run options.
Capability Assessment
Purpose & Capability
Name/description match the code and docs: the repo contains backup.mjs, restore.mjs, list.mjs, validate.mjs and examples for git-sync and cron. The requested capabilities (backup, restore, validate, optional git push) are consistent with the files present. No unrelated binaries or cloud credentials are required.
Instruction Scope
SKILL.md instructs the agent/user to read workspace files and (optionally) the real ~/.openclaw/openclaw.json and to perform git commit/push flows (backup-and-push.mjs and GitHub Actions). Reading the local openclaw.json and pushing backups off-machine are within scope for a backup tool, but they materially increase risk: the skill documents a sanitization step for openclaw.json but also provides an explicit --raw-openclaw-config option and guidance to push backups to remotes. Verify the sanitization code and be cautious with automated pushes to remote repositories.
Install Mechanism
No install spec or external downloads are declared. All code is included as local Node.js .mjs scripts. This is low-risk from an install/download perspective, but the scripts will execute on the host when run.
Credentials
The skill declares no required environment variables or credentials, which is reasonable. However, scripts perform git operations that rely on the host's git credentials/credential helpers and may access ~/.openclaw/openclaw.json (sensitive). The lack of declared env vars is appropriate, but users must understand that local git auth and filesystem access provide the mechanism for remote pushes and possible exposure.
Persistence & Privilege
always:false and model invocation defaults are normal. The skill does not request persistent platform-level privileges or attempt to modify other skills' configs. It runs as local scripts when invoked.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openclaw-workspace-backup-restore
  3. After installation, invoke the skill by name or use /openclaw-workspace-backup-restore
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.5.4
Release 1.5.4: tighten backup/restore validation, wire real tests, refresh docs/license/repo links, and publish a cleaner verified package.
v1.5.3
Align description with when-to-use trigger language for clearer ClawHub discovery.
v1.5.2
Separate skill repo from real backup data, move backups outside the skill repo, mirror backups through a dedicated private backup repo, and keep ClawHub/public installs free of tracked real backup files.
v1.5.1
Bump patch version and publish OpenClaw Backup Restore with GitHub backup sync and openclaw.json config backup support.
v1.5.0
Add built-in auto git add/commit/push docs, daily GitHub Actions workflow, and GitHub backup positioning updates.
v1.2.0
Rename for better ClawHub discoverability; emphasize OpenClaw workspace backup, restore, rollback, and recovery.
Metadata
Slug openclaw-workspace-backup-restore
Version 1.5.4
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 6
Frequently Asked Questions

What is OpenClaw Backup & Restore?

This skill should be used when the user asks for OpenClaw backup, restore, rollback, validation, GitHub backup, off-machine backup, workspace recovery, or pr... It is an AI Agent Skill for Claude Code / OpenClaw, with 353 downloads so far.

How do I install OpenClaw Backup & Restore?

Run "/install openclaw-workspace-backup-restore" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is OpenClaw Backup & Restore free?

Yes, OpenClaw Backup & Restore is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does OpenClaw Backup & Restore support?

OpenClaw Backup & Restore is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created OpenClaw Backup & Restore?

It is built and maintained by X-RayLuan (@x-rayluan); the current version is v1.5.4.

💬 Comments