claw-sync

⚠Review·Scanned 2/17/2026

Provides versioned sync/restore of OpenClaw workspace to Git remotes. The skill reads ~/.openclaw/.backup.env for BACKUP_TOKEN and runs shell git commands (e.g. git push) to github.com and similar hosts, and writes cron config under ~/.openclaw.

from clawhub.ai·v4db6360·73.5 KB·0 installs
Scanned from 2.0.2 at 4db6360 · Transparency log ↗
$ vett add clawhub.ai/arakichanxd/claw-syncReview findings below

Claw Sync

Secure, versioned sync for OpenClaw memory files and custom skills.

Features

  • 🏷️ Versioned: Each sync creates a tagged version you can restore
  • 💾 Disaster Recovery: Local backup created before every restore
  • 🔒 Secure: Config files NOT synced, URL validation, path protection
  • 🖥️ Cross-platform: Works on Windows, Mac, Linux

Quick Start

/sync              # Push to remote
/restore           # Restore latest
/sync-list         # List versions
/sync-status       # Check status

What Gets Synced

FileDescription
MEMORY.mdLong-term memory
USER.mdUser profile
SOUL.mdAgent persona
IDENTITY.mdAgent identity
TOOLS.mdTool configurations
AGENTS.mdWorkspace conventions
memory/*.mdDaily logs
skills/*Custom skills

NOT Synced (security)

  • openclaw.json - Contains API keys/tokens
  • .env - Contains secrets

Setup

Create ~/.openclaw/.backup.env:

BACKUP_REPO=https://github.com/yourusername/your-sync-repo
BACKUP_TOKEN=ghp_your_fine_grained_personal_access_token

All Commands

CommandDescription
/syncPush memory and skills to remote
/sync --dry-runPreview what would be synced
/restoreRestore latest version
/restore latestSame as above
/restore backup-20260202-1430Restore specific version
/restore --forceSkip confirmation
/sync-listList all available versions
/sync-statusShow config and local backups

CLI Usage

You can also run commands directly:

node index.js sync              # Push
node index.js sync --dry-run    # Preview
node index.js restore           # Restore latest
node index.js restore backup-20260202-1430   # Specific version
node index.js list              # List versions
node index.js status            # Check status

Disaster Recovery

Local backup automatically created before every restore at:

~/.openclaw/.local-backup/<timestamp>/

Restore on New Machine

  1. Install OpenClaw
  2. Clone this skill to skills/claw-sync/
  3. Create .backup.env with repo and token
  4. Run /sync-list to see versions
  5. Run /restore to get latest
  6. Configure API keys in openclaw.json and .env
  7. Restart OpenClaw

Security Features

  • No config sync (secrets never leave your machine)
  • URL validation (only GitHub/GitLab/Bitbucket)
  • Path protection (blocks directory traversal)
  • Token sanitization (never in error messages)
  • Version validation (strict format checking)

License

MIT