← Back to Skills Marketplace
483
Downloads
1
Stars
1
Active Installs
13
Versions
Install in OpenClaw
/install quick-backup-restore
Description
Time Clawshine — a simple but powerful time machine for OpenClaw. Hourly encrypted incremental snapshots of your agent's brain via restic. Use when the user...
Usage Guidance
This skill appears to do what it says, but it is a system-level backup tool and must be treated accordingly: 1) Running setup.sh requires sudo and installs systemd/cron entries and binaries — review the scripts (especially lib.sh) before granting root. 2) The tool creates and relies on a local restic password file: back that up externally or you'll lose the ability to decrypt snapshots. 3) Network activity (yq download during setup, update checks to clawhub.com, and optional Telegram notifications) is present but described as opt-in; if you need an air-gapped install, set --no-system-install and disable UPDATE_CHECK/TG settings in config.yaml and run setup steps manually. 4) Restores default to / and run as root — be careful when restoring to avoid overwriting important system files. 5) If you want extra assurance, run bin/test.sh (non-root) first, and inspect lib.sh to confirm tg_send/tg_failure and restic_cmd implementations and any network/telemetry behavior. If any of these behaviors are unacceptable, do not run setup.sh with sudo.
Capability Analysis
Type: OpenClaw Skill
Name: quick-backup-restore
Version: 3.0.0
Time Clawshine is a legitimate backup and restore utility for OpenClaw agents that utilizes the restic backup engine. The bundle contains a comprehensive suite of scripts (setup, backup, restore, prune, status) designed to manage encrypted, incremental snapshots of the agent's workspace and configuration. It demonstrates good security practices, such as implementing SHA256 checksum verification for external binary downloads (yq) in bin/setup.sh, enforcing restricted file permissions (chmod 600) for sensitive password and configuration files, and providing dry-run options for backup and restore operations. No evidence of malicious intent, unauthorized data exfiltration, or prompt injection attacks was found; all network activity (Telegram notifications and update checks) is documented and consistent with the tool's functionality.
Capability Tags
Capability Assessment
Purpose & Capability
The name/description (hourly encrypted incremental snapshots via restic) matches the code and instructions. Required binaries (bash, openssl, curl, jq) and auto-installs (restic, yq) are reasonable for a restic-based backup tool. The scripts deliberately require root when installing systemd/cron and writing to /usr/local or /etc — this is proportional to a system-level backup service.
Instruction Scope
Runtime instructions and scripts operate on local files (config.yaml, repo path, password file) and perform expected operations: backup, forget/prune, restore (including restoring into / by default), integrity checks, and health/status reporting. Some behaviors require attention: many scripts run as root (setup, uninstall, restore) and can write anywhere on disk or remove system artifacts; network calls are present for update checks (clawhub API) and optional Telegram notifications — these are documented as opt-in but will perform network I/O if enabled in config. The SKILL.md tells the agent to run the bundled setup.sh and other scripts; that is consistent with the skill's purpose but grants wide file-system privileges when executed.
Install Mechanism
This is instruction-only (no automated registry install), but the supplied setup.sh performs apt-get installs and downloads the yq binary from GitHub releases when needed. The setup script attempts checksum verification of the downloaded yq and uses standard package installation for restic/curl/jq. Downloading a binary from GitHub is common for yq; the script verifies checksums when available, reducing supply-chain risk. Installing systemd units and copying binaries to /usr/local/bin is expected for this utility but requires sudo.
Credentials
The skill declares no required environment variables and does not request unrelated cloud credentials. The backup encryption key is stored locally in a password file (config.yaml.repository.password_file) which the tool creates/uses; the SKILL.md explicitly tells the user to back up that password file separately. Telegram and update-check credentials are not required by default (opt-in via config), which is proportional to the stated feature set.
Persistence & Privilege
The skill does not request always: true and allows normal model invocation. It intentionally requires root for setup/uninstall and will register systemd timers/cron, write to /usr/local/bin, and create/modify system config — these privileges are expected for a system backup/restore agent but are powerful. No evidence that it modifies other skills' configurations; uninstall preserves user data unless --purge is used.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install quick-backup-restore - After installation, invoke the skill by name or use
/quick-backup-restore - Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.0.0
v3.0.0 — Breaking: system paths renamed to time-clawshine, binary now /usr/local/bin/time-clawshine. New: uninstall.sh, ARM64 support, v2 migration, SIGTERM trap, password validation, separated forget/prune, restore exit check, systemd timer detection, CI with shellcheck. Fixed: SIGPIPE in prune, set -e in customize.
v2.0.2
fix: Telegram messages now show Time Clawshine branding
v2.0.1
fix: yq checksum 404 (used bulk checksums file), missing chmod +x on scripts, test hash comparison
v2.0.0
Version 2.0.0 of quick-backup-restore introduces major new capabilities and improvements:
- Added SETUP_GUIDE.md for interactive, guided configuration, supporting user walkthroughs.
- Introduced bin/prune.sh for manual repository cleanup, including advanced retention and dry-run options.
- Added bin/test.sh for automated backup→restore→verify self-testing.
- Enhanced setup flow to recommend reading SETUP_GUIDE.md and customizing config before installation.
- Added dry-run mode to backup.sh for backup validation without writing data.
- Expanded restore.sh to support time-based restore arguments (e.g., "2h ago"), in addition to snapshot IDs.
- Updated documentation (README.md, SKILL.md) for new features, improved clarity, and new usage examples.
v1.3.0
- Major documentation redesign: SKILL.md rewritten with a friendlier, scenario-based introduction, feature table, and high-level overview as "Time Clawshine."
- Highlights new features in clear language: Telegram daily digest, disk guard, deduplication, update awareness, offline mode, and more.
- Existing technical reference and all usage examples are preserved and reorganized for clarity.
- No code or behavior changes—documentation only.
v1.2.4
**Shortened description and streamlined skill documentation.**
- Skill description and summary revised for brevity and clarity.
- SKILL.md heavily condensed; redundant, long-winded explanations removed.
- All critical commands and backup/restore instructions retained and reorganized for faster reference.
- No changes to core functionality; documentation only.
v1.2.3
# quick-backup-restore v1.2.3 changelog
- Internal metadata updates in skill.json.
- Updated CHANGELOG.md for release notes and documentation.
- No changes to user-facing commands or functionality.
v1.2.2
quick-backup-restore v1.2.2
- Documentation cleanup: removed trailing whitespace from SKILL.md.
- No functional or behavioral changes.
v1.2.1
- Updated documentation in SKILL.md to remove references to session and credential backups.
- Clarified that the backup covers memory, sessions, and config (not credentials).
- No functional or command changes; documentation only.
v1.2.0
- Adds a new status dashboard script (`bin/status.sh`) for easier backup status checks and update info.
- Updates the skill description and documentation to include support for "check for updates" requests.
- Documents `bin/status.sh` as the recommended way to check status, backup history, and updates.
- Notes that `backup.sh` will automatically check for updates daily (configurable), logging a warning if a new version is available but never updating automatically.
- Improves clarity and details in the usage instructions throughout the documentation.
v1.1.1
Fixed SKILL.md metadata: declared full dependency list (bash, openssl, curl, jq + auto_install restic, yq)
v1.1.0
Security hardening: replaced openclaw agent ask with local bash analysis, added --no-system-install and --assume-yes flags to setup.sh, deleted unused prompt files
v1.0.0
Initial release.
Hourly incremental backup for OpenClaw instances — restic-powered, AES-256 encrypted, YAML-configured.
- Automatic hourly cron via setup.sh
- 72-snapshot retention (3 days) with content-based deduplication
- Interactive restore with mandatory dry-run preview
- Surgical file-level restore (--file flag)
- Telegram notification on failure only — silent on success
- AI-assisted path customization via bin/customize.sh
- Zero hardcoded values — single config.yaml as source of truth
Metadata
Frequently Asked Questions
What is Time Clawshine?
Time Clawshine — a simple but powerful time machine for OpenClaw. Hourly encrypted incremental snapshots of your agent's brain via restic. Use when the user... It is an AI Agent Skill for Claude Code / OpenClaw, with 483 downloads so far.
How do I install Time Clawshine?
Run "/install quick-backup-restore" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Time Clawshine free?
Yes, Time Clawshine is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Time Clawshine support?
Time Clawshine is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Time Clawshine?
It is built and maintained by Marz (@marzliak); the current version is v3.0.0.
More Skills