← Back to Skills Marketplace
OpenClaw Emergency Rollback
by
EncryptShawn
· GitHub ↗
· v1.0.3
· MIT-0
130
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install openclaw-emergency-rollback
Description
OpenClaw Emergency Config Rollback — dead man's switch system for safely making risky changes to OpenClaw configuration. Use this skill whenever the user men...
Usage Guidance
This skill is mostly coherent with its stated purpose but proceed cautiously. Before installing: 1) Review and verify the restart command that will be stored in rollback-config.json — a wrong command can leave your gateway unreachable. 2) Be aware snapshots include openclaw.json (may contain tokens); if you follow the SKILL.md instruction to "write an AI summary", your agent may read sensitive config and could send it to a remote model — only do this if you trust where that summary will be processed. 3) The docs mix .zip/unzip language with tar.gz usage in scripts — treat the scripts (tar.gz) as authoritative and avoid following ZIP examples blind. 4) The restore extracts archives to / and will overwrite files: test the system in a safe environment before using on production. 5) The code uses pkill -f in places; this can kill processes with matching substrings — ensure the patterns (e.g., watchdog-timer.mjs) are unique on your host. If anything is unclear (restart command, snapshot contents, where AI summary is generated), ask the maintainer or inspect the scripts locally before enabling the hook or running destructive tests.
Capability Assessment
Purpose & Capability
Name, description, and files align: the scripts implement snapshots, a detached timer, a startup hook, and an automatic restore path. The code works against ~/.openclaw and provides restart orchestration — all expected for an emergency rollback tool.
Instruction Scope
SKILL.md instructs the agent to read ~/.openclaw/openclaw.json and produce an "AI summary" to include in a snapshot manifest — this requires the agent to access potentially sensitive config and (depending on your agent) may send that data to the model service. The README also claims "zero AI" for automatic restore but still asks for an AI summary when taking snapshots (contradiction). Several docs reference zip/unzip and .zip filenames while the scripts produce/extract tar.gz files (tar/gzip), which is an operational inconsistency that can cause operator errors during restore.
Install Mechanism
No external downloads or package installs are performed by the skill. It is instruction-only and supplies Node.js scripts that are copied into ~/.openclaw/rollback and an OpenClaw-managed hook — this is expected for a local rollback utility.
Credentials
The skill does not request credentials or unusual environment variables. It relies on HOME and an optional OPENCLAW_HOME and writes files under ~/.openclaw/rollback. However, snapshots include openclaw.json (which may contain tokens) and the SKILL.md asks the agent to read that file and produce an AI summary — that could leak sensitive configuration to remote models if the agent sends the summary externally. The scripts intentionally exclude auth-profiles.json, but other sensitive tokens may still be captured in snapshots.
Persistence & Privilege
The skill does not set always:true and operates only by writing files under the user's OpenClaw home and enabling a managed OpenClaw hook. It spawns detached timers and runs user-provided restart commands, which is within the expected scope for a rollback tool.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-emergency-rollback - After installation, invoke the skill by name or use
/openclaw-emergency-rollback - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
openclaw-emergency-rollback v1.0.3
- trying to fix that its stil flagged suspicious even though my current version shows clean, seems to be a bug in clawhub that uses old versions to cast shade on new versions.
- Cleaned up metadata by removing unnecessary files: .clawhub/origin.json and _meta.json
- No changes to end-user commands or rollback functionality
- Overall package footprint reduced by eliminating redundant metadata
v1.0.2
**Native, restart-proof dead man's switch now ships as a built-in OpenClaw hook for true zero-intervention recovery.**
- Added OpenClaw-native gateway startup hook (`hooks/watchdog-recovery/`) for watchdog recovery that works across both local and containerized (Docker/K8s/pod) environments.
- Recovery system no longer requires cron; persistent state and auto-restore handled by detached Node.js timer and hook logic (`watchdog-timer.mjs`, `handler.ts`).
- Updated file paths for config and scripts: now under `~/.openclaw/rollback/` instead of `~/.openclaw-rollback/`.
- Improved documentation with clear instructions for safe restart (avoiding `pkill -f openclaw`) and guidance for valid destructive testing and logical sabotage.
- New files: `.clawhub/origin.json`, `_meta.json`, full `watchdog-recovery` hook directory, and watchdog timer script.
v1.0.1
- Removed the backup of auth-profile in the snapshot for security purposes, should have never been there. Updated documentation accordingly.
v1.0.0
OpenClaw Emergency Config Rollback v1.0.0
- Adds dead man's switch system for risk-free OpenClaw config changes with automatic rollback if not cancellled in time (Even with no openclaw access for the user or AI access for OpenClaw)
- Manages the entire cycle: create/restore up to 3 snapshots, set recovery timers, and display watchdog reminders with clear commands.
- Leveraging Node.js scripts, zip/unzip, and cron — no new package dependencies required.
- Includes user-friendly commands: "create snapshot", "set emergency recovery", "accept changes", "extend recovery", and "restore snapshot".
- Supports destructive test mode to validate the recovery pipeline, with clear risk warnings.
- All actions and reminders are designed for reliability without AI, network, or manual intervention once armed.
Metadata
Frequently Asked Questions
What is OpenClaw Emergency Rollback?
OpenClaw Emergency Config Rollback — dead man's switch system for safely making risky changes to OpenClaw configuration. Use this skill whenever the user men... It is an AI Agent Skill for Claude Code / OpenClaw, with 130 downloads so far.
How do I install OpenClaw Emergency Rollback?
Run "/install openclaw-emergency-rollback" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is OpenClaw Emergency Rollback free?
Yes, OpenClaw Emergency Rollback is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does OpenClaw Emergency Rollback support?
OpenClaw Emergency Rollback is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created OpenClaw Emergency Rollback?
It is built and maintained by EncryptShawn (@encryptshawn); the current version is v1.0.3.
More Skills