unraidclaw

OpenClaw plugin to manage your Unraid server through AI agents — Docker, VMs, array, shares, system, notifications, and more, with permission control.

This is the OpenClaw plugin for UnraidClaw. It exposes 44 tools to any AI agent running on OpenClaw, letting it monitor and manage your Unraid server. The plugin talks to the UnraidClaw gateway (a permission-enforcing REST API) running on your Unraid box.

Prerequisites

1. The UnraidClaw plugin installed on your Unraid server — install it from the Unraid Community Apps store, or see the main repo. It runs the gateway on port 9876 (HTTPS).
2. An UnraidClaw API key — generate one on the Settings → UnraidClaw page in the Unraid WebGUI.
3. OpenClaw installed (openclaw --version).

Install

npm pack unraidclaw && openclaw plugins install unraidclaw-*.tgz && rm unraidclaw-*.tgz

To update to the latest version:

rm -rf ~/.openclaw/extensions/unraidclaw && npm pack unraidclaw && openclaw plugins install unraidclaw-*.tgz && rm unraidclaw-*.tgz

Configure

Edit ~/.openclaw/openclaw.json.

Single server:

{
  "plugins": {
    "allow": ["unraidclaw"],
    "entries": {
      "unraidclaw": {
        "config": {
          "serverUrl": "https://YOUR_UNRAID_IP:9876",
          "apiKey": "YOUR_API_KEY",
          "tlsSkipVerify": true
        }
      }
    }
  }
}

Multiple servers:

{
  "plugins": {
    "allow": ["unraidclaw"],
    "entries": {
      "unraidclaw": {
        "config": {
          "servers": [
            { "name": "home", "serverUrl": "https://192.168.1.100:9876", "apiKey": "...", "tlsSkipVerify": true, "default": true },
            { "name": "work", "serverUrl": "https://10.0.0.50:9876", "apiKey": "..." }
          ]
        }
      }
    }
  }
}

With multi-server config, every tool accepts an optional server parameter (e.g. unraid_docker_list(server: "work")); the default server is used when it's omitted.

Set tlsSkipVerify: true when using UnraidClaw's auto-generated self-signed certificate.

Usage

Once installed and configured, just ask your agent:

• "List all running Docker containers"
• "Stop the plex container"
• "What's the array status?"
• "Show me disk temperatures"
• "Create a new nginx container with port 8080"
• "Check parity status"
• "Reboot the server"

Tools

44 tools across 11 categories:

Every tool is gated by a 22-key resource:action permission matrix configured from the Unraid WebGUI, so you control exactly what agents can do.

Links

• GitHub
• Issues
• Unraid Community Apps

License

MIT