Skills claw-sync

Name: claw-sync
Author: openclaw

Secure sync for OpenClaw memory and workspace. Use /sync to push, /restore to pull, /sync-status to check. Supports versioned snapshots and disaster recovery.

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/arakichanxd/claw-sync/claw-sync" ~/.claude/skills/openclaw-skills-claw-sync-ad1e58 && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/arakichanxd/claw-sync/claw-sync" ~/.openclaw/skills/openclaw-skills-claw-sync-ad1e58 && rm -rf "$T"

manifest: skills/arakichanxd/claw-sync/claw-sync/SKILL.md

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