{"skill":{"slug":"openclaw-checkpoint","displayName":"OpenClaw Checkpoint - Personal AI Assistant Backup & Recovery (Github)","summary":"Backup and restore OpenClaw workspace state and agents across machines using git. Enables disaster recovery by syncing SOUL.md, MEMORY.md, memory files, cron...","description":"---\nname: openclaw-checkpoint\ndescription: 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.\n---\n\n# OpenClaw Checkpoint Skill\n\nBackup and restore your OpenClaw identity, memory, agents, and configuration across machines.\n\n**Platform:** macOS and Linux only. Windows is not supported.\n\n## Overview\n\nThis skill provides disaster recovery for OpenClaw by syncing your workspace and agents to a git repository. It preserves:\n\n- **Identity**: SOUL.md, IDENTITY.md, USER.md (who you and the assistant are)\n- **Memory**: MEMORY.md and memory/*.md files (conversation history and context)\n- **Cron Jobs**: Scheduled tasks exported to memory/cron-jobs-backup.json (morning briefs, daily syncs, automations)\n- **Configuration**: TOOLS.md, AGENTS.md, HEARTBEAT.md (tool setups and conventions)\n- **Scripts**: Custom tools and automation you've built\n- **Agents**: All agent folders from ~/.openclaw/agents/ (alex, blake, etc.)\n\n**Not synced** (security): API keys (.env.*), credentials, OAuth tokens\n\n## Installation\n\n### Option 1: Git Clone (Recommended)\n\n```bash\n# Clone the skill repo\ngit clone https://github.com/AnthonyFrancis/openclaw-checkpoint.git ~/.openclaw/skills/openclaw-checkpoint\n\n# Copy scripts to tools directory\nmkdir -p ~/.openclaw/workspace/tools\ncp ~/.openclaw/skills/openclaw-checkpoint/scripts/checkpoint* ~/.openclaw/workspace/tools/\nchmod +x ~/.openclaw/workspace/tools/checkpoint*\n\n# Add to PATH (also add to ~/.zshrc or ~/.bashrc for persistence)\nexport PATH=\"${HOME}/.openclaw/workspace/tools:${PATH}\"\n\n# Run setup wizard\ncheckpoint-setup\n```\n\n### Option 2: Quick Install\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/AnthonyFrancis/openclaw-checkpoint/main/scripts/install-openclaw-checkpoint.sh | bash\n```\n\nThis runs the install script -- review it first if you prefer to inspect before executing.\n\n## Commands\n\n### checkpoint\n**Show all available commands and usage examples.**\n\n```bash\ncheckpoint\n```\n\n**What it does:**\n- Displays a quick reference of all checkpoint commands with descriptions and examples\n\n**When to use:**\n- When you can't remember the exact command name\n- Quick reference for available options\n\n### checkpoint-setup\n**Interactive onboarding flow for first-time setup.**\n\n```bash\ncheckpoint-setup\n```\n\n**What it does:**\n- Guides you through creating a PRIVATE GitHub repository\n- Sets up SSH authentication (recommended) or Personal Access Token\n- Automatically detects if SSH key is already authorized on GitHub\n- Detects agents in `~/.openclaw/agents/` and reports they will be included in backups\n- Generates a README.md with recovery instructions and commands\n- Commits workspace files within `~/.openclaw/workspace` (secrets excluded via .gitignore)\n- Configures automatic backups\n- Tests the backup system\n- Shows final status\n\n**When to use:**\n- First time setting up checkpoint system\n- After installing the skill\n- After running `checkpoint-reset`\n- Recommended starting point for new users\n\n### checkpoint-auth\n**Authenticate with GitHub (browser-based).**\n\n```bash\ncheckpoint-auth\n```\n\n**What it does:**\n- Option 1: GitHub CLI (opens browser automatically)\n- Option 2: Personal Access Token (expires, needs renewal)\n- Option 3: SSH Key (recommended - no token expiry)\n- Automatically adds GitHub to known_hosts\n- Tests authentication after setup\n\n**When to use:**\n- Authentication expired or failed\n- Switching authentication methods\n- Setting up on a new machine\n\n**SSH is recommended** because:\n- No token expiration to worry about\n- Works reliably without password prompts\n- GitHub no longer accepts password authentication for HTTPS\n\n### checkpoint-backup\nSave current state to remote repository.\n\n```bash\ncheckpoint-backup                     # Backup workspace + all agents\ncheckpoint-backup --workspace-only    # Backup workspace only (skip agents)\ncheckpoint-backup --agents-only       # Backup agents only (skip workspace/cron)\ncheckpoint-backup --agent alex        # Backup only the 'alex' agent (+ workspace)\n```\n\n**What it does:**\n- Backs up OpenClaw cron jobs to `memory/cron-jobs-backup.json` (requires `openclaw` CLI and running gateway)\n- Copies agent folders from `~/.openclaw/agents/` into `agents/` in the workspace repo (strips nested `.git` dirs)\n- Normalizes home-directory paths (`$HOME` -> `{{HOME}}`) for cross-machine portability\n- Commits all changes in ~/.openclaw/workspace\n- Pushes to origin/main\n- Shows commit hash and timestamp\n\n**Agent backup details:**\n- Auto-detects agents in `~/.openclaw/agents/` (e.g., alex, blake)\n- Each agent folder is copied to `agents/<name>/` in the backup repo\n- Nested `.git` directories are removed to avoid submodule issues\n- If no agents exist, skips gracefully with an info message\n- Uses `rsync --exclude='.git'` when available, falls back to `cp -r` + manual `.git` removal\n\n**Cron job backup details:**\n- Runs `openclaw cron list --json` to export all scheduled tasks\n- Strips runtime state, keeps only configuration (name, schedule, target, payload)\n- Non-blocking: if the CLI or gateway is unavailable, checkpoint-backup continues without cron backup\n\n**Flags:**\n- `--workspace-only` — skip agent backup\n- `--agents-only` — skip workspace and cron backup, only back up agents\n- `--agent <name>` — back up a single named agent only\n\n**When to use:**\n- Before switching computers\n- After significant changes (new memory, updated SOUL.md)\n- Any time you want to ensure changes are saved\n\n### checkpoint-schedule\nSet up automatic backups with configurable frequency.\n\n```bash\ncheckpoint-schedule 15min      # Every 15 minutes\ncheckpoint-schedule 30min      # Every 30 minutes\ncheckpoint-schedule hourly     # Every hour (default)\ncheckpoint-schedule 2hours     # Every 2 hours\ncheckpoint-schedule 4hours     # Every 4 hours\ncheckpoint-schedule daily      # Once per day at 9am\ncheckpoint-schedule disable    # Turn off auto-backup\n```\n\n**What it does:**\n- macOS: Creates launchd plist for reliable background backups\n- Linux: Adds cron job for scheduled backups\n- Logs all activity to ~/.openclaw/logs/checkpoint.log\n\n**When to use:**\n- First time setup: `checkpoint-schedule hourly`\n- Change frequency: `checkpoint-schedule 15min`\n- Stop backups: `checkpoint-schedule disable`\n\n### checkpoint-status\nCheck backup health and status.\n\n```bash\ncheckpoint-status\n```\n\n**What it shows:**\n- Last backup time and commit\n- Whether local is behind remote\n- Uncommitted changes\n- Agent backup status (which agents are backed up, which are missing)\n- Auto-backup schedule status\n- Recent backup activity log\n\n**When to use:**\n- Before switching machines (verify synced)\n- Troubleshooting backup issues\n- Regular health checks\n\n### checkpoint-restore\nRestore state from remote repository, with checkpoint selection and first-time onboarding.\n\n```bash\ncheckpoint-restore                    # Select from recent checkpoints (interactive)\ncheckpoint-restore --latest           # Restore most recent checkpoint (skip selection)\ncheckpoint-restore --force            # Discard local changes before restoring\ncheckpoint-restore --workspace-only   # Restore workspace only (skip agents)\ncheckpoint-restore --agents-only      # Restore agents only (skip workspace/cron)\ncheckpoint-restore --agent alex       # Restore only the 'alex' agent\n```\n\n**What it does:**\n- **First-time users:** Launches interactive restore onboarding flow\n  - Guides you through GitHub authentication (SSH, GitHub CLI, or PAT)\n  - Lets you specify your existing backup repository\n  - Verifies access and restores your checkpoint\n  - Handles merge/replace options if local files exist\n  - Shows available checkpoints to pick from (if the repo has more than one commit)\n  - Offers to restore cron jobs from backup\n  - Offers to restore agents from backup\n- **Returning users:** Shows a list of the 10 most recent checkpoints to choose from\n  - Pick the latest or any older checkpoint to restore\n  - Current checkpoint is marked in the list\n  - Restoring an older checkpoint warns that the next backup will overwrite newer remote checkpoints\n  - Use `--latest` flag to skip the interactive selection and restore the most recent checkpoint automatically\n- **Uncommitted changes:** If you have local uncommitted changes, you're prompted to:\n  1. Save changes first (runs `checkpoint-backup`)\n  2. Discard local changes and continue restoring\n  3. Cancel\n- **Path portability:** Automatically expands `{{HOME}}` placeholders and rewrites old home-directory paths for the current machine\n- **Cron jobs:** Automatically offers to restore cron jobs from `memory/cron-jobs-backup.json` after restoring (requires OpenClaw gateway to be running)\n- **Agents:** Offers to restore agents from `agents/` directory in the backup to `~/.openclaw/agents/`\n\n**Flags:**\n- `--latest` — skip selection, restore most recent checkpoint\n- `--force` — discard local changes without prompting\n- `--workspace-only` — skip agent restore\n- `--agents-only` — skip workspace and cron restore, only restore agents\n- `--agent <name>` — restore a single named agent only\n\n**When to use:**\n- Starting OpenClaw on a new machine\n- After hardware failure/disaster\n- When resuming work on different computer\n- First-time restore from an existing backup\n- Rolling back to a previous checkpoint after unwanted changes\n\n**Onboarding flow triggers when:**\n- No workspace exists\n- Workspace exists but not a git repository\n- Git repository exists but no remote configured\n\n### checkpoint-init\nInitialize workspace for checkpoint system.\n\n```bash\ncheckpoint-init\n```\n\n**What it does:**\n- Creates git repository in ~/.openclaw/workspace\n- Generates .gitignore (excludes secrets and ephemeral files)\n- Creates initial commit\n\n**When to use:**\n- First time setting up checkpoint system\n- After restoring from backup to new machine\n\n### checkpoint-reset\nReset checkpoint system for fresh setup.\n\n```bash\ncheckpoint-reset\n```\n\n**What it does:**\n- Option 1: Removes local git repository only (keeps SSH keys)\n- Option 2: Removes everything (git repo + SSH keys + GitHub from known_hosts)\n- Offers to remove backed-up agent copies from workspace `agents/` folder\n- Reminds you to delete the GitHub repo manually\n\nNote: Reset never touches your actual agent folders in `~/.openclaw/agents/` -- only the backup copies.\n\n**When to use:**\n- Starting over with a fresh setup\n- Switching to a different GitHub repository\n- Troubleshooting persistent authentication issues\n\n### checkpoint-stop\nStop automatic backups.\n\n```bash\ncheckpoint-stop\n```\n\n**What it does:**\n- Disables scheduled automatic backups\n- Removes cron job (Linux) or launchd agent (macOS)\n\n**When to use:**\n- Temporarily pausing backups\n- Before making major workspace changes\n- If backups are causing issues\n\n**To restart:** `checkpoint-schedule hourly` (or any frequency)\n\n## Setup\n\n### Easy Setup (Recommended)\n\nJust run the interactive wizard:\n\n```bash\ncheckpoint-setup\n```\n\nThis handles everything: git init, SSH keys, GitHub setup, and first backup.\n\n### First Time Setup (Manual)\n\n```bash\n# 1. Initialize checkpoint system\ncheckpoint-init\n\n# 2. Create PRIVATE GitHub repository\n# Go to https://github.com/new\n# Name: openclaw-state\n# ⚠️  Visibility: PRIVATE (important - contains your personal data!)\n\n# 3. Add remote (use SSH, not HTTPS)\ncd ~/.openclaw/workspace\ngit remote add origin git@github.com:YOURUSER/openclaw-state.git\ncheckpoint-backup\n```\n\n### Setup on Second Machine\n\n**Option 1: Interactive Restore (Recommended)**\n\n```bash\n# Install the checkpoint skill first\ncurl -fsSL https://raw.githubusercontent.com/AnthonyFrancis/openclaw-checkpoint/main/scripts/install-openclaw-checkpoint.sh | bash\n\n# Run checkpoint-restore - it will guide you through the entire process\ncheckpoint-restore\n```\n\nThis will:\n- Help you authenticate with GitHub (if not already)\n- Ask for your backup repository details\n- Clone/restore your checkpoint automatically\n\n**Option 2: Manual Clone**\n\n```bash\n# 1. Clone repository (use SSH)\ngit clone git@github.com:YOURUSER/openclaw-state.git ~/.openclaw/workspace\n\n# 2. Restore secrets from 1Password/password manager\n# Create ~/.openclaw/workspace/.env.thisweek\n# Create ~/.openclaw/workspace/.env.stripe\n# (Copy from secure storage)\n\n# 3. Start OpenClaw\nopenclaw gateway start\n```\n\n## Automated Backups\n\n### Easy Setup (Recommended)\n\n```bash\n# Enable hourly backups\ncheckpoint-schedule hourly\n\n# Or choose your frequency:\ncheckpoint-schedule 15min   # Every 15 minutes - high activity\ncheckpoint-schedule 30min   # Every 30 minutes - medium activity  \ncheckpoint-schedule 2hours  # Every 2 hours - low activity\ncheckpoint-schedule daily   # Once per day - minimal activity\n```\n\n### Check Status\n\n```bash\ncheckpoint-status\n```\n\nShows:\n- Last backup time\n- Whether synced with remote\n- Auto-backup schedule\n- Recent activity log\n\n## Multi-Agent Backup\n\nThe checkpoint system automatically detects and backs up all agents from `~/.openclaw/agents/`.\n\n### How It Works\n\n- On **backup**: Agent folders are copied from `~/.openclaw/agents/` into `agents/` inside the backup repo, with nested `.git` directories stripped\n- On **restore**: Agent folders are copied from `agents/` in the backup repo back to `~/.openclaw/agents/`\n- If no agents exist, all commands skip agent handling gracefully\n\n### File Structure in Backup Repo\n\n```\n~/.openclaw/workspace/          (backup repo root)\n  SOUL.md\n  MEMORY.md\n  memory/\n  agents/                       (auto-created when agents exist)\n    alex/                       (copied from ~/.openclaw/agents/alex/)\n    blake/                      (copied from ~/.openclaw/agents/blake/)\n```\n\n### Agent Flags\n\nThese flags work on `checkpoint-backup` and `checkpoint-restore`:\n\n| Flag | Description |\n|------|-------------|\n| `--workspace-only` | Skip agent backup/restore entirely |\n| `--agents-only` | Skip workspace and cron, only operate on agents |\n| `--agent <name>` | Operate on a single named agent only |\n\n### Examples\n\n```bash\n# Backup everything (default)\ncheckpoint-backup\n\n# Backup only agents\ncheckpoint-backup --agents-only\n\n# Backup only the 'alex' agent\ncheckpoint-backup --agent alex\n\n# Restore workspace but skip agents\ncheckpoint-restore --latest --workspace-only\n\n# Restore only agents from backup\ncheckpoint-restore --agents-only\n\n# Check which agents are backed up\ncheckpoint-status\n```\n\n### Backwards Compatibility\n\n- If `~/.openclaw/agents/` does not exist or is empty, all commands skip agent handling with an info message\n- Old backup repos without an `agents/` directory work fine -- restore simply skips agents\n- No existing behavior changes when no agents are present\n\n## Cross-Machine Portability\n\nWhen you back up on one machine (e.g. `/Users/jerry`) and restore on another (e.g. `/Users/tom`), hardcoded absolute home-directory paths in workspace files would break. The checkpoint system handles this automatically.\n\n### How It Works\n\n- **On backup:** All occurrences of your `$HOME` path (e.g. `/Users/jerry`) are replaced with the placeholder `{{HOME}}` in text files. A `.checkpoint-meta.json` file is written with the source machine's details.\n- **On restore:** The `{{HOME}}` placeholder is expanded to the current machine's `$HOME` (e.g. `/Users/tom`). For backwards compatibility with older backups that were created before normalization, any remaining literal old home paths are also rewritten.\n\n### What Gets Processed\n\nOnly text files likely to contain paths are scanned:\n- `*.md`, `*.json`, `*.sh`, `*.txt`, `*.yaml`, `*.yml`, `*.toml`, `*.cfg`, `*.conf`\n\nBinary files, `.git/`, and `node_modules/` are never touched.\n\n### .checkpoint-meta.json\n\nThis file is auto-generated on each backup and records the source machine:\n\n```json\n{\n  \"source_home\": \"/Users/jerry\",\n  \"source_user\": \"jerry\",\n  \"hostname\": \"Jerrys-MacBook-Pro\"\n}\n```\n\nOn restore, this metadata tells the script which old paths to rewrite. The file is updated after restore to reflect the current machine.\n\n### Manual Cron Setup (Advanced)\n\nIf you prefer manual cron:\n\n```bash\n# Edit crontab\ncrontab -e\n\n# Add line for hourly backups:\n0 * * * * /Users/$(whoami)/.openclaw/workspace/skills/openclaw-checkpoint/scripts/checkpoint-backup >> ~/.openclaw/logs/checkpoint.log 2>&1\n```\n\n## Disaster Recovery Workflow\n\n**Scenario: Home server dies**\n\n```bash\n# On new machine:\n\n# 1. Install OpenClaw\nbrew install openclaw  # or your install method\n\n# 2. Install checkpoint skill and run interactive restore\ncurl -fsSL https://raw.githubusercontent.com/AnthonyFrancis/openclaw-checkpoint/main/scripts/install-openclaw-checkpoint.sh | bash\ncheckpoint-restore\n# Follow the interactive prompts to:\n# - Authenticate with GitHub\n# - Enter your backup repository (e.g., YOURUSER/openclaw-state)\n# - Restore your checkpoint\n\n# 3. Restore secrets from 1Password (API keys are not backed up for security)\ncat > ~/.openclaw/workspace/.env.thisweek << 'EOF'\nTHISWEEK_API_KEY=your_key_here\nEOF\n\n# 4. Start OpenClaw\nopenclaw gateway start\n\n# 5. Cron jobs are restored automatically during checkpoint-restore\n# (if the gateway is running and cron backup exists)\n\n# 6. Enable automatic backups on this machine\ncheckpoint-schedule hourly\n\n# 7. Verify\n# Ask assistant: \"What were we working on?\"\n# Should recall everything up to last checkpoint, with all scheduled tasks restored\n```\n\n## Security Considerations\n\n### ⚠️ CRITICAL: Repository MUST be PRIVATE\n\nYour backup contains sensitive personal data:\n- SOUL.md, MEMORY.md (your identity & memories)\n- Personal notes and conversation history\n- Custom scripts and configurations\n\n**If you make the repo public, anyone can see your data!**\n\n**What gets backed up:**\n- ✅ Memory files (conversation history)\n- ✅ Identity files (SOUL.md, etc.)\n- ✅ Cron jobs (memory/cron-jobs-backup.json)\n- ✅ Scripts and tools\n- ✅ Configuration\n- ✅ Agents (~/.openclaw/agents/ -> agents/ in backup repo)\n\n**What does NOT get backed up:**\n- ❌ API keys (.env.*) — keep in 1Password\n- ❌ OAuth tokens — re-authenticate on new machine\n- ❌ Downloaded media — ephemeral\n- ❌ Temporary files — ephemeral\n\n**Best practices:**\n- **Always use a PRIVATE repository**\n- Use SSH authentication (no token expiry)\n- Store API keys in password manager, not in backed-up files\n- Enable 2FA on GitHub account\n- Consider encrypting sensitive notes before adding to memory\n\n### Permissions and Scheduling\n\nThis skill uses standard system scheduling to automate backups:\n\n- **macOS**: Creates a launchd plist at `~/Library/LaunchAgents/com.openclaw.checkpoint.plist`\n- **Linux**: Adds a user-level cron job (visible via `crontab -l`)\n\nAuto-backup is **opt-in only** -- it is never enabled unless you explicitly run `checkpoint-schedule`. You can disable it at any time with `checkpoint-stop` or `checkpoint-schedule disable`.\n\nThe skill does **not** install any background daemons, system services, or root-level processes. All scheduling runs under your user account.\n\n**File access scope**: The skill reads from `~/.openclaw/workspace` and `~/.openclaw/agents/` (for multi-agent backup). It writes backup copies of agents into `~/.openclaw/workspace/agents/`. On restore, it copies agents back to `~/.openclaw/agents/`. Sensitive files (.env.*, credentials, OAuth tokens) are excluded from backups via .gitignore.\n\n## Troubleshooting\n\n### \"Not a git repository\" or \"'origin' does not appear to be a git repository\"\nRunning `checkpoint-restore` will now automatically start the interactive restore onboarding flow to help you connect to your backup repository. Alternatively, run `checkpoint-setup` to create a new backup from scratch.\n\n### \"Failed to push checkpoint\"\nAnother machine pushed changes. Run `checkpoint-restore` first, then `checkpoint-backup`.\n\n### \"You have uncommitted changes\"\n`checkpoint-restore` will prompt you to choose:\n1. Save changes first (runs `checkpoint-backup`)\n2. Discard local changes and continue\n3. Cancel\n\nYou can also skip the prompt with `checkpoint-restore --force` to discard changes directly.\n\n### Behind remote after restore\nThis is expected if another machine checkpointed since you last synced.\n\n### GitHub prompting for username/password\nGitHub no longer accepts password authentication for HTTPS. Switch to SSH:\n```bash\ncd ~/.openclaw/workspace\ngit remote set-url origin git@github.com:YOURUSER/REPO.git\n```\n\n### \"Host key verification failed\"\nGitHub's SSH host key isn't in your known_hosts. Fix with:\n```bash\nssh-keyscan -t ed25519 github.com >> ~/.ssh/known_hosts\n```\n\n### \"Permission denied (publickey)\"\nYour SSH key isn't added to GitHub. Run `checkpoint-auth` and choose SSH option.\n\n### GitHub repo is empty after setup\nThe old `checkpoint-init` only committed `.gitignore`. This is fixed now. Run:\n```bash\ncd ~/.openclaw/workspace && git add -A && git commit -m \"Full backup\" && git push\n```\n\n### Starting fresh\nRun `checkpoint-reset` to remove local git repo and optionally SSH keys, then `checkpoint-setup`.\n\n### Agents not being backed up\nCheck that your agents are in `~/.openclaw/agents/` (not somewhere else). Run `checkpoint-status` to see which agents are detected and which are backed up. Make sure you're not passing `--workspace-only`.\n\n### Agent has nested .git errors\nThe backup process automatically strips `.git` directories from agent copies. If you see submodule warnings, run a fresh backup:\n```bash\nrm -rf ~/.openclaw/workspace/agents\ncheckpoint-backup\n```\n\n### Restored agents missing files\nAgent restore copies the backup as-is. If the backup was taken before certain files were added to the agent, those files won't be present. Run `checkpoint-backup` on the source machine first to capture the latest state.\n\n### \"Permission denied, mkdir '/Users/olduser'\" after restoring on a new machine\nThis means files contain hardcoded paths from the original machine. If the backup was created before path normalization was added, run:\n```bash\ncd ~/.openclaw/workspace\ngrep -rl \"/Users/olduser\" --include=\"*.md\" --include=\"*.json\" --include=\"*.sh\" | \\\n  xargs sed -i '' \"s|/Users/olduser|$HOME|g\"\n```\nFuture backups will normalize paths automatically.\n\n### Files show {{HOME}} instead of real paths\nThis is expected **in the backup repo on GitHub**. The `{{HOME}}` placeholder is replaced with the real `$HOME` path on each restore. If you see `{{HOME}}` in your local workspace after a restore, run `checkpoint-restore --latest` again.\n\n## Limitations\n\n- **Single machine at a time**: Don't run OpenClaw on multiple machines simultaneously\n- **Max data loss**: 1 hour if using hourly backups (cron)\n- **Secrets not synced**: Must restore API keys manually on new machine\n- **Large files**: GitHub has 100MB file limit (your text files are fine)\n\n## File Reference\n\nSee [references/setup.md](references/setup.md) for detailed setup instructions.\n","tags":{"latest":"1.0.5"},"stats":{"comments":0,"downloads":3496,"installsAllTime":132,"installsCurrent":10,"stars":2,"versions":6},"createdAt":1770093560802,"updatedAt":1778987996781},"latestVersion":{"version":"1.0.5","createdAt":1771412267814,"changelog":"openclaw-checkpoint v1.0.5\n\n- Adds support for backing up and restoring agents (~/.openclaw/agents/) with workspace.\n- Introduces new backup/restore flags: --workspace-only, --agents-only, and --agent <name> for granular control.\n- Updates descriptions and help to reflect multi-agent support.\n- checkpoint-status now reports agent backup status.\n- More robust agent folder handling: skips gracefully if no agents found, strips nested .git dirs for portability.","license":null},"metadata":null,"owner":{"handle":"anthonyfrancis","userId":"s174m0mda941ckfy30qp453cxh83k214","displayName":"Anthony Francis","image":"https://avatars.githubusercontent.com/u/3010099?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1779943053257}}