clawvault

What This Skill Does

The clawvault skill provides a portable and continuously synced environment for your OpenClaw AI agent. Think of it as an iCloud for your AI's knowledge, memory, and installed packages. It automatically detects changes to your agent's core data, commits them like a Git repository, and pushes them to a cloud storage provider of your choice. This ensures your agent's state is consistent across all machines you use it on, offering a seamless and persistent experience. All data synced is end-to-end encrypted using an Ed25519 keypair, with the private key never leaving your local machine, ensuring your sensitive information remains secure.

Installation

To install the clawvault skill, use the following command within your OpenClaw environment:

clawhub install openclaw/skills/skills/getlighty/getlighty-clawvault

After installation, the first step is to initialize the vault:

clawvault.sh init

This command creates the necessary vault structure, generates your unique Ed25519 encryption keys, and performs an initial scan of your agent's packages.

Next, you'll need to choose a storage provider. You can opt for the managed ClawVault Cloud (paid service for convenience) or use your own storage solutions (free):

• ClawVault Cloud: clawvault.sh cloud signup
• Google Drive: clawvault.sh provider gdrive (initiates OAuth flow)
• Dropbox: clawvault.sh provider dropbox (initiates OAuth flow)
• FTP/SFTP: clawvault.sh provider ftp (prompts for host and credentials)
• Git: clawvault.sh provider git (uses any Git remote)
• S3: clawvault.sh provider s3 (supports S3-compatible storage)
• WebDAV: clawvault.sh provider webdav (e.g., Nextcloud)
• Local: clawvault.sh provider local (for USB drives or network mounts)

Use Cases

• Seamless Multi-Machine Workflow: Start working on a project on your desktop and seamlessly continue on your laptop without manual file transfers or configuration.
• Agent State Persistence: Ensure your agent's long-term memory, project contexts, and installed skills are always up-to-date, regardless of the machine you're using.
• Secure Data Synchronization: Keep your agent's core knowledge and configurations synchronized and encrypted across different environments.
• Version Control for AI State: Benefit from a full history of your agent's knowledge and configuration, allowing you to roll back to previous states if needed.
• BYOS for Cost Savings: Utilize free storage options like Google Drive, Dropbox, or your own FTP server to keep synchronization costs at zero.

Example Prompts

• "Hey OpenClaw, set up my clawvault using Google Drive."
• "Can you sync my latest project notes across all my devices using clawvault?"
• "I need to initialize the clawvault for the first time."

Tips & Limitations

• Security: While clawvault encrypts data in transit and at rest using your local Ed25519 key, ensure your chosen BYOS provider also has robust security measures if you are storing highly sensitive data.
• Storage Provider Limits: Be aware of any storage limits or file size restrictions imposed by your chosen cloud storage provider.
• Initial Sync Time: The first sync might take a considerable amount of time depending on the size of your agent's knowledge base and the speed of your internet connection and storage provider.
• Network Dependency: Continuous synchronization requires a stable internet connection. If offline, changes will be queued and synced once connectivity is restored.
• Configuration Files: While openclaw config.json is optional for sync, it's highly recommended to sync it if you frequently switch between different gateway or model configurations.
• Credentials: Sensitive credentials for channels are not auto-synced by default and require separate, encrypted handling. Always ensure these are protected.