An automated, restic-powered backup system that provides hourly incremental snapshots for your OpenClaw instance to prevent data loss or agent errors.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install time-clawshine
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install time-clawshine using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Time Clawshine?
Time Clawshine is a robust time machine layer designed specifically to protect OpenClaw's runtime environment. By utilizing restic for AES-256 encrypted, incremental backups, it ensures that your agent's memory, sessions, credentials, and configurations are safely versioned every hour. This skill is vital for developers who need to safeguard their work against accidental changes or logic errors during agent interactions.
Time Clawshine focuses on the immediate operational context of your Openclaw Skills. It operates silently via cron, only triggering Telegram notifications if a failure occurs, ensuring your workflow remains uninterrupted while maintaining a high level of data integrity. Whether you are experimenting with new agent protocols or managing a complex deployment, this skill provides the safety net required for professional AI development.
Time Clawshine Use Cases
- Rolling back agent memory after a logic error or unwanted modification to the workspace.
- Restoring a specific configuration file or credentials from a previous snapshot.
- Auditing changes between snapshots to understand how the agent's context and files have evolved.
- Creating a manual safety snapshot before making significant architectural changes to the instance.
- Monitoring the integrity of your backup repository to ensure long-term data reliability.
How Time Clawshine Works
- The skill initializes a restic repository at a defined local path (or remote via config) using an AES-256 encryption key stored at /etc/time-clawshine.pass.
- A cron job executes every hour at :05, running the backup script to capture incremental changes in the OpenClaw environment.
- The system captures the current state of memory, sessions, and configuration files, excluding temporary or blacklisted patterns defined in the YAML configuration.
- In the event of a backup failure, the system sends an alert via Telegram if credentials are provided; otherwise, it logs the error to a dedicated log file.
- Users can interactively restore snapshots, diff specific versions, or perform surgical file-level recovery using the provided CLI utilities.
Time Clawshine Setup
To install and configure Time Clawshine for your Openclaw Skills instance, follow these steps:
- Ensure dependencies (
restic,yq,jq,curl) are installed on your system. - Edit
{baseDir}/config.yamlto include your Telegrambot_tokenandchat_idif failure notifications are desired. - Run the initialization script:
sudo bash {baseDir}/bin/setup.sh
- Confirm the setup succeeded by checking the tail of the log file:
tail -5 /var/log/time-clawshine.log
Time Clawshine Data Schema & Taxonomy
| Component | Path / Key | Description |
|---|---|---|
| Config File | {baseDir}/config.yaml |
Primary configuration for retention, paths, and notifications. |
| Log File | /var/log/time-clawshine.log |
Centralized log for all automated and manual backup actions. |
| Password File | /etc/time-clawshine.pass |
AES-256 encryption key for the restic repository (chmod 600). |
| Repository | /var/backups/time-clawshine |
Default storage location for all encrypted snapshots. |
| Whitelist | backup.extra_paths |
YAML array of additional directories to include in the backup. |
| Blacklist | backup.extra_excludes |
YAML array of patterns or files to exclude from snapshots. |
Time Clawshine Advanced Features
- AI-assisted path customization using
customize.shto intelligently scan the workspace and suggest inclusions or exclusions. - Silent operation mode designed for cron integration, ensuring no noise during successful backup cycles.
- Differential analysis tools to compare the exact file changes between any two snapshot IDs.
- Secure repository integrity checks to verify that your backup data has not been corrupted.
- Flexible retention policy that defaults to preserving the last 72 hours of hourly snapshots for granular recovery.
SKILL.md
Loading
Related Openclaw Skills
Bible Research
A specialized AI agent for in-depth Bible study and scriptural research using a structured, context-aware methodology.
HK IPO Research Assistant
A comprehensive real-time data aggregator and analysis tool for Hong Kong Stock Exchange (HKEX) Initial Public Offerings.
Reminder Engine
An intelligent reminder management system that converts natural language requests into precise, scheduled cron jobs.
CI Whisperer
CI Whisperer is an intelligent diagnostic tool that automates the analysis of GitHub Actions failures to provide root-cause insights and automated PR fixes.
Cloudflare DNS Management Skill
A powerful tool for programmatically managing Cloudflare DNS records to automate domain configuration and email authentication.
Auto-Memory-Distiller
A background service that distills raw OpenClaw conversation logs into structured, theme-based, and searchable Markdown memory cards.
METADATA
Featured*
