← Back to Skills Marketplace
Server Health Agent
by
Sanjay Jain
· GitHub ↗
· v1.0.0
1026
Downloads
0
Stars
7
Active Installs
1
Versions
Install in OpenClaw
/install server-health-agent
Description
Monitor VPS and server health metrics including real-time CPU usage, RAM utilization, disk usage, and Docker container status. Useful for DevOps monitoring,...
Usage Guidance
This skill appears to do what it says: run read-only system commands to return CPU, RAM, disk, and Docker status. Before installing, consider: 1) The agent must have shell access — run the agent with least privilege so the skill only sees what you want it to (avoid running the agent as root if unnecessary). 2) If you do not want container names/status exposed, ensure the agent cannot access the Docker socket/CLI. 3) The SKILL metadata doesn't list required binaries (top, free, df, docker) — check your host has compatible utilities or rely on Node.js fallbacks. 4) Because the code uses child_process.exec, review the code and keep it under source control so you can detect future modifications. If you are comfortable with those points, the skill is internally consistent with its stated purpose.
Capability Analysis
Type: OpenClaw Skill
Name: server-health-agent
Version: 1.0.0
The skill is classified as suspicious due to its explicit request for `shell` permission in `SKILL.md` and the use of `child_process.exec` in `skill.js` to run system commands (`top`, `free`, `df`, `docker ps`). While the executed commands are hardcoded, read-only, and do not incorporate user input (thus avoiding direct shell injection vulnerabilities), the broad `shell` permission and the use of a powerful primitive like `exec` represent a significant risky capability, even if plausibly needed for the stated monitoring purpose. This aligns with the guideline to classify broad permissions and risky capabilities as 'suspicious' when clear malicious intent is absent.
Capability Assessment
Purpose & Capability
The name/description match the code: the skill runs read-only system commands (top, free, df, docker) and Node.js fallbacks to produce server metrics. One minor mismatch: the SKILL metadata/requirements list no required binaries even though the code expects standard system utilities (top, free, df, docker). This is likely an omission, not malicious, but means the platform should ensure those binaries exist.
Instruction Scope
SKILL.md and skill.js limit actions to collecting system metrics and printing structured JSON. The instructions do not reference unrelated files, undisclosed env vars, external endpoints, or 'use your judgment' style broad data collection. The skill logs and returns only local metrics (including Docker container names/status), which is consistent with its stated purpose.
Install Mechanism
There is no automated install step (instruction-only skill with included code). No downloads from arbitrary URLs or archive extraction occur. The README suggests copying the folder into the workspace and restarting OpenClaw, which is standard for local skills.
Credentials
The skill requests no environment variables or external credentials. It does require shell access to execute system commands, which is proportionate to gathering host metrics. The only implicit requirement is access to the Docker socket/CLI if Docker container status is desired — this is expected for the feature.
Persistence & Privilege
The skill is not marked always:true and is user-invocable only. However, it requires shell execution permission (declared in SKILL.md) and will therefore run system commands with whatever privileges the agent process has. That privilege is necessary for its function but means it will see anything the agent user can read (including containers if Docker socket is available).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install server-health-agent - After installation, invoke the skill by name or use
/server-health-agent - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of Server Health Agent.
Features:
- Real-time CPU monitoring using top command
- RAM usage monitoring with fallback support
- Disk usage detection
- Docker container status detection
- Structured JSON output for OpenClaw compatibility
- Node.js 18–22 compatible
- Docker-safe execution
- CLI testing support
Metadata
Frequently Asked Questions
What is Server Health Agent?
Monitor VPS and server health metrics including real-time CPU usage, RAM utilization, disk usage, and Docker container status. Useful for DevOps monitoring,... It is an AI Agent Skill for Claude Code / OpenClaw, with 1026 downloads so far.
How do I install Server Health Agent?
Run "/install server-health-agent" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Server Health Agent free?
Yes, Server Health Agent is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Server Health Agent support?
Server Health Agent is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Server Health Agent?
It is built and maintained by Sanjay Jain (@sanjay-gthb); the current version is v1.0.0.
More Skills