← 返回 Skills 市场
zhilshi

Openclaw Health Guardian

作者 zhilshi · GitHub ↗ · v1.0.3 · MIT-0
cross-platform ⚠ suspicious
326
总下载
0
收藏
0
当前安装
4
版本数
在 OpenClaw 中安装
/install openclaw-health-guardian
功能描述
Monitors OpenClaw Gateway on macOS, auto-restarts on failure with 180s cooldown and max 5 restarts/hour to prevent restart loops.
安全使用建议
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.
功能分析
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.
能力评估
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).
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install openclaw-health-guardian
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /openclaw-health-guardian 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
Slug openclaw-health-guardian
版本 1.0.3
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 4
常见问题

Openclaw Health Guardian 是什么?

Monitors OpenClaw Gateway on macOS, auto-restarts on failure with 180s cooldown and max 5 restarts/hour to prevent restart loops. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 326 次。

如何安装 Openclaw Health Guardian?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install openclaw-health-guardian」即可一键安装,无需额外配置。

Openclaw Health Guardian 是免费的吗?

是的,Openclaw Health Guardian 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Openclaw Health Guardian 支持哪些平台?

Openclaw Health Guardian 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Openclaw Health Guardian?

由 zhilshi(@zhilshi)开发并维护,当前版本 v1.0.3。

💬 留言讨论