skills$openclaw/savestate
dbhurley1.9k

by dbhurley

savestate – OpenClaw Skill

savestate is an OpenClaw Skills integration for coding workflows. Time Machine for AI. Encrypted backup, restore, and cross-platform migration for your agent's memory and identity. Supports OpenClaw, ChatGPT, Claude, Gemini, and more. AES-256-GCM encryption with user-controlled keys.

1.9k stars7.4k forksSecurity L1
Updated Feb 7, 2026Created Feb 7, 2026coding

Skill Snapshot

namesavestate
descriptionTime Machine for AI. Encrypted backup, restore, and cross-platform migration for your agent's memory and identity. Supports OpenClaw, ChatGPT, Claude, Gemini, and more. AES-256-GCM encryption with user-controlled keys. OpenClaw Skills integration.
ownerdbhurley
repositorydbhurley/savestate
languageMarkdown
licenseMIT
topics
securityL1
installopenclaw add @dbhurley/savestate
last updatedFeb 7, 2026

Maintainer

dbhurley

dbhurley

Maintains savestate in the OpenClaw Skills directory.

View GitHub profile
File Explorer
2 files
.
_meta.json
272 B
SKILL.md
4.8 KB
SKILL.md

name: savestate description: Time Machine for AI. Encrypted backup, restore, and cross-platform migration for your agent's memory and identity. Supports OpenClaw, ChatGPT, Claude, Gemini, and more. AES-256-GCM encryption with user-controlled keys. user-invocable: true metadata: {"openclaw":{"emoji":"💾","primaryEnv":"SAVESTATE_API_KEY"}}

SaveState — Time Machine for AI

SaveState creates encrypted point-in-time snapshots of your AI agent's state — memory, identity, conversations, and configuration. Unlike live-sync tools, SaveState gives you versioned backups you can restore, compare, and migrate across platforms.

Key differentiators:

  • 🔐 AES-256-GCM encryption with user-controlled keys
  • 🔄 Cross-platform migration (ChatGPT → Claude → OpenClaw, etc.)
  • 📊 Incremental snapshots with diff comparison
  • ⏰ Scheduled automatic backups (Pro/Team)
  • ☁️ Cloud storage with zero-knowledge encryption (Pro/Team)

Installation

# npm
npm install -g @savestate/cli

# Homebrew
brew tap savestatedev/tap && brew install savestate

# Direct install
curl -fsSL https://savestate.dev/install.sh | sh

Quick Start

Initialize (first time)

savestate init

This creates a .savestate/ directory with your encryption key. Back up your key — it's the only way to decrypt your snapshots.

Create a snapshot

savestate snapshot

Captures your current agent state to an encrypted archive.

List snapshots

savestate list
# or
savestate ls

Restore from snapshot

# Restore latest
savestate restore

# Restore specific snapshot
savestate restore ss-2026-02-01T12-00-00

Compare snapshots

savestate diff ss-2026-01-15 ss-2026-02-01

Platform Adapters

SaveState works with multiple AI platforms:

PlatformAdapterCapabilities
OpenClawopenclawFull backup & restore
Claude Codeclaude-codeFull backup & restore
OpenAI Assistantsopenai-assistantsFull backup & restore
ChatGPTchatgptExport + memory restore
Claude.aiclaudeExport + memory restore
GeminigeminiExport (via Takeout)

List available adapters:

savestate adapters

Cross-Platform Migration

Migrate your AI's identity between platforms:

# Migrate from ChatGPT to Claude
savestate migrate --from chatgpt --to claude

# Restore a ChatGPT snapshot to OpenClaw
savestate restore ss-chatgpt-2026-01-15 --to openclaw

Cloud Storage (Pro/Team)

With a Pro ($9/mo) or Team ($29/mo) subscription:

# Login to SaveState cloud
savestate login

# Push snapshots to cloud
savestate cloud push

# Pull from cloud on new device
savestate cloud pull

# Schedule automatic backups
savestate schedule --every 6h

Sign up at https://savestate.dev

What Gets Backed Up

OpenClaw/Clawdbot

  • SOUL.md, IDENTITY.md, USER.md — Identity files
  • MEMORY.md, memory/*.md — Memory and daily logs
  • TOOLS.md, HEARTBEAT.md — Configuration
  • skills/ — Installed skills and customizations
  • Session transcripts (optional)

Claude Code

  • CLAUDE.md — System prompt
  • .claude/ — Settings and memory
  • Project manifest and todos

ChatGPT/Claude.ai/Gemini

  • Conversation history export
  • Custom instructions / system prompts
  • Memory entries

Automation Examples

Cron backup (OpenClaw heartbeat)

Add to HEARTBEAT.md:

## SaveState backup check
- If more than 24h since last snapshot, run: savestate snapshot
- Check with: savestate ls --json | jq '.[0].timestamp'

Pre-migration checklist

Before switching platforms:

  1. savestate snapshot — Create fresh backup
  2. savestate cloud push — Sync to cloud (if Pro)
  3. savestate migrate --from X --to Y — Run migration

Security

  • Encryption: AES-256-GCM with Argon2id key derivation
  • Zero-knowledge cloud: We only store encrypted blobs
  • User-controlled keys: You own your encryption key
  • No telemetry: CLI doesn't phone home
savestate --help              # Show all commands
savestate <command> --help    # Command-specific help
savestate --version           # Show version (currently 0.4.2)

Links

Comparison: SaveState vs Live-Sync

FeatureSaveStateLive-sync tools
Point-in-time restore
Version history
Cross-platform migration
Snapshot comparison
Multi-platform support✅ 6 platformsUsually 1
Continuous sync❌ (scheduled)

SaveState is complementary to live-sync — use both for maximum protection.

README.md

No README available.

Permissions & Security

Security level L1: Low-risk skills with minimal permissions. Review inputs and outputs before running in production.

- **Encryption**: AES-256-GCM with Argon2id key derivation - **Zero-knowledge cloud**: We only store encrypted blobs - **User-controlled keys**: You own your encryption key - **No telemetry**: CLI doesn't phone home

Requirements

  • OpenClaw CLI installed and configured.
  • Language: Markdown
  • License: MIT
  • Topics:

FAQ

How do I install savestate?

Run openclaw add @dbhurley/savestate in your terminal. This installs savestate into your OpenClaw Skills catalog.

Does this skill run locally or in the cloud?

OpenClaw Skills execute locally by default. Review the SKILL.md and permissions before running any skill.

Where can I verify the source code?

The source repository is available at https://github.com/openclaw/skills/tree/main/skills/dbhurley/savestate. Review commits and README documentation before installing.