Avenger Initiative

🛡️ Avenger Initiative

Encrypted GitHub backup & restore for any OpenClaw agent system.

---

What It Does

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:

What's in the vault?

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.

---

Installation

Option 1 — ClawHub CLI (recommended)

clawhub install avenger-initiative

Get the ClawHub CLI: npm install -g clawhub

Option 2 — ProSkills.md

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

Option 3 — Manual (git clone)

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

---

Quick Start

1. Create a private GitHub vault repo

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

2. Set up Avenger Initiative

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

3. Save your encryption key

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.

4. First backup runs automatically

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

---

Usage

---

Restore

# 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

---

Requirements

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

---

Security

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.

---

Changelog

v1.0.4

• 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)

v1.0.3

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

v1.0.2

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

v1.0.1

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

v1.0.0

• Initial release

---

License

MIT © ProSkillsMD

---