← Back to Skills Marketplace
TimeMachine
by
KillShadow
· GitHub ↗
· v1.0.0
· MIT-0
373
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install time-machine
Description
Create, list, and rollback incremental snapshots of OpenClaw configs and memory with optional auto-backups and retention policies.
Usage Guidance
This package is a local backup/restore tool for OpenClaw and mostly does what it claims, but take care before installing:
- It copies secrets: snapshots include credentials/* and .env (unencrypted) — ensure ~/.openclaw/snapshots is protected (file permissions, disk encryption) and consider encrypting snapshots before storing them.
- The README promises auto-snapshot and prompting behavior configurable via openclaw.json, but the provided scripts do not parse openclaw.json or hook into edit events — automatic behavior requires extra integration (cron, file-watchers, or modifying the code). Treat autosnapshot settings in the docs as informational rather than implemented.
- Default cleanup/retention values are hard-coded in cleanup.py (RETENTION_DAYS=7, MAX_COUNT=50); if you rely on openclaw.json for retention you should modify the scripts to read that config.
- The code runs only locally and performs file copy operations; inspect the scripts yourself and test in a safe environment. If you need remote backups, add explicit, secure upload code (with encryption) — avoid sending snapshots (which include secrets) to untrusted endpoints.
If you decide to use it: run it in a controlled environment, verify permissions on the snapshots directory, consider adding encryption for stored snapshots, and update the code if you need the advertised automatic/integration behaviors.
Capability Analysis
Type: OpenClaw Skill
Name: time-machine
Version: 1.0.0
The 'time-machine' skill bundle is a legitimate utility for creating and restoring local backups of OpenClaw configurations and workspace data. It handles sensitive files such as credentials and environment variables in 'snapshot.py' and 'restore.py' as part of its core functionality, but it performs all operations locally within the user's home directory (~/.openclaw/snapshots) and shows no evidence of data exfiltration or malicious intent. While the code contains minor bugs, such as an undefined variable in 'snapshot.py' and misleading documentation in 'SKILL.md' regarding secret encryption, these are non-malicious implementation flaws rather than intentional vulnerabilities.
Capability Assessment
Purpose & Capability
Scripts operate on ~/.openclaw, create/restore snapshots, list and cleanup them — this matches the stated purpose of backing up configs and memory. Copying credentials/* and .env is consistent with a full-configuration backup, though it is sensitive.
Instruction Scope
SKILL.md claims features that imply integration (prompts before editing critical files, auto-snapshot based on openclaw.json settings). The shipped scripts do not read openclaw.json for autoSnapshot/retention settings and contain no hooks to prompt on edits — the README over-promises automation that the code does not implement. Also the SKILL.md suggests scheduled/automatic behavior but scripts are standalone CLI utilities; external orchestration would be required.
Install Mechanism
No install spec; code is shipped as Python scripts that run locally. No remote downloads or installers were included.
Credentials
The skill requests no environment variables, but it copies sensitive files into snapshots (credentials/*, .env, workspace memory). Backing up secrets is functionally reasonable for a backup tool, but snapshots are stored unencrypted under ~/.openclaw/snapshots by default — this is a significant sensitivity concern and should be highlighted to users.
Persistence & Privilege
The skill does not request always:true and does not modify other skills or global agent settings. It writes files under the user's home (~/.openclaw/snapshots) which is expected for a backup tool.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install time-machine - After installation, invoke the skill by name or use
/time-machine - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Time Machine 1.0.0 – Git-style snapshots and rollback for OpenClaw
- Introduced manual and automatic incremental snapshot system for OpenClaw configurations and memory files.
- Added commands to save, list, view, rollback, and delete snapshots, including preview and confirmation steps.
- Supports auto-snapshot before risky changes, scheduled backups, and retention policies for snapshot management.
- Enables granular restore (entire state or specific files/memory) with space-efficient incremental backups.
- Includes protection prompts before critical changes and scripts for manual snapshot management.
Metadata
Frequently Asked Questions
What is TimeMachine?
Create, list, and rollback incremental snapshots of OpenClaw configs and memory with optional auto-backups and retention policies. It is an AI Agent Skill for Claude Code / OpenClaw, with 373 downloads so far.
How do I install TimeMachine?
Run "/install time-machine" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is TimeMachine free?
Yes, TimeMachine is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does TimeMachine support?
TimeMachine is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created TimeMachine?
It is built and maintained by KillShadow (@chaceli); the current version is v1.0.0.
More Skills