A high-performance TypeScript CLI for managing Unraid servers via the GraphQL API, designed for both human operators and AI agents.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install unraid-cli
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install unraid-cli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Unraid CLI (ucli)?
Unraid CLI (ucli) provides a robust interface for interacting with Unraid servers through their GraphQL API. As part of the ecosystem of Openclaw Skills, it enables seamless remote management of server components including disk arrays, Docker containers, virtual machines, and system logs. It is engineered to prioritize machine readability and developer efficiency, making it an ideal choice for automation and AI-driven server orchestration.
This tool bridges the gap between manual web UI management and automated workflows. By leveraging Openclaw Skills like ucli, developers and homelab enthusiasts can script complex server maintenance tasks or provide AI agents with the tools necessary to monitor and heal server infrastructure autonomously.
Unraid CLI (ucli) Use Cases
- Monitoring system health and array status via automated scripts.
- Managing lifecycle actions for Docker containers and virtual machines.
- Retrieving and analyzing system logs for troubleshooting.
- Orchestrating multi-server environments using standardized CLI commands.
- Providing AI agents with a structured interface to perform server diagnostics.
How Unraid CLI (ucli) Works
- The user or agent invokes the ucli command with a specific functional group such as system, array, or containers.
- The CLI authenticates with the Unraid server using a configured API key and host URL provided via environment variables or a config file.
- A GraphQL query or mutation is dispatched to the server's API endpoint to retrieve data or perform an action.
- The server processes the request and returns structured data, which the CLI formats as JSON to ensure compatibility with Openclaw Skills workflows.
- The agent or user parses the output to verify the action or retrieve necessary system information for further automation steps.
Unraid CLI (ucli) Setup
Install the package via npm:
npm install -g unraid-cli
Configure your environment variables to allow the CLI to communicate with your server:
export UNRAID_HOST="http://your-server-ip:7777"
export UNRAID_API_KEY="your_api_key"
Alternatively, you can create a configuration file at ~/.config/ucli/config.yaml for stable environment profiles.
Unraid CLI (ucli) Data Schema & Taxonomy
The tool utilizes a structured command hierarchy organized into functional groups. The output schema is optimized for machine readability when used with Openclaw Skills.
| Group | Description |
|---|---|
| system | Information on health, status, resources, and uptime. |
| array | Management of parity, devices, and array status. |
| disks | SMART data, temperatures, and disk inventory. |
| containers | Lifecycle management, logs, and stats for Docker. |
| vms | Virtual machine inspection and control. |
| shares | Storage share details and usage metrics. |
| logs | Access to system, tail, and search logs. |
Unraid CLI (ucli) Advanced Features
- Native JSON output support for seamless integration with machine-learning pipelines and Openclaw Skills.
- Advanced filtering and sorting capabilities to shape data before it reaches the agent context.
- Multi-profile support for managing multiple Unraid environments from a single interface.
- Granular field selection to optimize payloads and save context window tokens.
- Comprehensive diagnostic tools including latency testing and environment health checks.
SKILL.md
Loading
Related Openclaw Skills
OpenClaw Vertex Credit-Safe Setup
A specialized configuration workflow for safely integrating Google Vertex AI into your AI agent environment while preventing unexpected billing costs.
Tutor Buddy Pro
Tutor Buddy Pro is a dedicated AI tutor that uses the Socratic method to help students master academic subjects through interactive guidance rather than just providing answers.
Trainer Buddy Pro
An intelligent AI strength coach that generates custom workouts from gym photos and tracks progressive overload through local data storage.
Writing Coach Pro
Transform your AI agent into a persistent writing mentor that learns your style and enforces professional standards across every session.
tieba-plus
A specialized tool for generating high-impact Tieba posts and mastering AI-to-AI debates with strategic wit and brevity.
Memory Maintenance & Task Executor
A high-performance memory maintenance system and task executor designed to optimize AI agent speed, decision-making, and long-term data persistence.
Featured*
