avenger-initiative

What This Skill Does

The Avenger Initiative is a robust, security-first backup and recovery system specifically designed for OpenClaw agents. It functions as a private GitHub vault that performs encrypted branch-per-night snapshots of your entire agent environment. This ensures that every aspect of your agent's operation—including API keys, bot tokens stored in openclaw.json, SOUL/IDENTITY files, workspace memories, custom tools, and active cron jobs—is protected against system failure or corruption. Using AES-256 encryption, the skill provides peace of mind by ensuring sensitive configuration data remains unreadable to unauthorized parties, even within a private repository.

The system employs an intelligent retention policy, keeping 7 daily, 8 weekly, and 12 monthly snapshots. It automatically triggers during critical configuration changes, such as gateway restarts or patch deployments, ensuring you never have a gap in your recovery history.

Installation

To integrate this safety net into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/asif2bd/avenger-initiative Once installed, initiate the setup flow by telling your agent to "setup avenger." The agent will guide you through connecting a private GitHub repository and generating a secure encryption key.

Use Cases

• Disaster Recovery: Restore a complete, working state of your agent after a system crash or accidental file deletion.
• Version Control History: Roll back to a specific timestamp if a recent configuration change causes unexpected behavior.
• Environment Migration: Easily move your agent identity and custom skills to a new machine by pulling from the vaulted repository.
• Security Auditing: Keep a secure history of configuration states to track how your agent's memory and behavior have evolved over time.

Example Prompts

1. "I'm changing my agent's core identity, please setup avenger to make sure I have a backup before I begin."
2. "I think I broke something, can you walk me through an avenger restore?"
3. "Show me the avenger status to confirm the last backup went through successfully."

Tips & Limitations

Always store your AES-256 encryption key in a professional password manager like Bitwarden or 1Password. If this key is lost, your vaulted files are permanently unrecoverable. The system requires a private GitHub repository; do not use a public repo, as the encryption cannot protect against meta-data exposure. Ensure your system has Git installed and authenticated with GitHub, as the skill relies on standard Git operations to push backups to your vault.