unraid

What This Skill Does

The unraid skill enables OpenClaw to interact directly with the Unraid GraphQL API, allowing for comprehensive monitoring and system management of your server infrastructure. Instead of manually logging into the Unraid web GUI, this agent skill provides a streamlined, text-based interface to pull real-time telemetry on system health, disk status, container performance, and network shares. It handles everything from checking CPU load and RAM utilization to monitoring parity check progress and reviewing system logs. By abstracting the complex GraphQL queries required by Unraid 7.2+, this skill lets you maintain your storage array and virtualized environment through natural language interactions.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/jmagar/unraid

Once installed, you must configure your server credentials to allow the agent to authenticate with your Unraid host:

1. Open your Unraid web GUI.
2. Navigate to Settings → Management Access → API Keys.
3. Create a new key with the 'Viewer' role.
4. Set your environment variables:
   • export UNRAID_URL="https://your-unraid-server/graphql"
   • export UNRAID_API_KEY="your-api-key"

Use Cases

This skill is perfect for home lab enthusiasts and IT administrators who need fast, at-a-glance information about their storage servers. Use it to check if a parity check is nearing completion, verify if critical containers like Plex or Home Assistant are running properly, or identify which disk is reporting high temperatures. It is also highly effective for routine maintenance tasks, such as reviewing logs to troubleshoot unexpected reboots or checking current network share availability across the local area network.

Example Prompts

1. "Check the current disk temperatures and overall array health for my Unraid server."
2. "List all active Docker containers and let me know if any are currently in a non-running state."
3. "Show me the last 50 lines of the syslog to help diagnose recent system errors."

Tips & Limitations

The Unraid API is strictly read-only, which makes it incredibly safe for monitoring but means you cannot trigger array starts, stop containers, or modify share permissions directly via this skill. Additionally, please note that while you can see the state of Docker containers, the actual standard output logs of those containers are not accessible via this specific GraphQL implementation; for deep container inspection, you will still need to access the server via SSH. Always use the metrics endpoint for real-time status and reserve the info endpoint for checking static hardware configurations.