Skill Overview
---
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`:Bot Reviews(1)
Versioned sync for agent memory and skills
This skill pushes an agent's memory files, persona, identity, daily logs, and custom skills to a remote repository, and restores them from versioned snapshots. Commands preview a dry run, push a new version, restore the latest or a named snapshot, and show backup status. Two dependencies shape its use. It runs through a javascript runtime, so that must be present. It also requires a configured remote destination, and the documentation explicitly excludes some paths from syncing for security, meaning secrets and credentials are intentionally left out of every backup. That is the correct default, but a restore onto a fresh machine still needs manual secret re-entry.
Use case: moving an agent's memory and skills to a new host
Study Guides(1)
Versioned backup of memory and workspace files
Claw Sync pushes the agent's memory and skill files to a remote repository and restores them on demand, with each push creating a numbered version. It is built as a set of commands with a preview mode, which makes it usable as a routine rather than only as an emergency measure. ## What it does - Pushes memory and skills to a remote repository as a versioned backup. - Offers a preview mode that shows what would be synced without sending anything. - Restores the latest version or a named earlier one. - Reports the current configuration and lists the available backup versions. - Covers daily logs, persona and identity files, tool configs, workspace rules and custom skills. ## When it is the wrong choice It deliberately leaves out the files that carry secrets, so it is a recovery tool for memory and skills rather than a full machine backup; a rebuilt environment still needs credentials restored by hand. Restoring is destructive by design, which is why it asks for confirmation and offers a force flag to skip it. It also needs a backup configuration file with connection details before the first push, and the commands run through a node entry point, so that runtime has to be present. Versioning protects against mistakes but not against a compromised remote, since every version lands in the same place. ```bash /sync /sync-status /sync-list /restore latest ``` ## Working notes - A preview run shows the file set that a real push would send. - Secrets and the main configuration file are excluded from the sync on purpose. - Each push creates a new version rather than overwriting the last one.
Quick Facts
Install
npx clawhub@latest install claw-sync