Time Clawshine — OpenClaw Time Machine
Restic-powered encrypted time machine for OpenClaw: hourly incremental snapshots, fast restore by time/snapshot/file, local-only privacy defaults, integrity...
Rank
62
Safety
84
Downloads
1.9k
Updated
Oct 9, 2026
Version
3.2.3
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.9K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 1.9K downloadsadoption · observed Oct 9, 2026
- Latest release
- 3.2.3release · observed Jun 1, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17e8p1qmgndbnt8k67r1my2mh84hh5n:quick-backup-restore- Install using `clawhub skill install s17e8p1qmgndbnt8k67r1my2mh84hh5n:quick-backup-restore` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/marzliak/quick-backup-restore before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-marzliak-quick-backup-restore/snapshot"
Documentation
CLAWHUB
156,696 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: quick-backup-restore
description: "Restic-powered encrypted time machine for OpenClaw: hourly incremental snapshots, fast restore by time/snapshot/file, local-only privacy defaults, integrity checks, retention, and optional alerts. Setup can run with sudo, install dependencies, create systemd/cron persistence, restore over current files, and prune or purge recovery data."
metadata: { "openclaw": { "emoji": "⏱", "requires": { "bins": ["bash", "openssl", "curl", "jq"], "auto_install": ["restic", "yq"] }, "install": [{ "id": "setup", "kind": "shell", "label": "Run Time Clawshine setup", "command": "sudo bash {baseDir}/bin/setup.sh" }], "homepage": "https://github.com/marzliak/quick-backup-restore", "capabilities": { "filesystem": ["read configured backup paths", "write encrypted restic repository", "restore snapshots to target paths", "forget/prune snapshots", "optional destructive purge"], "system": ["sudo setup", "optional package install", "optional systemd timer or cron", "optional logrotate and /usr/local/bin install"], "network": ["optional Telegram", "optional healthcheck", "optional ClawHub update check", "blocked by privacy.local_only by default"], "sensitive_data": ["OpenClaw memory", "sessions", "config", "user-added paths may contain secrets"] } } }
---
# ⏱🦞 Time Clawshine — OpenClaw Time Machine
**Your agent just nuked its own memory. Now what?**
You spent weeks training your OpenClaw agent — building memory, refining context, tuning personality. Then one bad session wipes it. Gone. And your last "real" backup? Yesterday. Maybe last week.
**Time Clawshine gives OpenClaw a local encrypted time machine.** Every hour, restic takes an incremental snapshot of your agent's brain — memory, sessions, config, everything. Only changed bytes are stored, so backups stay fast and compact. When things break (and they will), you roll back by time, snapshot, or file to *exactly* the moment before it happened. Not yesterday. Not "the last backup." The exact hour.
Security note: this is a privileged backup/restore tool, not a narrow read-only helper. Setup can install packages and a scheduler with `sudo`; restore can overwrite current files; retention/prune can remove old recovery points; and optional external integrations can send minimal operational metadata only after explicit opt-in.
**One command to install. Zero maintenance. Just works.**
```bash
sudo bash {baseDir}/bin/setup.sh
```
### Why this exists
| Problem | Without Time Clawshine | With Time Clawshine |
|---------|----------------------|---------------------|
| Agent overwrites MEMORY.md | Hope you saved a copy | `restore.sh "2h ago"` |
| Bad session corrupts context | Rebuild from scratch | Roll back one snapshot |
| "What changed?" | No idea | `restic diff` between any two snapshots |
| Disk fills up | Backup keeps growing | Dedup — only deltas stored |
| Something fails | You find out next week | Local log, optional minimal Telegram ping |
### What's under the hood
-README.md
# ⏱🪞 Time Clawshine — OpenClaw Time Machine [](https://github.com/marzliak/quick-backup-restore/actions/workflows/ci.yml) **Restic-powered encrypted snapshots for OpenClaw.** Time Clawshine is a local-first time machine for OpenClaw: hourly incremental snapshots, fast restore by time/snapshot/file, integrity checks, retention, and privacy defaults that keep external egress off unless you opt in. It is not a plain tarball backup; restic handles encryption, deduplication, and snapshot history. Security note: setup can run with `sudo`, install dependencies, register systemd/cron persistence, back up sensitive OpenClaw memory/sessions/config, restore over current files, and prune old recovery points. Telegram, healthcheck.io / hc-style pings, and ClawHub update checks are optional and disabled by default. **Platform:** Linux only (bash scripts). macOS works with Homebrew restic but is untested. Windows not supported. Read [SECURITY.md](SECURITY.md) and [PRIVACY.md](PRIVACY.md) before installing on a production agent. --- ## Quick start From OpenClaw / ClawHub: ```bash openclaw skills search quick-backup-restore openclaw skills install quick-backup-restore ``` Use the slug `quick-backup-restore`; some OpenClaw CLI versions do not accept the owner-prefixed form `marzliak/quick-backup-restore`. From GitHub: ```bash git clone https://github.com/marzliak/quick-backup-restore cd quick-backup-restore bash bin/setup.sh --dry-run # preview deps, files, scheduler, and privacy settings nano config.yaml # optional: review paths and opt in to integrations sudo bin/setup.sh # installs deps, initializes repo, registers scheduler ``` Or, repo-only setup (no apt-get, no cron, no /usr/local/bin changes): ```bash sudo bin/setup.sh --no-system-install ``` Done. Backups run every hour at :05 by default. --- ## Flags | Flag | Script | Description | |------|--------|-------------| | `--help` / `-h` | all scripts | Show usage and exit | | `--dry-run` | `setup.sh` | Preview dependencies, system files, scheduler, and privacy settings without changes | | `--skip-backup` | `setup.sh` | Skip the initial validation backup after setup | | `--no-system-install` | `setup.sh` | Repo-only setup: creates repo dir, generates password, inits restic. Skips apt-get, cron registration, and binary install to `/usr/local/bin` | | `--assume-yes` / `-y` | `setup.sh` | Skip dependency installation confirmation prompt (for CI/automated use) | | `--dry-run` | `backup.sh` | Show what would be backed up without writing | | `--keep-last N` | `prune.sh` | Override retention for this run | | `--older-than DURATION` | `prune.sh` | Remove snapshots older than duration (e.g. `7d`, `24h`) | | `--dry-run` | `prune.sh` | Preview cleanup without deleting | | `--yes` / `-y` | `prune.sh` | Skip confirmation prompt | | `--yes` / `-y` | `uninstall.sh` | Skip confirmation (system fi
_meta.json
{
"ownerId": "kn70vfzhzzmqtsnrnma3tgqydn828jp8",
"slug": "quick-backup-restore",
"version": "3.2.3",
"publishedAt": 1780344697115
}CHANGELOG.md
# Changelog All notable changes to Time Clawshine are documented here. Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). --- ## [3.2.3] — 2026-06-01 ### Fixed - Preserve custom backup cadence when installing on systemd hosts. `setup.sh` now converts simple cron expressions such as `0 */2 * * *` to equivalent `OnCalendar` values instead of falling back to hourly. - Fall back to `/etc/cron.d/time-clawshine` for cron expressions that cannot be converted safely, preserving the user's configured `schedule.cron` exactly. ### Documentation - Document the OpenClaw install command with the slug-only format: `openclaw skills install quick-backup-restore`. - Add "every 2 hours" as a first-class setup-guide frequency option. --- ## [3.2.2] — 2026-06-01 ### Fixed - Rename `skill-card.md` to `MARKETPLACE.md` because ClawHub generates `skill-card.md` internally and rejects direct publishes containing that file. --- ## [3.2.1] — 2026-06-01 ### Changed - Refresh ClawHub positioning around the public name `Time Clawshine — OpenClaw Time Machine`. - Rewrite the first-line description for discovery around restic, encrypted snapshots, time/snapshot/file restore, local-only privacy defaults, integrity, retention, and optional alerts. - Split discovery tags into focused tags: backup, restore, restic, snapshots, time-machine, encrypted-backup, local-backup, openclaw, disaster-recovery, and privacy. - Add `skill-card.md` with concise marketplace copy highlighting the difference between restic snapshots and plain tarball backups. --- ## [3.2.0] — 2026-06-01 ### Security - Respond to the ClawHub security audit by making sensitive capabilities explicit in `skill.json`, `SKILL.md`, `README.md`, `SECURITY.md`, and `PRIVACY.md`. The docs now call out root setup, package installation, scheduler persistence, backup of sensitive OpenClaw memory/session/config data, restore overwrite risk, retention/prune deletion, purge behavior, and optional network egress. - Add `privacy.local_only: true` as the default hard egress gate. While enabled, Telegram, healthcheck, and ClawHub update checks are blocked even if their individual config blocks are edited. - Change `updates.check` default to `false`; update checks now require explicit opt-in by setting `privacy.local_only: false` and `updates.check: true`. - Minimize external notifications by default: no hostname and no raw error output. `privacy.send_error_details: true` enables only a short sanitized error excerpt. - Require healthcheck URLs to use `https://` unless they point to loopback localhost. - Remove the Telegram notification from `uninstall.sh`; uninstall no longer reports host identity, timing, or removal state to an external service. - Stop auto-suggesting `~/.ssh` and `~/.gnupg` in `customize.sh`; credential stores now require manual opt-in with explicit warnings. ### Added - `setup.sh --dry-run` previews dependencies, repository/password
MARKETPLACE.md
# Time Clawshine — OpenClaw Time Machine Restic-powered encrypted snapshots for OpenClaw. Time Clawshine is a local-first time machine for agent memory, sessions, config, and workspace state. It keeps hourly incremental snapshots, stores only changed data, and restores by time, snapshot, or file when an agent session corrupts state or overwrites important memory. ## Highlights - Hourly encrypted incremental snapshots via restic - Restore by time, snapshot ID, or individual file - Local-only privacy defaults: Telegram, healthcheck, and update checks are off - Integrity checks, retention, prune, and status dashboard - Setup preview with `setup.sh --dry-run` - Strong restore safety gate for `/` ## Best For - Rolling OpenClaw memory back to an exact hour - Recovering from bad sessions, corrupted context, or accidental overwrites - Keeping a compact local recovery layer before full VM or cloud DR backups ## Not A Plain Tarball Most simple backup skills create timestamped archives. Time Clawshine uses restic for encryption, deduplication, snapshots, and verified restores.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/marzliak/skills/quick-backup-restore",
"sourceUrl": "https://clawhub.ai/marzliak/skills/quick-backup-restore",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T22:58:07.922Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-marzliak-quick-backup-restore/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-marzliak-quick-backup-restore/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T22:58:07.922Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.9K downloads",
"href": "https://clawhub.ai/marzliak/quick-backup-restore",
"sourceUrl": "https://clawhub.ai/marzliak/quick-backup-restore",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T22:58:07.922Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "3.2.3",
"href": "https://clawhub.ai/marzliak/quick-backup-restore",
"sourceUrl": "https://clawhub.ai/marzliak/quick-backup-restore",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-06-01T20:11:37.115Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-marzliak-quick-backup-restore/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-marzliak-quick-backup-restore/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 3.2.3",
"description": "Scheduler cadence hotfix: systemd installs now preserve simple custom cron schedules like 0 */2 * * * as matching OnCalendar values, and unsupported cron expressions fall back to cron.d instead of hourly. Docs also clarify OpenClaw slug-only install.",
"href": "https://clawhub.ai/marzliak/quick-backup-restore",
"sourceUrl": "https://clawhub.ai/marzliak/quick-backup-restore",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-06-01T20:11:37.115Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
