Claw Sync

Claw Sync

Secure, versioned sync for OpenClaw memory and workspace to GitHub.

Repository: https://github.com/arakichanxd/Claw-Sync

File References

---

Installation

Step 1: Clone the skill

cd ~/​.openclaw/​workspace/​skills
git clone https://github.com/arakichanxd/Claw-Sync.git claw-sync

Step 2: Create a GitHub repository

1. Go to https://github.com/new
2. Create a private repository (e.g., my-openclaw-sync)
3. Leave it empty (no README)

Step 3: Create a GitHub token

1. Go to https://github.com/settings/tokens?type=beta
2. Click "Generate new token"
3. Name: openclaw-sync
4. Repository access: Select your sync repository
5. Permissions: Contents → Read and Write
6. Generate and copy the token

Step 4: Configure the skill

Create file ~/​.openclaw/​.backup.env:

BACKUP_REPO=https://github.com/YOUR_USERNAME/YOUR_REPO
BACKUP_TOKEN=ghp_YOUR_TOKEN_HERE

Step 5: Test the setup

/​sync-status

If configured correctly, you'll see ✅ Configured.

Step 6: First sync

/​sync

---

Commands

/​sync

Push memory and skills to remote.

/​sync              → Create versioned snapshot
/​sync --dry-run    → Preview what would sync (no changes)

/​restore

Restore from remote.

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

/​sync-status

Show configuration and local snapshots.

/​sync-list

List all available versions to restore.

---

What Gets Synced

NOT Synced (security)

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

---

Troubleshooting

"Sync not configured"

Create ~/​.openclaw/​.backup.env with BACKUP_REPO and BACKUP_TOKEN.

"Invalid repository URL"

URL must be HTTPS and from github.com, gitlab.com, or bitbucket.org.

"Token appears too short"

Token must be at least 20 characters. Get a new one from GitHub.

Clone failed

Check that your token has Contents read/​write permission.

---

Disaster Recovery

Before every restore, a local backup is automatically saved to:

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

If something goes wrong, manually copy files from there.

---

Auto-Sync Setup

To sync automatically every 12 hours:

node skills/​claw-sync/​index.js setup

---

Features

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

---

Source Code

Full source: https://github.com/arakichanxd/Claw-Sync