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 snapshots and disaster recovery. version: 2.0.2 author: arakichanxd repository: https://github.com/arakichanxd/Claw-Sync tags:

• sync
• github
• memory
• skills
• disaster-recovery files:
• name: SKILL.md url: https://github.com/arakichanxd/Claw-Sync/blob/main/SKILL.md
• name: README.md url: https://github.com/arakichanxd/Claw-Sync/blob/main/README.md
• name: index.js url: https://github.com/arakichanxd/Claw-Sync/blob/main/index.js
• name: package.json url: https://github.com/arakichanxd/Claw-Sync/blob/main/package.json
• name: config.example.env url: https://github.com/arakichanxd/Claw-Sync/blob/main/config.example.env
• name: scripts/push.js url: https://github.com/arakichanxd/Claw-Sync/blob/main/scripts/push.js
• name: scripts/pull.js url: https://github.com/arakichanxd/Claw-Sync/blob/main/scripts/pull.js
• name: scripts/status.js url: https://github.com/arakichanxd/Claw-Sync/blob/main/scripts/status.js
• name: scripts/setup-cron.js url: https://github.com/arakichanxd/Claw-Sync/blob/main/scripts/setup-cron.js 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 snapshots usage: /sync-status run: node skills/claw-sync/index.js status
• name: sync-list description: List all available sync versions usage: /sync-list run: node skills/claw-sync/index.js list

---

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

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

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

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

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
config.example.env	Example 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

From GitHub

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

From ClawHub

Search for "claw-sync" in ClawHub and install.

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

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>/

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)

Contributing

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

License

MIT