OpenClaw Backup for Openclaw

A dedicated toolset for creating, auditing, and restoring self-contained backup bundles for the OpenClaw state directory.

silronin
v1.0.0
Apr 16, 2026
0
742
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install bookers-openclaw-backup

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install bookers-openclaw-backup using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is OpenClaw Backup?

OpenClaw Backup provides a robust framework for preserving the state of your AI agents. As part of the ecosystem of Openclaw Skills, this tool ensures that your configurations, history, and workspace settings in ~/.openclaw are safe and portable across different environments. It focuses on security through integrity verification and strict path auditing, making it an essential utility for production-grade agent management.

This skill automates the lifecycle of backup bundles, allowing developers to switch between state snapshots or recover from accidental data loss. By leveraging Openclaw Skills like this one, you gain granular control over snapshot locations, retention policies, and restoration workflows.

OpenClaw Backup Use Cases

  • Full-state snapshot creation for OpenClaw agent environments.
  • Migrating agent configurations and history between different machines using portable bundles.
  • Guarded restoration of system state with mandatory integrity checks.
  • Automated cleanup and management of historical snapshots via configurable retention policies.

How OpenClaw Backup Works

  1. The user initiates a backup command which captures the ~/.openclaw directory into a versioned tar.gz bundle.
  2. The system generates a manifest and SHA256 checksums to ensure data integrity for the bundle.
  3. The skill manages the bundle storage according to the configured snapshot directory and retention settings.
  4. During restoration, the select_and_restore script audits the bundle content for safety, rejecting symlinks or dangerous paths before extraction.
  5. The integrated restore script finalizes the state recovery to the target environment.

OpenClaw Backup Setup

To integrate this into your workflow, ensure the scripts are available in your local environment. You can set a custom backup directory immediately:

bash scripts/set_backup_dir.sh /your/custom/path

Verify your current configuration settings using:

bash scripts/show_config.sh

OpenClaw Backup Data Schema & Taxonomy

Each backup bundle produced by these Openclaw Skills follows a strict directory structure:

File/Folder Description
.openclaw/ The actual state data and configurations being backed up.
restore.sh The primary executable script for performing a safe restore.
manifest.txt Metadata about the backup event and source.
SHA256SUMS Integrity hashes for all files within the bundle.

Configurations are prioritized from CLI flags, followed by the config.env file, and finally environment variables like OPENCLAW_SNAPSHOT_DIR.

OpenClaw Backup Advanced Features

  • Intelligent configuration priority model using local config.env files and environment variables.
  • Strict security auditing that rejects symbolic links and hard-links during extraction to prevent path traversal attacks.
  • Portability support allowing bundles to be restored to any HOME path regardless of the original backup source.
  • Flexible CLI support with command-line flags like --out-dir for one-off snapshot location overrides within Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*