Git-Crypt Backup for Openclaw

A professional-grade backup solution that uses git-crypt to securely sync sensitive Clawdbot workspace and configuration data to GitHub repositories.

louzhixian
v1.0.0
Jan 26, 2026
2
4.5k
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install git-crypt-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 git-crypt-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 Git-Crypt Backup?

The Git-Crypt Backup skill is designed to provide a secure, version-controlled bridge between your local AI agent environment and remote storage. By utilizing git-crypt, it ensures that highly sensitive files—such as identity markers, memory logs, and API credentials—are encrypted before they ever leave your local machine. This approach allows developers to leverage the convenience of GitHub for backups without compromising the privacy of their agent's internal state.

As part of the wider ecosystem of Openclaw Skills, this tool integrates deeply with the Clawdbot file structure. It separates data into encrypted and plaintext categories based on sensitivity, ensuring that while your core logic remains searchable or visible if desired, your private keys and personal agent memories remain strictly confidential. This is an essential skill for developers running persistent AI agents across multiple environments.

Git-Crypt Backup Use Cases

  • Automating daily backups of agent memory and system logs to prevent data loss.
  • Synchronizing a single Clawdbot identity across multiple development machines securely.
  • Storing sensitive .env files and API credentials in private GitHub repositories with an extra layer of encryption.
  • Implementing a disaster recovery workflow for AI agent configurations and soul files.

How Git-Crypt Backup Works

  1. The user initializes Git and git-crypt within the ~/clawd and ~/.clawdbot directories.
  2. Specific .gitattributes files are configured to define which files must be filtered through the git-crypt encryption engine.
  3. Encryption keys are exported and stored in a secure secondary location to ensure future access.
  4. Sensitive files are automatically encrypted during the git commit process.
  5. The encrypted data is pushed to a remote GitHub repository for redundant storage.
  6. On a new machine, the user clones the repo and uses the exported keys to unlock and decrypt the workspace in one step.

Git-Crypt Backup Setup

1. Repository Preparation

Create two private repositories on GitHub named clawdbot-workspace and clawdbot-config.

2. Initialize Git-Crypt

Install the tool and initialize your directories:

# Install git-crypt
brew install git-crypt

# Initialize Workspace
cd ~/clawd
git init
git-crypt init
git remote add origin [email protected]:<username>/clawdbot-workspace.git

3. Security Configuration

Create a .gitattributes file in ~/clawd to protect sensitive files:

SOUL.md filter=git-crypt diff=git-crypt
USER.md filter=git-crypt diff=git-crypt
MEMORY.md filter=git-crypt diff=git-crypt
memory/** filter=git-crypt diff=git-crypt

4. Key Management

Export your keys to a safe location (e.g., a password manager):

mkdir -p ~/clawdbot-keys
cd ~/clawd && git-crypt export-key ~/clawdbot-keys/workspace.key

Git-Crypt Backup Data Schema & Taxonomy

The skill organizes data into two distinct repositories to separate core workspace data from system-level configurations. Encryption is applied selectively based on the following taxonomy:

Repository Encrypted Files (Private) Plaintext Files (Public/Metadata)
Workspace SOUL.md, USER.md, MEMORY.md, memory/ AGENTS.md, IDENTITY.md, TOOLS.md, drafts/
Config clawdbot.json, .env, credentials/, sessions/ cron/jobs.json, settings/

Git-Crypt Backup Advanced Features

  • Automated shell script integration for one-click manual backups or cron job scheduling.
  • Granular encryption control via .gitattributes, allowing you to choose exactly what remains private.
  • Seamless multi-agent state restoration, enabling you to pick up an AI conversation on any authorized machine.
  • Support for custom git-crypt keys, enhancing security for different Openclaw Skills projects.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*