[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6MTSMXNKZNSY323BWBS33J2":3,"skill-same:01M6MTSMXNKZNSY323BWBS33J2":84},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":22,"publishedAt":43,"linkOnly":44,"markdownContent":45,"markdownBody":46,"frontMatter":47,"refName":48,"commitSha":49,"skillDirectory":50,"forksCount":51,"repositoryHtmlUrl":52,"repositoryHomepageUrl":6,"ownerHtmlUrl":53,"ownerBlogUrl":6,"ownerDescription":54,"updatedAt":55,"install":56,"resources":69},"01M6MTSMXNKZNSY323BWBS33J2","openclaw-checkpoint",null,"Backup and restore OpenClaw workspace state across machines using git. Enables disaster recovery by syncing SOUL.md, MEMORY.md, memory files, 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-setup (interactive onboarding), checkpoint, checkpoint-resume, checkpoint-schedule (auto-backup), checkpoint-stop, checkpoint-status, checkpoint-init, and checkpoint-reset.","Kernel8901\u002Fai-agent-skills-classification","Kernel8901","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F72647553?v=4","01M6KV388J2H5PNC8D8P940BJD","01M6KV38CS5B3AY63RKZB410YM",7,"MIT","https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002FGit和GitHub\u002Fopenclaw-checkpoint\u002FSKILL.md",[17],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000038","人力资源","PROFESSION","适用职业",[23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42],"openclaw checkpoint","checkpoint","openclaw","auto","remote","SOUL.md","reset","commands","across","soul","files","stop","schedule","migrate","data","repository","git","status","init","memory","2026-11-10 10:12:30",false,"---\nname: openclaw-checkpoint\ndescription: Backup and restore OpenClaw workspace state across machines using git. Enables disaster recovery by syncing SOUL.md, MEMORY.md, memory files, 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-setup (interactive onboarding), checkpoint, checkpoint-resume, checkpoint-schedule (auto-backup), checkpoint-stop, checkpoint-status, checkpoint-init, and checkpoint-reset.\n---\n\n# OpenClaw Checkpoint Skill\n\nBackup and restore your OpenClaw identity, memory, 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 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\u002F*.md files (conversation history and context)\n- **Configuration**: TOOLS.md, AGENTS.md, HEARTBEAT.md (tool setups and conventions)\n- **Scripts**: Custom tools and automation you've built\n\n**Not synced** (security): API keys (.env.*), credentials, OAuth tokens\n\n## Installation\n\n### Option 1: One-Liner Install (Recommended)\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FAnthonyFrancis\u002Fopenclaw-checkpoint\u002Fmain\u002Fscripts\u002Finstall-openclaw-checkpoint.sh | bash\n```\n\nThis will:\n- Download and install the skill\n- Add commands to your PATH automatically\n- Offer to run the interactive setup wizard\n\n### Option 2: Manual Install\n\n```bash\n# Clone the skill repo\ngit clone https:\u002F\u002Fgithub.com\u002FAnthonyFrancis\u002Fopenclaw-checkpoint.git ~\u002F.openclaw\u002Fskills\u002Fopenclaw-checkpoint\n\n# Copy scripts to tools directory\nmkdir -p ~\u002F.openclaw\u002Fworkspace\u002Ftools\ncp ~\u002F.openclaw\u002Fskills\u002Fopenclaw-checkpoint\u002Fscripts\u002Fcheckpoint* ~\u002F.openclaw\u002Fworkspace\u002Ftools\u002F\nchmod +x ~\u002F.openclaw\u002Fworkspace\u002Ftools\u002Fcheckpoint*\n\n# Add to PATH (also add to ~\u002F.zshrc or ~\u002F.bashrc for persistence)\nexport PATH=\"${HOME}\u002F.openclaw\u002Fworkspace\u002Ftools:${PATH}\"\n\n# Run setup wizard\ncheckpoint-setup\n```\n\n## Commands\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- Generates a README.md with recovery instructions and commands\n- Commits ALL workspace files (not just .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\nSave current state to remote repository.\n\n```bash\ncheckpoint\n```\n\n**What it does:**\n- Commits all changes in ~\u002F.openclaw\u002Fworkspace\n- Pushes to origin\u002Fmain\n- Shows commit hash and timestamp\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 ~\u002F.openclaw\u002Flogs\u002Fcheckpoint.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- 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-resume\nRestore state from remote repository, with first-time onboarding.\n\n```bash\ncheckpoint-resume          # Normal resume (or onboarding if not set up)\ncheckpoint-resume --force  # Discard local changes, pull remote\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\u002Freplace options if local files exist\n- **Returning users:** Fetches and pulls latest changes from remote\n\n**When to use:**\n- Starting OpenClaw on a new machine\n- After hardware failure\u002Fdisaster\n- When resuming work on different computer\n- First-time restore from an existing backup\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 ~\u002F.openclaw\u002Fworkspace\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- Reminds you to delete the GitHub repo manually\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:\u002F\u002Fgithub.com\u002Fnew\n# Name: openclaw-state\n# ⚠️  Visibility: PRIVATE (important - contains your personal data!)\n\n# 3. Add remote (use SSH, not HTTPS)\ncd ~\u002F.openclaw\u002Fworkspace\ngit remote add origin git@github.com:YOURUSER\u002Fopenclaw-state.git\ncheckpoint\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:\u002F\u002Fraw.githubusercontent.com\u002FAnthonyFrancis\u002Fopenclaw-checkpoint\u002Fmain\u002Fscripts\u002Finstall-openclaw-checkpoint.sh | bash\n\n# Run checkpoint-resume - it will guide you through the entire process\ncheckpoint-resume\n```\n\nThis will:\n- Help you authenticate with GitHub (if not already)\n- Ask for your backup repository details\n- Clone\u002Frestore your checkpoint automatically\n\n**Option 2: Manual Clone**\n\n```bash\n# 1. Clone repository (use SSH)\ngit clone git@github.com:YOURUSER\u002Fopenclaw-state.git ~\u002F.openclaw\u002Fworkspace\n\n# 2. Restore secrets from 1Password\u002Fpassword manager\n# Create ~\u002F.openclaw\u002Fworkspace\u002F.env.thisweek\n# Create ~\u002F.openclaw\u002Fworkspace\u002F.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### 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 * * * * \u002FUsers\u002F$(whoami)\u002F.openclaw\u002Fworkspace\u002Fskills\u002Fopenclaw-checkpoint\u002Fscripts\u002Fcheckpoint >> ~\u002F.openclaw\u002Flogs\u002Fcheckpoint.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:\u002F\u002Fraw.githubusercontent.com\u002FAnthonyFrancis\u002Fopenclaw-checkpoint\u002Fmain\u002Fscripts\u002Finstall-openclaw-checkpoint.sh | bash\ncheckpoint-resume\n# Follow the interactive prompts to:\n# - Authenticate with GitHub\n# - Enter your backup repository (e.g., YOURUSER\u002Fopenclaw-state)\n# - Restore your checkpoint\n\n# 3. Restore secrets from 1Password (API keys are not backed up for security)\ncat > ~\u002F.openclaw\u002Fworkspace\u002F.env.thisweek \u003C\u003C 'EOF'\nTHISWEEK_API_KEY=your_key_here\nEOF\n\n# 4. Enable automatic backups on this machine\ncheckpoint-schedule hourly\n\n# 5. Start OpenClaw\nopenclaw gateway start\n\n# 6. Verify\n# Ask assistant: \"What were we working on?\"\n# Should recall everything up to last checkpoint\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- ✅ Scripts and tools\n- ✅ Configuration\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## Troubleshooting\n\n### \"Not a git repository\" or \"'origin' does not appear to be a git repository\"\nRunning `checkpoint-resume` 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-resume` first, then `checkpoint`.\n\n### \"You have uncommitted changes\"\nYou have local work that isn't checkpointed. Either:\n- Run `checkpoint` to save it first\n- Or `checkpoint-resume --force` to discard it\n\n### Behind remote after resume\nThis is expected if another machine checkpointed since you last synced.\n\n### GitHub prompting for username\u002Fpassword\nGitHub no longer accepts password authentication for HTTPS. Switch to SSH:\n```bash\ncd ~\u002F.openclaw\u002Fworkspace\ngit remote set-url origin git@github.com:YOURUSER\u002FREPO.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 >> ~\u002F.ssh\u002Fknown_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 ~\u002F.openclaw\u002Fworkspace && 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## 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\u002Fsetup.md](references\u002Fsetup.md) for detailed setup instructions.\n","# OpenClaw Checkpoint Skill\n\nBackup and restore your OpenClaw identity, memory, 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 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\u002F*.md files (conversation history and context)\n- **Configuration**: TOOLS.md, AGENTS.md, HEARTBEAT.md (tool setups and conventions)\n- **Scripts**: Custom tools and automation you've built\n\n**Not synced** (security): API keys (.env.*), credentials, OAuth tokens\n\n## Installation\n\n### Option 1: One-Liner Install (Recommended)\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FAnthonyFrancis\u002Fopenclaw-checkpoint\u002Fmain\u002Fscripts\u002Finstall-openclaw-checkpoint.sh | bash\n```\n\nThis will:\n- Download and install the skill\n- Add commands to your PATH automatically\n- Offer to run the interactive setup wizard\n\n### Option 2: Manual Install\n\n```bash\n# Clone the skill repo\ngit clone https:\u002F\u002Fgithub.com\u002FAnthonyFrancis\u002Fopenclaw-checkpoint.git ~\u002F.openclaw\u002Fskills\u002Fopenclaw-checkpoint\n\n# Copy scripts to tools directory\nmkdir -p ~\u002F.openclaw\u002Fworkspace\u002Ftools\ncp ~\u002F.openclaw\u002Fskills\u002Fopenclaw-checkpoint\u002Fscripts\u002Fcheckpoint* ~\u002F.openclaw\u002Fworkspace\u002Ftools\u002F\nchmod +x ~\u002F.openclaw\u002Fworkspace\u002Ftools\u002Fcheckpoint*\n\n# Add to PATH (also add to ~\u002F.zshrc or ~\u002F.bashrc for persistence)\nexport PATH=\"${HOME}\u002F.openclaw\u002Fworkspace\u002Ftools:${PATH}\"\n\n# Run setup wizard\ncheckpoint-setup\n```\n\n## Commands\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- Generates a README.md with recovery instructions and commands\n- Commits ALL workspace files (not just .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\nSave current state to remote repository.\n\n```bash\ncheckpoint\n```\n\n**What it does:**\n- Commits all changes in ~\u002F.openclaw\u002Fworkspace\n- Pushes to origin\u002Fmain\n- Shows commit hash and timestamp\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 ~\u002F.openclaw\u002Flogs\u002Fcheckpoint.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- 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-resume\nRestore state from remote repository, with first-time onboarding.\n\n```bash\ncheckpoint-resume          # Normal resume (or onboarding if not set up)\ncheckpoint-resume --force  # Discard local changes, pull remote\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\u002Freplace options if local files exist\n- **Returning users:** Fetches and pulls latest changes from remote\n\n**When to use:**\n- Starting OpenClaw on a new machine\n- After hardware failure\u002Fdisaster\n- When resuming work on different computer\n- First-time restore from an existing backup\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 ~\u002F.openclaw\u002Fworkspace\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- Reminds you to delete the GitHub repo manually\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:\u002F\u002Fgithub.com\u002Fnew\n# Name: openclaw-state\n# ⚠️  Visibility: PRIVATE (important - contains your personal data!)\n\n# 3. Add remote (use SSH, not HTTPS)\ncd ~\u002F.openclaw\u002Fworkspace\ngit remote add origin git@github.com:YOURUSER\u002Fopenclaw-state.git\ncheckpoint\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:\u002F\u002Fraw.githubusercontent.com\u002FAnthonyFrancis\u002Fopenclaw-checkpoint\u002Fmain\u002Fscripts\u002Finstall-openclaw-checkpoint.sh | bash\n\n# Run checkpoint-resume - it will guide you through the entire process\ncheckpoint-resume\n```\n\nThis will:\n- Help you authenticate with GitHub (if not already)\n- Ask for your backup repository details\n- Clone\u002Frestore your checkpoint automatically\n\n**Option 2: Manual Clone**\n\n```bash\n# 1. Clone repository (use SSH)\ngit clone git@github.com:YOURUSER\u002Fopenclaw-state.git ~\u002F.openclaw\u002Fworkspace\n\n# 2. Restore secrets from 1Password\u002Fpassword manager\n# Create ~\u002F.openclaw\u002Fworkspace\u002F.env.thisweek\n# Create ~\u002F.openclaw\u002Fworkspace\u002F.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### 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 * * * * \u002FUsers\u002F$(whoami)\u002F.openclaw\u002Fworkspace\u002Fskills\u002Fopenclaw-checkpoint\u002Fscripts\u002Fcheckpoint >> ~\u002F.openclaw\u002Flogs\u002Fcheckpoint.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:\u002F\u002Fraw.githubusercontent.com\u002FAnthonyFrancis\u002Fopenclaw-checkpoint\u002Fmain\u002Fscripts\u002Finstall-openclaw-checkpoint.sh | bash\ncheckpoint-resume\n# Follow the interactive prompts to:\n# - Authenticate with GitHub\n# - Enter your backup repository (e.g., YOURUSER\u002Fopenclaw-state)\n# - Restore your checkpoint\n\n# 3. Restore secrets from 1Password (API keys are not backed up for security)\ncat > ~\u002F.openclaw\u002Fworkspace\u002F.env.thisweek \u003C\u003C 'EOF'\nTHISWEEK_API_KEY=your_key_here\nEOF\n\n# 4. Enable automatic backups on this machine\ncheckpoint-schedule hourly\n\n# 5. Start OpenClaw\nopenclaw gateway start\n\n# 6. Verify\n# Ask assistant: \"What were we working on?\"\n# Should recall everything up to last checkpoint\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- ✅ Scripts and tools\n- ✅ Configuration\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## Troubleshooting\n\n### \"Not a git repository\" or \"'origin' does not appear to be a git repository\"\nRunning `checkpoint-resume` 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-resume` first, then `checkpoint`.\n\n### \"You have uncommitted changes\"\nYou have local work that isn't checkpointed. Either:\n- Run `checkpoint` to save it first\n- Or `checkpoint-resume --force` to discard it\n\n### Behind remote after resume\nThis is expected if another machine checkpointed since you last synced.\n\n### GitHub prompting for username\u002Fpassword\nGitHub no longer accepts password authentication for HTTPS. Switch to SSH:\n```bash\ncd ~\u002F.openclaw\u002Fworkspace\ngit remote set-url origin git@github.com:YOURUSER\u002FREPO.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 >> ~\u002F.ssh\u002Fknown_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 ~\u002F.openclaw\u002Fworkspace && 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## 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\u002Fsetup.md](references\u002Fsetup.md) for detailed setup instructions.\n",{"name":5,"description":7},"main","f4cb2d49f7667e79ef7804f50396d5aaffdf1f56","Git和GitHub\u002Fopenclaw-checkpoint",1,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification","https:\u002F\u002Fgithub.com\u002FKernel8901","a little little little dobe in life but science geek","2026-04-05 16:43:56",{"source":8,"skillName":5,"commands":57,"prompt":67,"zipAvailable":68},[58,61,64],{"tool":59,"command":60},"npx","npx skills add Kernel8901\u002Fai-agent-skills-classification --skill openclaw-checkpoint",{"tool":62,"command":63},"bunx","bunx skills add Kernel8901\u002Fai-agent-skills-classification --skill openclaw-checkpoint",{"tool":65,"command":66},"pnpm","pnpm dlx skills add Kernel8901\u002Fai-agent-skills-classification --skill openclaw-checkpoint","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002FGit和GitHub\u002Fopenclaw-checkpoint\u002FSKILL.md",true,[70,76,80],{"path":71,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":74,"sourceHtmlUrl":75},"_meta.json","REFERENCE","参考文档",340,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002FGit和GitHub\u002Fopenclaw-checkpoint\u002F_meta.json",{"path":77,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":78,"sourceHtmlUrl":79},"INSTALL.md",1988,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002FGit和GitHub\u002Fopenclaw-checkpoint\u002FINSTALL.md",{"path":81,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":82,"sourceHtmlUrl":83},"README.md",4679,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002FGit和GitHub\u002Fopenclaw-checkpoint\u002FREADME.md",[85,109,142,153,163,193],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":43},"01M6Q5R6WZ06RRB9RQTW54B34B","zyfai","Earn yield on any Ethereum wallet on Base, Arbitrum, and Plasma. Use when a user wants passive DeFi yield on their funds. Deploys a non-custodial subaccount (Safe) linked to their EOA, enables automated yield optimization, and lets them deposit\u002Fwithdraw anytime.","https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F金融\u002Fzyfai-sdk\u002FSKILL.md",[],[87,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108],"safe","ethereum","defi","Optimization","user","use","Wallet","base","deposit","withdraw","yield","arbitrum","non-custodial","passive","defi yield","earn","yield optimization",{"skillNo":110,"name":111,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":112,"categories":113,"keywords":125,"publishedAt":43},"01M6Q5R337B5JSNER4P4YS03TN","zerion-api","https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F金融\u002Fzerion-api\u002FSKILL.md",[114,119,122],{"categoryNo":115,"categoryName":116,"taxonomyType":117,"taxonomyTypeDesc":118},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",{"categoryNo":120,"categoryName":121,"taxonomyType":117,"taxonomyTypeDesc":118},"01JBSEEDCAT000000000000023","Skill与智能体开发",{"categoryNo":123,"categoryName":124,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000030","开发工程师",[126,127,128,129,130,131,132,94,133,98,134,135,136,137,138,31,139,140,141],"api","zerion api","zerion","MCP","mcp server","server","blockchain","transactions","crypto wallet","crypto","evm","solana","query","positions","token","prices",{"skillNo":143,"name":144,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":145,"categories":146,"keywords":150,"publishedAt":43},"01M6Q5QZFYTDAZMZ27BN5VZXAR","zerion-api-skill","https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F金融\u002Fzerion-api-skill\u002FSKILL.md",[147,148,149],{"categoryNo":115,"categoryName":116,"taxonomyType":117,"taxonomyTypeDesc":118},{"categoryNo":120,"categoryName":121,"taxonomyType":117,"taxonomyTypeDesc":118},{"categoryNo":123,"categoryName":124,"taxonomyType":20,"taxonomyTypeDesc":21},[126,151,152,127,128,129,130,131,132,94,133,98,135,136,137,138,31,139,140,141],"api skill","zerion api skill",{"skillNo":154,"name":155,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":156,"categories":157,"keywords":161,"publishedAt":43},"01M6Q5QW17QW98RA3FE45E4RD8","zerion-api-mcp","https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F金融\u002Fzerion-api-mcp\u002FSKILL.md",[158,159,160],{"categoryNo":115,"categoryName":116,"taxonomyType":117,"taxonomyTypeDesc":118},{"categoryNo":120,"categoryName":121,"taxonomyType":117,"taxonomyTypeDesc":118},{"categoryNo":123,"categoryName":124,"taxonomyType":20,"taxonomyTypeDesc":21},[129,126,162,127,128,130,131,94,133,98,134,135,136,137,138,31,139,140,141],"zerion api mcp",{"skillNo":164,"name":165,"nameZh":6,"description":166,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":167,"categories":168,"keywords":172,"publishedAt":43},"01M6Q5QQYZB7A501BDEQWKGSJT","yahoo-finance-forex","Fetches real-time FOREX news and market data from Yahoo Finance for major currency pairs (EUR\u002FUSD, GBP\u002FUSD, USD\u002FJPY, etc.). Analyzes sentiment and provides trading context.","https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F金融\u002Fyahoo-finance-forex\u002FSKILL.md",[169],{"categoryNo":170,"categoryName":171,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000040","财务",[173,174,175,176,177,178,179,180,181,182,183,184,185,186,187,188,189,190,191,192],"finance","yahoo finance","forex","yahoo","yahoo finance forex","github","https","sentiment","real-time","python3","install","Market","usd","news","time","currency","gbp","pip","market data","for",{"skillNo":194,"name":195,"nameZh":6,"description":196,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":197,"categories":198,"keywords":200,"publishedAt":43},"01M6Q5QM6VS84WZVM7BKXXPF32","yahoo-finance","This skill should be used when the user asks to \"get stock prices\", \"check stock quotes\", \"look up earnings\", \"get financial data\", \"find trending stocks\", or needs stock market data from Yahoo Finance.","https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F金融\u002Fyahoo-finance-cli\u002FSKILL.md",[199],{"categoryNo":170,"categoryName":171,"taxonomyType":20,"taxonomyTypeDesc":21},[173,174,176,201,202,203,204,205,206,184,207,208,209,210,211,212,213,214,141,191],"cli","homebrew","find","check","brew","up","local","get","stock","link","trending","sf","quotes","ln"]