Smart Backup
Intelligent file backup with compression and verification. Backup, sync, verify integrity, dedup, and restore. Manifest tracking. Zero external dependencies. Skill: Smart Backup Owner: jlacroix82 Summary: Intelligent file backup with compression and verification. Backup, sync, verify integrity, dedup, and restore. Manifest tracking. Zero external dependencies. Tags: latest:1.0.8, security-fix:1.0.1 Version history: v1.0.8 | 2026-07-22T21:54:12.458Z | user v1.0.8: Safety fixes - restore preserves directory structure, --no-delete default for sync, --force for restore overwr
Rank
62
Safety
84
Downloads
990
Updated
Oct 11, 2026
Version
1.0.8
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 990 downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 990 downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.0.8release · observed Jul 22, 2026
- Handshake status
- UNKNOWNsecurity
What changed
Newest first. Only changes that point at a source are listed.
Release 1.0.8release
v1.0.8: Safety fixes - restore preserves directory structure, --no-delete default for sync, --force for restore overwrite
Observed Jul 22, 2026 · source
Install and run
Setup complexity: low.
clawhub skill install s175p518b8g47fx6r9zyvs95ks876t4t:backup-sync- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-jlacroix82-backup-sync/snapshot"
Run-check
$0.02 USD1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.
Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.
Documentation
CLAWHUB
104,651 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
--- name: smart-backup description: Intelligent file backup with compression and verification. Backup, sync, verify integrity, dedup, and restore. Manifest tracking. Zero external dependencies. --- # Smart Backup 💾 **Stop losing config changes to disk failures. Start backing up intelligently.** ## The Problem Config files, skills, memory — they're all on one disk with no backup strategy. When something breaks, everything is gone. Manual backups are error-prone and inconsistent. Smart Backup fixes this with automated backup, sync, verification, and deduplication. ## ⚠️ Important Warnings ### Destructive Restore / Sync - `--restore` overwrites target files with backup contents - `--sync` two-way merges can create conflicts - Both operations are irreversible if run without `--dry-run` first Always preview with `--dry-run` before executing. ### Silent Data Duplication If backup intervals overlap or the same source is backed up to the same destination multiple times, files will accumulate with timestamps. Periodically audit the backup directory for unexpected duplicates. ### Manifest Privacy Backup manifests (`manifest.json`) contain full file paths and sizes, which may reveal directory structure and filenames. Treat manifests as sensitive metadata. ### Incremental Metadata Persistence The backup journal and deduplication hash database persist under the backup destination. These files (`incremental-index.json`, `dedup-hashes.json`) grow with each backup run. ## Safety This version includes safety fixes for the three ClawHub security audit findings: ### `--no-delete` — Default for sync (safe) By default, sync **does not delete** files in the destination that are absent from the source. This prevents accidental data loss. - `--no-delete` (default): files in dest not in source are skipped and logged with a WARNING - `--delete`: enables deletion. Without `--force`, lists files that would be deleted but does not delete them - `--delete --force`: actually deletes files absent from source, logging each one ### `--force` — Required for restore overwrite `--restore` **skips existing files by default** instead of silently overwriting them. - Without `--force`: existing files are skipped; WARNING logged for each - With `--force`: existing files are overwritten; OVERWRITE logged for each ### Restore preserves directory structure Restore uses the relative path from the manifest's `source` directory, preserving the original directory tree. Files land at `destination/<relative-path>`, not flattened into `destination/<basename>`. ### Tests excluded from published bundle The `test/` and `tests/` directories are development artifacts and are **not included** in the published skill bundle. ## Quick Start ### Create a backup ```bash node skills/smart-backup/smart-backup.js --backup ~/openclaw /path/to/backup ``` ### Preview backup without creating ```bash node skills/smart-backup/smart-backup.js --backup --dry-run ~/openclaw /path/to/backup ``` #
README.md
# Smart Backup & Sync
Intelligent file backup with gzip compression, incremental backups, verification, and deduplication.
## Features
- **Full Backups** — Create timestamped, compressed backups with manifest tracking
- **Incremental Backups** — Only back up changed files since last manifest
- **File Sync** — Sync files between directories with dry-run support
- **Backup Verification** — Verify backup integrity (hash comparison)
- **Restore** — Restore backups to a destination directory
- **Deduplication** — Find duplicate files by content hash
- **Status Overview** — View backup stats and storage health
- **Compression** — Built-in gzip compression for backup files
## Installation
```bash
# The skill is auto-loaded by OpenClaw via the skill registry.
# For standalone use:
const SB = require('./smart-backup.js');
```
## Commands
```
--backup <source> <destination> Create full backup
--backup --dry-run <source> <dest> Preview backup
--sync <source> <destination> Sync files between locations
--sync --dry-run <source> <dest> Preview sync
--verify <backup_file> Verify backup integrity
--dedup <dir> Content-aware deduplication
--list List available backups
--restore <backup_file> <destination> Restore from backup
--status Backup status overview
```
## API
### `createBackup(source, destination, dryRun = false)`
Create a timestamped gzip-compressed backup of source directory.
```javascript
SB.createBackup('/home/user/projects', '/backups', false);
```
### `createIncrementalBackup(source, destination, fromManifest, dryRun)`
Only back up files that changed since the last manifest.
```javascript
SB.createIncrementalBackup('/home/user/projects', '/backups');
```
### `syncFiles(source, destination, dryRun)`
Synchronize files from source to destination.
```javascript
SB.syncFiles('/home/user/projects', '/backups/mirror');
```
### `verifyBackup(backupFile)`
Verify backup integrity by comparing file hashes.
```javascript
SB.verifyBackup('/backups/backup-2026-07-18-123456789');
```
### `listBackups()`
List all available timestamped backups.
### `restoreBackup(backupFile, destination)`
Restore a backup to the specified destination.
```javascript
SB.restoreBackup('/backups/backup-2026-07-18-123456789', '/home/user/restored');
```
### `findDuplicates()`
Find and report duplicate files by content hash.
### `getFileHash(filepath)`
Get SHA-256 hash of a file. Returns null for missing files.
### `formatBytes(bytes)`
Format byte count as human-readable string (`1 KB`, `2.5 MB`).
### `collectFiles(dir, skipDirs)`
Recursively collect files in a directory, skipping common non-essential dirs.
### `showStatus()`
Print backup system status (total backups, size, directory).
## Security
- File hashes computed using SHA-256
- Backup files stored with manifest for integrity verification
- No extern_meta.json
{
"ownerId": "kn7b6eyf5vc7khg5fr63pjm8xd82qvw5",
"slug": "backup-sync",
"version": "1.0.8",
"publishedAt": 1784757252458
}skill-card.md
## Description: Intelligent file backup with compression and verification. Backup, sync, verify integrity, dedup, and restore. Manifest tracking. Zero external dependencies. This skill is ready for commercial/non-commercial use. ## Publisher: [jlacroix82](https://clawhub.ai/user/jlacroix82) ### License/Terms of Use: MIT-0 ## Use Case: Developers and agents use Smart Backup to create local backups, sync directory copies, verify backup manifests, restore files, and identify duplicate content during workspace maintenance. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Local backup, sync, and restore operations may read, write, overwrite, delete, or restore files outside the locations a user intended. Mitigation: Review paths before execution, run on non-sensitive test directories first, use dry-run previews, and avoid --force or --delete unless the affected paths have been inspected. Risk: Backups and manifests may expose sensitive file contents, full paths, sizes, and directory structure. Mitigation: Store backups and manifests only in trusted locations with appropriate access controls, and avoid using the skill on sensitive directories until the release has been reviewed. Risk: Advertised compression, destination selection, symlink safety, and full SHA-256 integrity behavior may not match the implementation. Mitigation: Do not rely on those claims for critical recovery workflows until implementation fixes are reviewed and verified. ## Reference(s): - [ClawHub Skill Page](https://clawhub.ai/jlacroix82/skills/backup-sync) ## Skill Output: **Output Type(s):** [text, markdown, shell commands, configuration, guidance] **Output Format:** [Markdown with inline shell commands and configuration snippets] **Output Parameters:** [1D] **Other Properties Related to Output:** [Produces local backup, sync, verification, restore, deduplication, and status guidance for agent workflows.] ## Skill Version(s): 1.0.8 (source: server release evidence) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
clawhub.yaml
slug: backup-sync name: backup-sync description: Intelligent file backup with compression, manifest tracking, verification, and deduplication. ⚠️ Destructive restore/sync. Always dry-run first. version: 1.0.5 type: skill author: OpenClaw license: MIT keywords: - backup - sync - deduplication - compression - agent entry: SKILL.md owner: jlacroix82 dependencies: []
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
- Card JSON
- Facts JSON
- Snapshot JSON
- Contract JSON
- Trust JSON
- Changes JSON
- Warnings JSON
- Seen by JSON
- Disagreements JSON
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/jlacroix82/skills/backup-sync",
"sourceUrl": "https://clawhub.ai/jlacroix82/skills/backup-sync",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T21:31:26.896Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-jlacroix82-backup-sync/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-jlacroix82-backup-sync/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T21:31:26.896Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "990 downloads",
"href": "https://clawhub.ai/jlacroix82/backup-sync",
"sourceUrl": "https://clawhub.ai/jlacroix82/backup-sync",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T21:31:26.896Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.8",
"href": "https://clawhub.ai/jlacroix82/backup-sync",
"sourceUrl": "https://clawhub.ai/jlacroix82/backup-sync",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-07-22T21:54:12.458Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-jlacroix82-backup-sync/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-jlacroix82-backup-sync/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.8",
"description": "v1.0.8: Safety fixes - restore preserves directory structure, --no-delete default for sync, --force for restore overwrite",
"href": "https://clawhub.ai/jlacroix82/backup-sync",
"sourceUrl": "https://clawhub.ai/jlacroix82/backup-sync",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-07-22T21:54:12.458Z",
"isPublic": true
}
]
}Record generated Oct 12, 2026.
For crawlers
This page is free to read. The run-check above is the only paid part, and it answers HTTP 402 until it is paid. Everything else here is public.
- One record, as JSON: card, facts, snapshot, contract, trust, changes, warnings, seen by, disagreements.
- Every agent, one feed: /.well-known/ai-catalog.json
- What this site sells, and the price: /.well-known/x402
- Paid run-check: /api/v1/agents/clawhub-jlacroix82-backup-sync/run-check
