openclaw-checkpoint
Backup and restore OpenClaw workspace state and agents across machines using git. Enables disaster recovery by syncing SOUL.md, MEMORY.md, memory files, cron jobs, agents (~/.openclaw/agents/), and configuration to a remote repository. Use when user wants to checkpoint their OpenClaw state, restore on a new machine, migrate between computers, or protect against data loss. Provides commands checkpoint (help overview), checkpoint-setup (interactive onboarding), checkpoint-backup, checkpoint-restore (with interactive checkpoint selection or --latest for most recent), checkpoint-schedule (auto-backup), checkpoint-stop, checkpoint-status, checkpoint-init, and checkpoint-reset. Supports multi-agent backup with flags --workspace-only, --agents-only, and --agent <name>. Automatically backs up cron jobs to memory/cron-jobs-backup.json on each checkpoint-backup.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/anthonyfrancis/openclaw-checkpointWhat This Skill Does
The openclaw-checkpoint skill serves as a robust disaster recovery and synchronization system for your OpenClaw environment. It allows users to version control their entire workspace, ensuring that their personalized identity (SOUL.md), conversational memory, custom agents, and complex automation configurations are safely stored in a remote git repository. By bridging the gap between your local workspace and a remote backup, it prevents the loss of hours of tuning, prompt engineering, and agent-specific configurations. The tool intelligently manages the lifecycle of your agent infrastructure, including the automated backup of scheduled cron jobs, ensuring that your automated life-assistance remains consistent even if you switch hardware.
Installation
You can install this skill via a direct git clone or a streamlined automated script. For a manual installation, clone the repository into ~/.openclaw/skills/openclaw-checkpoint, move the scripts into your ~/.openclaw/workspace/tools directory, and ensure they are marked as executable. Once set up, running checkpoint-setup will launch an interactive terminal wizard that configures your remote repository, handles authentication via SSH or Personal Access Tokens, and performs an initial repository sync. If you prefer a faster path, execute the provided curl-based installation script, though always review external scripts before execution for security peace of mind.
Use Cases
- Cross-Device Syncing: Maintain a consistent agent persona and memory state between a desktop workstation and a development laptop.
- Disaster Recovery: Restore your entire identity and agent configuration in minutes after a hardware failure or operating system reinstall.
- Version Control: Track the evolution of your agent instructions and workspace files over time, allowing for rollbacks if a specific prompt change causes unwanted behaviors.
- Migration: Easily move your entire digital workspace to a brand-new machine without manually copying configuration files.
Example Prompts
- "OpenClaw, please run the checkpoint-backup command to save my current workspace and agent state to the remote repository."
- "I just finished setting up a new laptop. Can you run the checkpoint-restore --latest command so I can pick up right where I left off?"
- "I'm worried about my current agents. Please use checkpoint-status to verify when the last successful sync occurred."
Tips & Limitations
- Security First: The tool automatically respects .gitignore, meaning sensitive information like API keys, .env files, and OAuth tokens are never pushed to your remote repository. Always double-check your .gitignore file if you add custom sensitive configurations.
- Platform Constraints: This skill is strictly built for macOS and Linux environments; Windows users cannot utilize this skill at this time.
- Best Practice: Schedule regular backups using
checkpoint-scheduleto ensure that your cron-jobs and memory files are always up-to-date without needing manual intervention.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-anthonyfrancis-openclaw-checkpoint": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-write, file-read, external-api