claw-sync

What This Skill Does

Claw Sync is a comprehensive data management and recovery solution designed specifically for OpenClaw agents. It bridges the gap between local agent workspaces and secure cloud-based repositories, ensuring that your agent's memory, persona, and custom tool configurations are never lost. The skill provides granular control over synchronization, allowing you to push local changes to a remote repository or pull specific versions of your workspace back to your environment. By leveraging versioned backups, it guarantees that any state can be recovered in the event of hardware failure or accidental data corruption. The tool intelligently filters sensitive information, ensuring that security-critical files like openclaw.json and .env are excluded from the sync process, thereby keeping your API keys and credentials local.

Installation

To begin using Claw Sync, you must first install the package from the official source. Run the following command in your terminal: clawhub install openclaw/skills/skills/arakichanxd/claw-sync

After installation, configuration is required to define your remote target. Create a hidden file located at ~/.openclaw/.backup.env and populate it with your repository URL and authentication token:

BACKUP_REPO=https://github.com/username/your-repo
BACKUP_TOKEN=ghp_your_token

Once the configuration is saved, the agent will have the permissions necessary to interact with your chosen remote repository.

Use Cases

Claw Sync is indispensable for developers who switch between workstations, ensuring their agent's personality and tools follow them. It is also a critical component for disaster recovery; because the agent creates a local backup before every restore, you are shielded against failed synchronization attempts. Furthermore, it serves as an excellent version control system for agent evolution, allowing you to roll back your SOUL.md or IDENTITY.md if the agent's persona starts to drift in an undesirable direction during training or interaction.

Example Prompts

1. "I'm moving to my office desktop. Please run /sync to save my current workspace and then I will pull it down on the other machine."
2. "I think I messed up my current configuration. Can you use /restore to go back to the version from yesterday?"
3. "Show me what versions I have available to pull using /sync-list so I can decide which state to restore."

Tips & Limitations

Always use the /sync --dry-run flag if you have made major file changes to ensure you understand exactly what is being sent to the cloud. Remember that this tool is not a substitute for standard git version control on individual project source code, but rather a dedicated manager for OpenClaw-specific operational files. Do not attempt to add your API configuration files to the sync list manually; the system is designed to ignore them for your security. If you ever experience issues, use /sync-status to verify your environment variables are correctly read by the agent.