← Back to Skills Marketplace
x-rayluan

OpenClaw Healthcheck

by X-RayLuan · GitHub ↗ · v0.1.1 · MIT-0
cross-platform ⚠ suspicious
1096
Downloads
0
Stars
4
Active Installs
2
Versions
Install in OpenClaw
/install openclaw-healthcheck
Description
This skill should be used when the user asks for an OpenClaw health check, OpenClaw security audit, server hardening review, exposure review, gateway safety...
Usage Guidance
This skill appears to implement a local OpenClaw health/security audit and does not contact external endpoints, but there are two practical concerns before you run it: 1) Metadata omissions: The package registry metadata does NOT list required binaries or config paths, but the script expects system commands (openclaw, lsof, tail) and reads ~/.openclaw/openclaw.json and /tmp/openclaw/<date>.log. Confirm those commands exist and be prepared for the script to read those files. 2) Sensitive local reads: The script collects command output and file contents into a JSON 'evidence' object that may contain config values or log lines (which can include secrets or PII). Review the script first and run it in a safe/test account or sandbox (or with a temporary HOME) before running on a production host. Practical steps: - Inspect scripts/healthcheck.mjs yourself (you already have it) to verify what will be read and output. - Run the included tests in a sandboxed temp directory (npm test / node tests/test.mjs) to see behavior. - Back up ~/.openclaw/openclaw.json and any logs, or run the script with HOME pointed at a safe test directory if you want to avoid exposing real configs. - If you plan to install for repeated use, ask the maintainer to update metadata to declare required binaries (openclaw, lsof, tail) and config/log paths so the capability and the requested access are explicit. Given these mismatches between metadata and actual behavior, treat the skill as suspicious until you confirm its runtime reads and outputs are acceptable for your environment.
Capability Analysis
Type: OpenClaw Skill Name: openclaw-healthcheck Version: 0.1.1 The openclaw-healthcheck skill is a legitimate diagnostic tool designed to audit the health and security posture of an OpenClaw deployment. The core logic in `scripts/healthcheck.mjs` performs read-only operations such as checking process status (`openclaw status`), identifying listening ports (e.g., 18789, 9222), verifying configuration flags in `~/.openclaw/openclaw.json`, and scanning recent logs for error patterns. The skill is well-documented, includes a functional test suite (`tests/test.mjs`), and contains no evidence of data exfiltration, malicious execution, or prompt injection.
Capability Assessment
Purpose & Capability
The script's actions (running `openclaw status`, lsof to inspect listeners, reading ~/.openclaw/openclaw.json, tailing /tmp/openclaw/... logs) are coherent with a local OpenClaw health/security check. However, the registry metadata declares no required binaries or config paths while the script clearly depends on system commands (openclaw, lsof, tail) and specific config/log paths. That metadata omission is an inconsistency that could lead to surprise or misuse.
Instruction Scope
SKILL.md instructs the agent to run the bundled Node script. The script reads user files (home config at ~/.openclaw/openclaw.json), inspects /tmp logs, and runs shell commands (lsof, tail, openclaw). Those actions are within the advertised scope, but they will expose potentially sensitive local content (config values, logs) into the script's JSON output (evidence). The SKILL.md does not explicitly enumerate these exact file reads/commands — the README and script do.
Install Mechanism
This is an instruction-only skill with bundled scripts; there is no network download/install step. No external packages or remote installers are fetched. Risk from installation is low, but the script will be executed locally with Node.js.
Credentials
The skill declares no required environment variables or config paths, yet it accesses the user's HOME, reads ~/.openclaw/openclaw.json, and inspects /tmp/openclaw logs. It also expects system utilities (openclaw binary, lsof, tail). Asking for no credentials is appropriate, but the metadata should declare the config/log paths and required binaries so users know what will be read and what commands must be present.
Persistence & Privilege
The skill does not request always-on presence and does not modify other skills or system-wide settings. It runs as a one-shot diagnostic and exits (the script uses process.exit). There is no evidence of persistent background behavior or network exfiltration.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openclaw-healthcheck
  3. After installation, invoke the skill by name or use /openclaw-healthcheck
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.1
Release 0.1.1: add README, MIT license, packaged files list, and automated test coverage for the healthcheck skill.
v0.1.0
Initial OpenClaw healthcheck skill with runtime, exposure, config, and log hygiene checks.
Metadata
Slug openclaw-healthcheck
Version 0.1.1
License MIT-0
All-time Installs 4
Active Installs 4
Total Versions 2
Frequently Asked Questions

What is OpenClaw Healthcheck?

This skill should be used when the user asks for an OpenClaw health check, OpenClaw security audit, server hardening review, exposure review, gateway safety... It is an AI Agent Skill for Claude Code / OpenClaw, with 1096 downloads so far.

How do I install OpenClaw Healthcheck?

Run "/install openclaw-healthcheck" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is OpenClaw Healthcheck free?

Yes, OpenClaw Healthcheck is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does OpenClaw Healthcheck support?

OpenClaw Healthcheck is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created OpenClaw Healthcheck?

It is built and maintained by X-RayLuan (@x-rayluan); the current version is v0.1.1.

💬 Comments