← Back to Skills Marketplace
encryptshawn

OpenClaw Configuration Management & Emergency Recovery

by EncryptShawn · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ⚠ suspicious
91
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install openclaw-recovery-manager
Description
OpenClaw Configuration Management & Emergency Recovery — configuration, skills, and projects snapshot &recovery for OpenClaw. Use this skill whenever the use...
Usage Guidance
This skill appears to do exactly what it claims: local snapshots and restores of OpenClaw config, skills, and projects with a config-only dead-man's-switch. Before installing or running it, do the following: - Manually review the restore.mjs and the startup hook (hooks/watchdog-recovery/handler.ts) to confirm they only restore the config subsystem automatically (skills and projects are manual). The SKILL.md asserts only config is auto-restored — verify the code matches that. - Run the included 'recovery-test.mjs preflight' to ensure the environment is ready and that the restart command was detected correctly. The detect-restart-command.mjs prints PID 1 cmdline fragments when probing containers; inspect its output to avoid accidentally committing sensitive command-line details to logs. - Be aware restores extract tar.gz archives using absolute paths (archives are extracted to /). That is necessary for restoration but can overwrite files; take an independent manual backup of critical data before testing destructive operations (the tool provides save-recovery for this purpose). - The 'sabotage' test intentionally poisons openclaw.json (but keeps JSON valid) to simulate logical failures — run it only in a controlled/test environment after saving a recovery copy. - Confirm you trust the skill's source and review the scripts that spawn detached processes (watchdog-timer) and run exec/pgrep/pkill; these actions require filesystem and process privileges and will be local-only in the code you provided. If you are not comfortable with automated local restores that run at startup, do not arm the watchdog or avoid installing the startup hook until you have audited the hook code and practiced manual restores.
Capability Analysis
Type: OpenClaw Skill Name: openclaw-recovery-manager Version: 1.0.1 The skill implements a comprehensive recovery and 'dead-man's-switch' watchdog system for OpenClaw. It employs high-risk operations, specifically extracting tar archives to the root directory (`tar -xzf ... -C /`) in `scripts/restore.mjs` and `scripts/skills-restore.mjs` to restore files to their absolute paths. It also installs a persistence mechanism via a native OpenClaw startup hook (`hooks/watchdog-recovery/handler.ts`) to automate restoration or timer re-arming upon gateway restart. While these capabilities are logically consistent with the stated goal of emergency system recovery and the code explicitly avoids backing up sensitive credential files (e.g., `auth-profiles.json`), the combination of root-level file system writes and automated execution on startup represents a significant security risk.
Capability Tags
crypto
Capability Assessment
Purpose & Capability
The name/description (config/skills/projects snapshots + recovery) match the included scripts and helpers. The repository contains explicit scripts for snapshotting and restoring config, skills, and projects, a watchdog/timer, a startup hook, and utilities to discover agents/projects from openclaw.json — all expected for the stated purpose.
Instruction Scope
Instructions and scripts perform local system probes (systemctl, docker-compose, /proc/1), read the user's openclaw.json and other files under the user's home (~/.openclaw), and run local commands (tar, gzip, pkill, kill signals). This behavior is coherent with detecting the correct restart command and performing restores, but it is intrusive: restore operations extract archives with absolute paths (to /) and the recovery-test includes a 'sabotage' subcommand that deliberately mutates openclaw.json. These are destructive-by-design for testing and recovery and should be run only after manual review and taking backups.
Install Mechanism
There is no install spec (instruction-only), which minimizes external install risk. The skill bundle does include many scripts that will be placed on disk when the skill is installed — they do not fetch code from arbitrary URLs. No external package downloads or URL-based installs were observed in the provided files.
Credentials
The skill requires no declared environment variables or external credentials. It legitimately accesses HOME, local OpenClaw configuration files (openclaw.json and ~/.openclaw/*), and system utilities (systemctl, docker compose, tar, gzip). Those accesses align with the skill's purpose; no unrelated cloud credentials or network tokens are requested.
Persistence & Privilege
always is false (normal). The skill writes to and manages ~/.openclaw/rollback and installs a native OpenClaw hook under ~/.openclaw/hooks/watchdog-recovery/ to run on gateway startup. This modifies the local OpenClaw configuration/hook surface (expected for a recovery tool) and spawns detached Node timers; review and consent are recommended because the startup hook can cause an automatic local restore when the watchdog expires.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openclaw-recovery-manager
  3. After installation, invoke the skill by name or use /openclaw-recovery-manager
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
### v1.0.1 — Restart command auto-detection introduced - Added `scripts/detect-restart-command.mjs` for automatic detection of the appropriate OpenClaw gateway restart command. - Updated setup instructions and documentation to emphasize detection (not asking) of the restart method, improving reliability across environments. - Ensures safer recovery by probing for systemd, Docker, and container PID 1 before prompting the user. - No changes to existing snapshot, restore, or watchdog operation.
v1.0.0
OpenClaw Configuration Management & Emergency Recovery 1.0.0 — Initial Release | This is an expansion of the previous Emergency Rollback Skill - Do not have Openclaw make changes to its own configuration without this tool! - Adds snapshot and emergency recovery management for OpenClaw System configuration, skills, and projects. - Introduces an automatic dead-man's-switch for config changes, restoring the last snapshot of system config if changes are not accepted in time. (Emergency Rollback) - Manual backup and restore (3-slot history) for sytem, skills and projects; automatic restores are config-only. Restore by agent, or project or all. - Change log unifies all recovery actions at `~/.openclaw/rollback/logs/change.log`. - No additional dependencies required; implemented using existing OpenClaw dependency - Native OpenClaw startup hook ensures emergency recovery on Kubernetes pod, Docker, or local system
Metadata
Slug openclaw-recovery-manager
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is OpenClaw Configuration Management & Emergency Recovery?

OpenClaw Configuration Management & Emergency Recovery — configuration, skills, and projects snapshot &recovery for OpenClaw. Use this skill whenever the use... It is an AI Agent Skill for Claude Code / OpenClaw, with 91 downloads so far.

How do I install OpenClaw Configuration Management & Emergency Recovery?

Run "/install openclaw-recovery-manager" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is OpenClaw Configuration Management & Emergency Recovery free?

Yes, OpenClaw Configuration Management & Emergency Recovery is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does OpenClaw Configuration Management & Emergency Recovery support?

OpenClaw Configuration Management & Emergency Recovery is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created OpenClaw Configuration Management & Emergency Recovery?

It is built and maintained by EncryptShawn (@encryptshawn); the current version is v1.0.1.

💬 Comments