Time Machine

What This Skill Does

Time Machine acts as a sophisticated version control system for your entire OpenClaw ecosystem, mirroring the utility of Git. It captures incremental snapshots of your configuration, memory files, and credentials to ensure that your assistant's state is always recoverable. By utilizing a delta-based storage strategy, it creates a full initial backup followed by lightweight incremental patches, ensuring that your disk space is optimized while maintaining a full history of your workspace changes. It handles complex system states, including core configs, agent definitions, and sensitive data, providing a robust safety net for power users and developers alike.

Installation

To integrate Time Machine into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/chaceli/time-machine

Once installed, you can verify the configuration by checking your openclaw.json file. Ensure that the timeMachine object is populated to enable the automated snapshot policies, such as onChange triggers and recurring cron-based backups. This configuration is essential for setting up retention periods that automatically prune old snapshots to prevent excessive storage consumption.

Use Cases

1. Prototyping Configurations: When experimenting with agent personalities or complex prompt engineering, create a manual snapshot before testing to ensure you can revert if the output quality degrades.
2. System Recovery: In the event of a configuration error or accidental deletion of critical memory files, utilize the rollback feature to return the agent to a known-good state.
3. Long-term History: Maintain a daily record of your evolving agent definitions, allowing you to audit changes or cherry-pick previous settings from months prior.
4. Automated Safety: Enable the onChange policy so that every time you modify core system settings, an automatic backup is generated, providing an implicit safety buffer for every edit.

Example Prompts

1. "Save a snapshot now, I'm about to test a new system prompt for my research agent."
2. "Show me the list of available snapshots; I need to see what my configuration looked like last Tuesday."
3. "Rollback to the last working version, I think I accidentally broke the memory configuration."

Tips & Limitations

• Retention Strategy: Always define a maxCount in your configuration to avoid consuming unnecessary disk space over time.
• Encrypted Backups: While the skill handles secrets, ensure your environment variables are managed correctly, as credentials are stored in an encrypted format within your snapshot repository.
• Rollback Precision: Use the --only flag when rolling back if you only want to restore memory files without overwriting recent configuration changes. Note that rollback operations are destructive; always view the snapshot content using /snap view before executing a full rollback to confirm the target state.