claw-sync – OpenClaw Skill

---

name: claw-sync description: Secure sync for OpenClaw memory and workspace. Use /sync to push, /restore to pull, /sync-status to check. Supports versioned backups and disaster recovery. commands:

• name: sync description: Push memory and skills to remote repository usage: /sync [--dry-run] run: node skills/claw-sync/index.js sync
• name: restore description: Restore memory and skills from remote usage: /restore [latest|<version>] [--force] run: node skills/claw-sync/index.js restore
• name: sync-status description: Show sync configuration and local backups usage: /sync-status run: node skills/claw-sync/index.js status
• name: sync-list description: List all available backup versions usage: /sync-list run: node skills/claw-sync/index.js list

---

Claw Sync

Secure, versioned sync for OpenClaw memory and workspace.

Commands

/sync

Push your memory and skills to the remote repository.

/sync              → Push and create versioned backup
/sync --dry-run    → Preview what would be synced

/restore

Restore memory and skills from the remote repository.

/restore                        → Restore latest version
/restore latest                 → Same as above
/restore backup-20260202-1430   → Restore specific version
/restore latest --force         → Skip confirmation

/sync-status

Show sync configuration and local backup info.

/sync-status

/sync-list

List all available backup versions.

/sync-list

---

What Gets Synced

File	Description
MEMORY.md	Long-term memory
USER.md	User profile
SOUL.md	Agent persona
IDENTITY.md	Agent identity
TOOLS.md	Tool configs
AGENTS.md	Workspace rules
memory/*.md	Daily logs
skills/*	Custom skills

NOT Synced (security)

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

Setup Required

Create ~/.openclaw/.backup.env:

BACKUP_REPO=https://github.com/username/your-repo
BACKUP_TOKEN=ghp_your_token

Features

• 🏷️ Versioned - Each sync creates a restorable version
• 💾 Disaster Recovery - Local backup before every restore
• 🔒 Secure - No config files synced, token sanitization
• 🖥️ Cross-platform - Windows, Mac, Linux

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

File	Description
MEMORY.md	Long-term memory
USER.md	User profile
SOUL.md	Agent persona
IDENTITY.md	Agent identity
TOOLS.md	Tool configurations
AGENTS.md	Workspace conventions
memory/*.md	Daily 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

Command	Description
/sync	Push memory and skills to remote
/sync --dry-run	Preview what would be synced
/restore	Restore latest version
/restore latest	Same as above
/restore backup-20260202-1430	Restore specific version
/restore --force	Skip confirmation
/sync-list	List all available versions
/sync-status	Show 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