← Back to Skills Marketplace
yoshiofthewire

Unraid Monitor Skill for OpenClaw

by Yoshiofthewire · GitHub ↗ · v1.0.4 · MIT-0
cross-platform ✓ Security Clean
195
Downloads
0
Stars
0
Active Installs
5
Versions
Install in OpenClaw
/install unraid-claw
Description
Query an Unraid server via GraphQL for system, array, and Docker status in read-only mode.
Usage Guidance
This skill appears to be what it claims: a read-only Unraid GraphQL monitor. Before installing: 1) Only provide UNRAID_API_KEY and UNRAID_BASE_URL to the skill environment; treat the API key like any secret. 2) Note that the scripts create a temporary curl config file that contains the API key (the script chmods it to 600 and removes it), so run this only in a trusted environment. 3) If you use a login-gated proxy, the scripts accept optional UNRAID_CSRF_TOKEN and UNRAID_SESSION_COOKIE — these are optional but are not listed in the metadata, so if you plan to use them be aware they will be read from the environment. 4) The README shows commands to add cron entries; follow those manually if you want persistent scheduling (they will persist on your machine). 5) As a best practice, inspect and run the included scripts in a controlled environment first (they are small shell scripts) and avoid placing real credentials in version-controlled files. If you want me to, I can produce a short checklist of commands to safely test the skill in a sandboxed environment.
Capability Analysis
Type: OpenClaw Skill Name: unraid-claw Version: 1.0.4 The unraid-claw skill is a legitimate monitoring tool for Unraid servers using GraphQL. It includes well-structured shell scripts for health checks, snapshots, and reporting. Security is prioritized through explicit instructions in SKILL.md to avoid leaking secrets and a secure implementation in scripts/unraid_common.sh that uses temporary curl configuration files to prevent API keys from appearing in process lists. There is no evidence of malicious intent, data exfiltration, or unauthorized persistence.
Capability Assessment
Purpose & Capability
Name/description (Unraid monitoring via GraphQL) matches the scripts and behavior. Required binaries (curl, jq) and required env vars (UNRAID_BASE_URL, UNRAID_API_KEY) are appropriate and necessary for the stated purpose. Scripts implement snapshotting, summary, alerts, and a cron runner consistent with the description.
Instruction Scope
SKILL.md and scripts remain within the stated monitoring scope and perform only read-only GraphQL queries. One minor scope mismatch: the runtime code references optional env vars UNRAID_CSRF_TOKEN and UNRAID_SESSION_COOKIE (for login-gated/reverse-proxy setups) but these are not listed in the metadata.requires.env block. This is plausible for some Unraid setups but should be noted.
Install Mechanism
There is no install spec (instruction-only skill), and the repository contains shell scripts only. No remote downloads, package installs, or extract-from-URL behavior were found. This is low-risk for install-time code execution beyond the included scripts.
Credentials
Only UNRAID_API_KEY and UNRAID_BASE_URL are required, which is proportionate. Optional variables (timeouts, thresholds, state dir, notify label) are reasonable. As noted above, the scripts optionally read UNRAID_CSRF_TOKEN and UNRAID_SESSION_COOKIE even though they are not declared in requires.env; these are used to support proxied/login-gated configurations and are optional, but the omission from metadata should be documented.
Persistence & Privilege
The skill does not request always:true and does not attempt to change other skills or system-wide agent configuration. It writes snapshots/logs into a repo-local state directory (or a user-set UNRAID_STATE_DIR) and contains instructions for adding a cron entry — those cron instructions would only take effect if the user runs them. No automatic persistent backdoors or cross-skill modifications were found.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install unraid-claw
  3. After installation, invoke the skill by name or use /unraid-claw
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.4
unraid-claw v1.0.4 - Added jq as a required dependency for script execution. - Updated skill metadata to include jq under required binaries. - No behavioral or interface changes.
v1.0.3
- Added OpenClaw metadata block specifying required environment variables and binaries. - Updated documentation to include the GitHub repository URL. - Minor cleanup: removed `UNRAID_NOTIFY_TIMEOUT_SECONDS` from the documented environment variables. - No code changes; documentation and metadata improvements only.
v1.0.2
Remove incorrect Webhook Calls
v1.0.1
- Documentation cleanup: removed detailed comments and duplicate optional `.env` variables (CSRF token, session cookie) for clarity. - Streamlined `.envexample` to show only supported and recommended variables. - No behavioral or script execution changes; logic and security rules unchanged. - Response output example updated to fix sample formatting and include a more precise Docker/array structure.
v1.0.0
unraid-claw 1.0.0 - Initial release. - Enables read-only Unraid health, array/parity, and Docker status checks via GraphQL. - Requires Unraid API key and base URL; supports environment variable configuration. - Provides operator-focused output with severity logic (healthy, warning, critical). - Uses dedicated repository scripts for all status and report actions. - Includes clear error handling and security guidelines. - Supports scheduled health checks via recommended cron job templates.
Metadata
Slug unraid-claw
Version 1.0.4
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 5
Frequently Asked Questions

What is Unraid Monitor Skill for OpenClaw?

Query an Unraid server via GraphQL for system, array, and Docker status in read-only mode. It is an AI Agent Skill for Claude Code / OpenClaw, with 195 downloads so far.

How do I install Unraid Monitor Skill for OpenClaw?

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

Is Unraid Monitor Skill for OpenClaw free?

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

Which platforms does Unraid Monitor Skill for OpenClaw support?

Unraid Monitor Skill for OpenClaw is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Unraid Monitor Skill for OpenClaw?

It is built and maintained by Yoshiofthewire (@yoshiofthewire); the current version is v1.0.4.

💬 Comments