← Back to Skills Marketplace
stanrails

Restart Recovery

by stanrails · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
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
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install restart-recovery
  3. After installation, invoke the skill by name or use /restart-recovery
  4. 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
Slug restart-recovery
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
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.

💬 Comments