Encrypted GitHub backup & restore for any OpenClaw agent system.

  📦 ProSkills.md  ·  🔧 ClawHub  ·  ⬇️ Install  ·  🚀 Quick Start  ·  🔒 Security

Avenger Initiative backs up your entire OpenClaw system to a private GitHub repo every night — configs, agent memories, SOUL files, custom skills, cron jobs — everything needed to fully restore from zero.

Security model:

• openclaw.json (API keys, bot tokens) → AES-256-CBC encrypted before leaving disk
• Everything else (SOUL.md, MEMORY.md, etc.) → plaintext in your private repo
• Encryption key stays on your machine — never committed to Git

Branch-per-night strategy with smart retention:

Every backup automatically generates a human-friendly README.md in the vault root — so anyone (or any agent) landing in the repo immediately knows what it is, what's encrypted vs plaintext, and exactly how to restore. It includes step-by-step restore commands, natural-language Avenger agent commands, and security notes. A compact AVENGER-MANIFEST.json is also written with machine-readable backup metadata for scripted restores.

clawhub install avenger-initiative

Get the ClawHub CLI: npm install -g clawhub

Visit proskills.md/skills/avenger-initiative and click Install — the skill is listed for free, no login required to browse.

mkdir -p ~/.openclaw/workspace/skills git clone https://github.com/ProSkillsMD/avenger-initiative \ ~/.openclaw/workspace/skills/avenger-initiative chmod +x ~/.openclaw/workspace/skills/avenger-initiative/scripts/*.sh

Go to github.com/new and create a private repo (e.g. my-openclaw-vault).

Tell your OpenClaw agent:

"Setup avenger"

Your agent will walk you through the rest — vault repo URL, encryption key, first backup.

Or run manually:

bash ~/.openclaw/workspace/skills/avenger-initiative/scripts/setup.sh \ --repo https://github.com/yourname/your-vault

After setup, you'll see a 64-character hex key. Save it in your password manager immediately.
Without it, openclaw.json.enc cannot be decrypted.

Daily backups are scheduled at 02:00 UTC via OpenClaw cron.

# Restore latest (main branch) bash ~/.openclaw/workspace/skills/avenger-initiative/scripts/restore.sh # Restore from a specific date bash ~/.openclaw/workspace/skills/avenger-initiative/scripts/restore.sh \ --branch backup/daily/2026-03-10 # After restore openclaw gateway restart

• OpenClaw installed and running
• GitHub CLI (gh) authenticated (gh auth login)
• git, openssl (standard on most systems)
• A private GitHub repo for your vault

This skill uses:

• openssl enc -aes-256-cbc — encrypts your openclaw.json with your own key
• git push — pushes to your own private vault repo only
• No external servers — data goes only to your own GitHub account

See SECURITY.md for full script-by-script analysis and audit instructions.

• Each backup now generates a human-friendly README.md inside the vault with purpose, restore commands, and Avenger agent commands
• Added AVENGER-MANIFEST.json (machine-readable backup metadata)

• Fixed: main branch now always exists (setup.sh initializes it on first run)
• Fixed: backup commits to main first, then creates dated snapshot branch

• Added ProSkills.md + ClawHub badges to README
• Full installation guide (3 methods: CLI, ProSkills.md, git clone)

• Added .clawhubsafe and SECURITY.md to clarify false-positive security scan flags

• Initial release

MIT © ProSkillsMD

_{Find more OpenClaw skills at ProSkills.md — the verified AI skills directory}