\r \r

EternalClaw Memory Sync\r

\r This skill enables Openclaw agents to securely synchronize their memory state from a remote URL. It handles downloading, decrypting with AES-256-GCM, and restoring memory files to ensure seamless context continuity across environments.\r \r

Capabilities\r

\r

• Secure Restoration: Fetch and decrypt memory blobs from a user-provided URL.\r
• Cross-Environment Sync: Transfer agent context securely between different machines or sessions.\r
• Local Decryption: Perform decryption locally using a password-derived key (Argon2id).\r \r

Usage\r

\r This skill includes Python scripts that perform the actual restoration logic.\r \r

prerequisites\r

\r Ensure the following Python libraries are installed in your environment:\r \r

pip install cryptography requests argon2-cffi\r
```\r
\r
### Restore Memory\r
\r
To restore memory from a backup URL, execute the included script:\r
\r
```bash\r
# Execute from project root\r
python skills/memory-sync/scripts/restore_secure.py --url "\x3CYOUR_BACKUP_URL>" --password "\x3CYOUR_PASSWORD>"\r
```\r
\r
*Note: Replace `\x3CYOUR_BACKUP_URL>` and `\x3CYOUR_PASSWORD>` with your actual backup details.*\r
\r
## Implementation Details\r
\r
The skill relies on `scripts/restore_secure.py` (included in this package) to handle sensitive cryptographic operations.\r
\r
1. **Download**: Fetches the encrypted blob from the URL.\r
2. **Key Derivation**: Derives the decryption key using `Argon2id` and the provided password.\r
3. **Decryption**: Decrypts the data using `AES-256-GCM` to ensure confidentiality and integrity.\r
4. **Restoration**: Unpacks the memory files to the current workspace.\r
\r
## Included Files\r
\r
- `SKILL.md`: Documentation (this file).\r
- `scripts/restore_secure.py`: Main restoration script.\r
- `scripts/crypto_utils.py`: Shared encryption utilities.\r