← Back to Skills Marketplace
325
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install restart-recovery
Description
Make OpenClaw agent workflows restart-safe using checkpoint files, idempotent step tracking, wake/resume handoff, and stale-checkpoint monitoring. Use when u...
Usage Guidance
This skill appears to do what it says: local checkpointing and resume. Before installing or enabling it, review and test these points: 1) Do not store secrets/tokens in checkpoint data — the tools may print checkpoint JSON to stdout and write it to disk. 2) Confirm the checkpoint directory (memory/checkpoints under the agent's working directory) is the right location for your deployment and set restrictive file permissions. 3) Review the startup change you will add to AGENTS.md; enable it in a staging environment first so you can validate resume behavior. 4) Understand the simple lock mechanism (file-based) and the '--steal-lock' behavior; if multiple agents may touch the same directory, consider stronger locking or agent coordination. 5) Establish retention/cleanup and expiry policies for old checkpoints. If you want additional assurance, run the scripts in a controlled test workspace and inspect all generated files/logs for any sensitive data exposure.
Capability Analysis
Type: OpenClaw Skill
Name: restart-recovery
Version: 1.0.0
The skill bundle implements workflow state management but contains a path traversal vulnerability in `scripts/checkpoint_tool.py`, where the `--workflow` argument is used to construct file paths without sanitization, allowing JSON files to be written outside the intended directory. Additionally, `SKILL.md` includes a 'Required operating rule' that instructs the AI agent to automatically resume unfinished workflows on startup; while aligned with the skill's purpose, this creates a persistence mechanism that could be abused if a malicious checkpoint file is planted on the filesystem.
Capability Assessment
Purpose & Capability
Name/description match the included JSON schema and two Python scripts which implement checkpoint lifecycle, listing, stale-check detection, and resume. The resources requested (none) are proportional to the stated purpose.
Instruction Scope
SKILL.md stays on-topic: it explains when to checkpoint, how to use the bundled scripts, and instructs adding a startup check to AGENTS.md. That startup instruction intentionally changes agent behavior (check memory/checkpoints on boot) — expected for a restart-recovery tool but worth explicit review. The docs correctly warn not to write secrets into checkpoints; however the tooling will print full checkpoint JSON (e.g., resume prints the object), so accidental secret inclusion could be exposed in logs/outputs.
Install Mechanism
Instruction-only skill with bundled scripts; there is no remote download or package install. Scripts operate on local disk under workspace 'memory/checkpoints'. No network endpoints or obfuscated install steps.
Credentials
The skill requests no environment variables or credentials and the scripts do not read external secrets. That is proportionate. A caution: checkpoint files may contain arbitrary workflow data; the tool prints checkpoint JSON (resume) and lists files, so if secrets are accidentally stored in checkpoints they can be exposed. No environment variables are required or accessed.
Persistence & Privilege
The skill does not request 'always' or system-wide privileges. It recommends adding a startup check to AGENTS.md which makes resumed execution persistent across restarts — intended behavior for this purpose but should be reviewed before enabling. Locking is implemented via simple .lock files and a '--steal-lock' option exists; this is a lightweight scheme (no OS-level advisory locking) and can result in races or unintended takeover if multiple agents share the same checkpoint directory.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install restart-recovery - After installation, invoke the skill by name or use
/restart-recovery - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: checkpoint/restart/wake/resume workflow with no-LLM stale checkpoint self-check scripts.
Metadata
Frequently Asked Questions
What is Restart Recovery?
Make OpenClaw agent workflows restart-safe using checkpoint files, idempotent step tracking, wake/resume handoff, and stale-checkpoint monitoring. Use when u... It is an AI Agent Skill for Claude Code / OpenClaw, with 325 downloads so far.
How do I install Restart Recovery?
Run "/install restart-recovery" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Restart Recovery free?
Yes, Restart Recovery is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Restart Recovery support?
Restart Recovery is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Restart Recovery?
It is built and maintained by stanrails (@stanrails); the current version is v1.0.0.
More Skills