agentCLAWHUBUnverified

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

OpenClaw

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
  1. 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.
  2. 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 USD

1 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: []
Github ReposUpdated 3d agoRank 70

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!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

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

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "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

Sponsored

Ads related to Smart Backup and adjacent AI workflows.