workspace-backup-manager

Manages workspace backups by creating snapshots and enabling restore points for recovery. Use when backing up workspace or restoring from backup.

Security Scan

This skill is internally consistent: it implements local workspace backup, listing, restore, and cleanup operations, does not request credentials or network access, and its code matches the described behavior.

Purpose & Capability

The code implements createBackup, listBackups, restoreBackup, cleanupBackups and formatList as described. The declared purpose (workspace backups and restore points) aligns with the files operated on and the storage location used.

Instruction Scope

SKILL.md instructions and the code reference the same functionality and default paths (/root/.openclaw/workspace/backups). The README shows example usage consistent with exported functions. Note: the code will overwrite files when restoring and will delete backup directories during cleanup; there is no confirmation, access control, or size limits enforced—so accidental data overwrite or removal is possible if misused.

Install Mechanism

There is no install spec; this is effectively an instruction-and-code skill that runs locally using only built-in Node modules (fs, path). No external downloads or package installs are requested.

Credentials

No environment variables, credentials, or external service tokens are requested. The defaults use absolute filesystem paths under /root/.openclaw, which is consistent with its purpose but implies it needs filesystem write/read permission to that location.

Persistence & Privilege

The skill is not force-included (always: false) and does not modify other skills or global agent settings. It performs local filesystem writes and deletions only within backup/workspace directories.

Assessment

This skill appears to do what it says — local backups, listing, restore, and cleanup — and it does not contact external services or request secrets. Before installing, consider: (1) it defaults to /root/.openclaw/workspace and will read/write/delete files there, so run it with appropriate filesystem permissions; (2) restore operations overwrite workspace files without confirmation, and cleanup permanently deletes backup directories, so back up important data elsewhere first; (3) review the included index.js if you want to confirm any behavior or change default paths; and (4) because the skill comes from an unknown source, prefer running it in a controlled environment (non-production or limited-permission user) until you are comfortable with it.

Creates and manages workspace backup snapshots for recovery and versioning.

Usage

const backup = require('./skills/workspace-backup-manager');

// Create a backup
const result = backup.createBackup();

// Create named backup
const result = backup.createBackup({ name: 'before-major-change' });

// List backups
const list = backup.listBackups();
console.log(backup.formatList(list));

// Restore from backup
backup.restoreBackup({ backupName: 'backup-2026-03-26' });

// Cleanup old backups (keep last 10)
backup.cleanupBackups({ keepCount: 10 });

Functions

• createBackup(options) - Create a new backup snapshot
• listBackups(backupDir) - List all available backups
• restoreBackup(options) - Restore workspace from a backup
• cleanupBackups(options) - Delete old backups, keeping most recent
• formatList(result) - Format backup list for display

Backup Contents

Backs up:

• Root files: MEMORY.md, SOUL.md, IDENTITY.md, AGENTS.md, USER.md, HEARTBEAT.md, TOOLS.md
• Directories: memory/, logs/

Example Output

📦 Available Backups (3)

- backup-2026-03-26T03-12-00
  Created: 2026-03-26T03:12:00Z
  Files: 45 | Size: 128.5 KB

- backup-2026-03-25T18-00-00
  Created: 2026-03-25T18:00:00Z
  Files: 42 | Size: 115.2 KB

Total size: 0.24 MB

CLI Usage

node -e "require('./skills/workspace-backup-manager').main()"

Storage Location

Backups are stored in:

• /root/.openclaw/workspace/backups/