← Back to Skills Marketplace
cccarv82

Openclaw Backup Optimized

by cccarv82 · GitHub ↗ · v1.0.1
cross-platform ⚠ suspicious
2711
Downloads
4
Stars
12
Active Installs
2
Versions
Install in OpenClaw
/install openclaw-backup-optimized
Description
Optimized OpenClaw backup skill for creating full snapshots with workspace archive splitting, change summaries, restore instructions, and Discord notifications. Use when you need to set up or run automated backups, configure backup cron jobs, or document/restore OpenClaw state. Triggers on backup automation, backup scripts, snapshot/restore, or GitHub backup repos.
Usage Guidance
This skill is what it claims to be: a backup script for your OpenClaw home. Before installing or scheduling it, review the script (scripts/backup.js) yourself and confirm you are comfortable with what will be copied. Pay special attention to BACKUP_REPO_URL: if you set it, the script will git push (force) the backup contents to that remote — only use a trusted, private repository. Also verify BACKUP_CHANNEL_ID because notifications go through the OpenClaw gateway (openclaw message send). Run the script manually once, inspect the generated backup directory (~/.openclaw-backup by default) and backup-report.json, and ensure any git credentials and remote settings are intentional before enabling the cron entry.
Capability Analysis
Type: OpenClaw Skill Name: openclaw-backup-optimized Version: 1.0.1 The skill is designed to back up the entire OpenClaw home directory (`~/.openclaw`) and push it to a user-configured Git repository (`BACKUP_REPO_URL`) using `git push --force`. While this aligns with the stated purpose of a backup skill, it involves handling highly sensitive data and exfiltrating it to an external endpoint, which, if misconfigured or pointed to a malicious repository, could lead to data theft or loss. The use of `git push --force` is a powerful and potentially destructive operation. These capabilities, though plausibly needed for a backup, are high-risk and warrant a 'suspicious' classification due to the potential for misuse or unintended consequences, as seen in `scripts/backup.js` and `SKILL.md`.
Capability Assessment
Purpose & Capability
Name/description match the code and docs: scripts/backup.js implements full snapshots of ~/.openclaw, workspace tar+split, SHA256, retention, notifications, and optional pushing to a git repo. The declared registry metadata lists no required env vars but the SKILL.md and script clearly document several environment variables the script honors (OPENCLAW_HOME, OPENCLAW_BACKUP_DIR, BACKUP_REPO_URL, BACKUP_CHANNEL_ID, BACKUP_TZ, BACKUP_MAX_HISTORY) — this mismatch is minor and likely documentation/metadata oversight.
Instruction Scope
SKILL.md instructs copying the script into ~/.openclaw/workspace/tools, running it with node, and adding an openclaw cron entry. The runtime instructions and the script operate only on the OpenClaw home/backup paths and use 'openclaw message send' for notifications. They do not try to read unrelated system files. Important behavior: if BACKUP_REPO_URL is set the script will add a git remote and force-push the backup repo, which will transmit backup contents to that remote.
Install Mechanism
There is no remote install or download; the skill is instruction-plus-local-script. package.json lists small, standard dependencies (minimatch, tar). No network downloads or extract-from-URL install steps are present in the manifest.
Credentials
The registry lists no required env vars, but both SKILL.md and the script rely on multiple environment variables. The script will send data externally only if configured (BACKUP_REPO_URL for git push and BACKUP_CHANNEL_ID for gateway notifications). That behavior is expected for a backup tool, but it has real exfiltration potential: setting BACKUP_REPO_URL to an external/unknown repository will upload your OpenClaw data (which may contain secrets). The skill itself does not request API tokens, but git pushes may use whatever system git credentials are available.
Persistence & Privilege
always:false (not force-included). The skill does ask the operator to place a script in the user's OpenClaw tools directory and to create a cron job via the OpenClaw cron command (which schedules jobs in the gateway environment). This is normal for a scheduled backup workflow and it does not modify other skills or global agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openclaw-backup-optimized
  3. After installation, invoke the skill by name or use /openclaw-backup-optimized
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Added separate environment variable setup instructions for Windows (PowerShell) in addition to macOS/Linux. - Clarified the script and path examples to use user home directories consistently (e.g., ~/.openclaw). - Specified that OpenClaw cron jobs run in the gateway environment. - Improved formatting and OS-specific guidance for easier installation and setup.
v1.0.0
- Initial release of the optimized OpenClaw backup skill. - Automates full workspace snapshot creation with archive splitting (~90MB parts) and SHA256 integrity checks. - Provides rich Discord notifications including change summaries and step-by-step restore instructions. - Retains up to N recent backup reports for easier history tracking. - Includes reference config guide and cross-platform script (`backup.js`); replaces older shell-based workflow.
Metadata
Slug openclaw-backup-optimized
Version 1.0.1
License
All-time Installs 13
Active Installs 12
Total Versions 2
Frequently Asked Questions

What is Openclaw Backup Optimized?

Optimized OpenClaw backup skill for creating full snapshots with workspace archive splitting, change summaries, restore instructions, and Discord notifications. Use when you need to set up or run automated backups, configure backup cron jobs, or document/restore OpenClaw state. Triggers on backup automation, backup scripts, snapshot/restore, or GitHub backup repos. It is an AI Agent Skill for Claude Code / OpenClaw, with 2711 downloads so far.

How do I install Openclaw Backup Optimized?

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

Is Openclaw Backup Optimized free?

Yes, Openclaw Backup Optimized is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Openclaw Backup Optimized support?

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

Who created Openclaw Backup Optimized?

It is built and maintained by cccarv82 (@cccarv82); the current version is v1.0.1.

💬 Comments