← Back to Skills Marketplace
Restart Safe Workflow
by
Huo Lushan
· GitHub ↗
· v1.0.3
482
Downloads
2
Stars
4
Active Installs
3
Versions
Install in OpenClaw
/install restart-safe-workflow
Description
Safe OpenClaw gateway restart workflow with doctor precheck, checkpoint, restart-health-resume chain, task continuation, reconcile, and user-visible notifica...
Usage Guidance
This skill implements an automated restart-and-resume workflow and will run on-host commands and scripts described in task data (nextAction). Before installing or running: 1) Review and supply a strict ACTION_ALLOWLIST_FILE (the package’s recommended allowlist file is not included) so only safe commands/scripts are permitted. 2) Audit any task files (plan/nextAction inputs) you plan to run to ensure they cannot contain arbitrary 'cmd:' or 'script:' entries from untrusted sources. 3) Ensure the machine's openclaw CLI and its notification/account configuration are secure (the script invokes openclaw message send and gateway/restart/status commands). 4) Run acceptance tests in an isolated environment (or with --no-restart) first to observe behavior. 5) If you need help knowing which commands to allow/deny, ask the skill author for the default allowlist or add a conservative whitelist (only health/status/echo) before enabling real restarts.
Capability Analysis
Type: OpenClaw Skill
Name: restart-safe-workflow
Version: 1.0.3
The bundle provides a sophisticated administrative workflow for safely restarting the OpenClaw gateway, including state management, health checks, and task continuation. It features legitimate security controls such as command and script allowlists in `scripts/restart-safe.sh` and a comprehensive automated test suite in `scripts/restart-acceptance.sh`. While the scripts perform high-risk actions like detached execution and shell command processing, these behaviors are strictly aligned with the stated purpose of maintaining system availability during a service restart, and no evidence of malicious intent or data exfiltration was found.
Capability Assessment
Purpose & Capability
Name/description (safe restart, precheck, checkpoint, resume) match what the code does: it calls an openclaw CLI, performs doctor/checkpoint/restart/health/resume steps, writes per-task state JSON, and sends notifications. The dependencies (openclaw CLI, python3, bash) are appropriate for this purpose. Minor mismatch: the SKILL recommends a config-action-allowlist.txt but that file is not present in the package manifest.
Instruction Scope
The SKILL.md and scripts allow task-driven actions including 'cmd:<command>' and 'script:<path>' which the runtime will execute. The code includes an ACTION_ALLOWLIST_FILE mechanism and mentions a built-in whitelist, but the allowlist file recommended in SKILL.md is not included. If input task data (nextAction) is attacker-controlled or insufficiently validated, arbitrary commands or scripts could run. The scripts do not send data to external HTTP endpoints; visible notifications are sent via the openclaw CLI.
Install Mechanism
No install spec or remote downloads — this is instruction-only with included shell scripts. Nothing is fetched or installed at runtime by the skill itself, which minimizes supply-chain risk.
Credentials
The registry metadata declares no required environment variables, but the scripts make optional use of several env vars (STATE_DIR, ACTION_ALLOWLIST_FILE, NOTIFY_CHANNEL, NOTIFY_TARGET, NOTIFY_ACCOUNT, GATEWAY_RESTART_CMD, etc.). This is proportionate to a restart/notification workflow, but the skill will rely on the local openclaw CLI and whatever credentials/config it uses — those are not declared here. Ensure the openclaw runtime credentials and notify account settings are intentionally configured.
Persistence & Privilege
always=false and the skill does not request permanent platform-wide privileges. It writes state files under STATE_DIR (default ./state/restart) and may spawn detached processes for acceptance runs — this is expected for a detached restart runner. It does not alter other skills' configuration.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install restart-safe-workflow - After installation, invoke the skill by name or use
/restart-safe-workflow - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
- Minor updates to scripts/restart-safe.sh and scripts/restart-acceptance.sh.
- No user-facing changes documented.
v1.0.2
- Added plan and validate commands for TaskPlan v1 support.
- Improved acceptance testing with detached self-daemon mode.
- Enhanced task continuation and state machine with pendingActions.
- Comprehensive ability documentation and command usage updated in SKILL.md.
- Fixed TC10 upgrade trigger and completed Phase3/4 implementations.
v1.0.0
restart-safe-workflow 1.0.0 - Initial release
- Introduces a safe workflow for OpenClaw gateway restarts with built-in doctor checks, state persistence, and health verification.
- Provides checkpointing and automated resumption triggers to ensure recovery and reduce task loss risks.
- Supports user-visible notifications before and after restarts, with Feishu integration examples.
- Includes SOP and acceptance scripts for restart testing and validation, with clear state tracking and report outputs.
- Designed for scenarios requiring safe, traceable gateway restarts and reliable recovery assurance.
Metadata
Frequently Asked Questions
What is Restart Safe Workflow?
Safe OpenClaw gateway restart workflow with doctor precheck, checkpoint, restart-health-resume chain, task continuation, reconcile, and user-visible notifica... It is an AI Agent Skill for Claude Code / OpenClaw, with 482 downloads so far.
How do I install Restart Safe Workflow?
Run "/install restart-safe-workflow" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Restart Safe Workflow free?
Yes, Restart Safe Workflow is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Restart Safe Workflow support?
Restart Safe Workflow is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Restart Safe Workflow?
It is built and maintained by Huo Lushan (@who-ohw); the current version is v1.0.3.
More Skills