← Back to Skills Marketplace
326
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install openclaw-health-guardian
Description
Monitors OpenClaw Gateway on macOS, auto-restarts on failure with 180s cooldown and max 5 restarts/hour to prevent restart loops.
Usage Guidance
This package mostly does what it says: it installs a user-level macOS LaunchAgent that checks the local OpenClaw gateway and tries to restart it with cooldown/rate-limiting. Before installing: 1) Inspect the two scripts (scripts/install.sh and scripts/openclaw-health-check.sh) yourself — they are included in the package and will be copied into ~/.openclaw. 2) Verify the source/author; if you don't trust the publisher, don't run the install. 3) Note the odd metadata: the skill claims a 'node' dependency but the scripts are bash-only — this is likely a packaging error but worth asking the author. 4) Confirm you want a persistent LaunchAgent that can load/unload user LaunchAgents (it operates at gui/$(id -u) scope). 5) Run the install in a controlled environment (or inspect & run the scripts manually line-by-line), back up any existing ~/Library/LaunchAgents/ai.openclaw.gateway.plist and ~/.openclaw/state before installing, and check logs after first runs. If anything looks unexpected (external network calls, unfamiliar plist manipulations, or attempts to access non-user config), abort and remove the files.
Capability Analysis
Type: OpenClaw Skill
Name: openclaw-health-guardian
Version: 1.0.3
The openclaw-health-guardian skill is a legitimate macOS utility designed to monitor and maintain the uptime of the OpenClaw gateway. It uses a bash script (openclaw-health-check.sh) and a macOS LaunchAgent (com.openclaw.healthcheck.plist) to perform periodic health checks, implementing sensible safety features like a 180-second cooldown and a 5-restarts-per-hour rate limit. While it utilizes powerful system tools such as launchctl for service management and osascript for user notifications, these actions are transparently documented in SAFETY.md and align strictly with the tool's stated purpose without any evidence of malicious intent or data exfiltration.
Capability Assessment
Purpose & Capability
The described purpose (monitor and auto-restart OpenClaw Gateway on macOS) matches the included bash scripts and LaunchAgent usage. However the SKILL metadata repeatedly declares a dependency on the 'node' binary even though the install.sh and openclaw-health-check.sh are pure bash and do not require node; that's inconsistent and unnecessary for the stated purpose. There are also duplicated metadata blocks in SKILL.md which looks sloppy.
Instruction Scope
Runtime instructions and scripts operate only on user-owned locations (~/.openclaw, ~/Library/LaunchAgents) and localhost:18789, and they use launchctl, curl and osascript in ways consistent with a health monitor. The scripts create state files, log files, and may open a Terminal window for user interaction. They don't contact external network endpoints other than localhost.
Install Mechanism
There is no remote download/install spec; the repository bundles an install.sh which copies local files into the user's home. No external archives or obscure download URLs are used. This is lower-risk than an arbitrary network installer, but you still execute a bundled install script on your machine.
Credentials
The skill declares a 'node' binary requirement (bins: ["node"]) in metadata though the code is bash-centric and does not meaningfully use node. No environment variables or credentials are requested, which is appropriate. The unnecessary node requirement is disproportionate and may be an artifact or misconfiguration.
Persistence & Privilege
The skill installs a per-user LaunchAgent (~/Library/LaunchAgents/com.openclaw.healthcheck.plist) — persistent but user-level (no sudo required). It also attempts to load or bootstrap the OpenClaw gateway launch agent (ai.openclaw.gateway), which is within the scope of managing the gateway but means the script can manipulate other user LaunchAgents. always:false (not force-included).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-health-guardian - After installation, invoke the skill by name or use
/openclaw-health-guardian - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
Fix tilde expansion (use $HOME instead of ~/Library), escape special chars in osascript to prevent injection
v1.0.2
Fix hardcoded user path (HARDCODED_USER_PATH), document launchctl/osascript warnings in SAFETY.md
v1.0.1
Added SAFETY.md to address VirusTotal false positive. Documented all system commands and security measures.
v1.0.0
Initial release of OpenClaw Health Guardian. Features: automatic Gateway health monitoring, auto-restart with 180s cooldown, rate limiting (5 restarts/hour), terminal notifications via AppleScript, LaunchAgent deployment for macOS.
Metadata
Frequently Asked Questions
What is Openclaw Health Guardian?
Monitors OpenClaw Gateway on macOS, auto-restarts on failure with 180s cooldown and max 5 restarts/hour to prevent restart loops. It is an AI Agent Skill for Claude Code / OpenClaw, with 326 downloads so far.
How do I install Openclaw Health Guardian?
Run "/install openclaw-health-guardian" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Openclaw Health Guardian free?
Yes, Openclaw Health Guardian is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Openclaw Health Guardian support?
Openclaw Health Guardian is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Openclaw Health Guardian?
It is built and maintained by zhilshi (@zhilshi); the current version is v1.0.3.
More Skills