x1-vault-memory

What This Skill Does

X1 Vault Memory is a robust, decentralized backup solution for your OpenClaw agent. It creates an indestructible copy of your agent's identity, personality, and memories. The process is fully automated: it compresses your agent files into a tar.gz archive, applies military-grade AES-256-GCM encryption using your wallet keypair, uploads the encrypted payload to IPFS, and anchors the resulting CID on the X1 blockchain. Because the encryption key is derived directly from your wallet keypair, only you possess the authority to decrypt and restore your agent's data. This ensures your agent is portable, immune to server-side data loss, and verifiable on-chain.

Installation

To integrate this skill, ensure you have Node.js v18+ installed on your system. Run the installation command: clawhub install openclaw/skills/skills/lokoweb3/x1-vault-memory. After installation, you must configure your environment variables. Set PINATA_JWT using your credentials from Pinata.cloud. Finally, place your wallet keypair JSON file in the designated x1_vault_cli/wallet.json path. It is imperative to use a dedicated wallet with minimal funds for these operations to minimize security risks.

Use Cases

This skill is essential for developers or users managing long-running, autonomous agents. If you are hosting your agent on a cloud VPS that may be subject to snapshots or accidental termination, this tool ensures your agent's 'brain' remains intact. It is also perfect for versioning; with the new v1.1.0 update, you can list backups and perform rollbacks, allowing you to revert to a previous personality state if current learning paths become suboptimal.

Example Prompts

1. "X1 Vault, perform a full backup of my current agent memory and anchor the CID on the blockchain immediately."
2. "Show me the last five backup versions and restore the memory state from Tuesday at 14:00 using the rollback feature."
3. "Run a diagnostic check on my storage integrity and verify that all current files match the latest IPFS hash."

Tips & Limitations

Always store your wallet keypair securely offline, as losing the key means losing permanent access to your encrypted backups. While the skill is highly efficient, ensure you maintain a small balance of XNT tokens in your wallet to cover the minimal on-chain gas fees—roughly 0.03 USD per year for daily backups. Never store sensitive private keys in plain text within your environment variables; the skill handles the keypair file securely, provided your local system is protected from unauthorized file access. The selective restore functionality (--only) is particularly useful if you only need to recover specific configuration files without overwriting the entire agent directory.