simplefarmer69 Claw Sync
Secure, versioned sync for OpenClaw memory and workspace to GitHub.
Repository: https://github.com/arakichanxd/Claw-Sync
File References
| File | Description | Link |
|---|---|---|
SKILL.md |
AI agent instructions | View |
README.md |
User documentation | View |
index.js |
Command router | View |
package.json |
NPM config | View |
scripts/push.js |
Sync to remote | View |
scripts/pull.js |
Restore from remote | View |
scripts/status.js |
Show status | View |
scripts/setup-cron.js |
Auto-sync setup | View |
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
- Go to https://github.com/new
- Create a private repository (e.g.,
my-openclaw-sync) - Leave it empty (no README)
Step 3: Create a GitHub token
- Go to https://github.com/settings/tokens?type=beta
- Click "Generate new token"
- Name:
openclaw-sync - Repository access: Select your sync repository
- Permissions: Contents → Read and Write
- 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
| 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
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