Official Verified

unraidclaw

Complete Unraid server management via the UnraidCLaW REST API. Covers: - Docker containers (create/start/stop/remove/logs) - VMs (start/stop/restart/pause) - Array operations (start/stop/parity) - Disks, shares, users, network, notifications, system - Full permission matrix and API key management Requires: UnraidCLaW plugin installed and enabled on Unraid. API Base: https://<UNRAID_IP>:9876 | Auth: x-api-key header Version requirement: **Always sync with the latest UnraidCLaW version.** Currently tested against: **v0.1.27**. If `GET /api/health` returns a different (older) version, alert the user that a newer UnraidCLaW is available and suggest upgrading. Use when: managing Unraid containers, VMs, array, or system tasks via API rather than SSH or WebUI.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/ashanzzz/ashanzzz-unraidclaw

Download Source Code (.zip)

UnraidCLaW 全套操作指南

API 基础

Base URL: https://<UNRAID_IP>:9876
认证: x-api-key: <API_KEY> (Header)
返回格式: 统一包络 { "ok": true, "data": {...} } 或 { "ok": false, "error": {...} }
TLS: 默认自签名证书，请求时加 -k 或在业务系统中关闭证书验证

版本检查（每次操作前必读）

当前测试版本: v0.1.27

每次执行 UnraidCLaW 操作前，先检查插件版本：

curl -s -k -H "x-api-key: $TOKEN" https://<UNRAID_IP>:9876/api/health
# 返回: {"ok":true,"data":{"status":"ok","version":"0.1.27","uptime":...}}

如果版本低于当前测试版本：

提醒用户："检测到 UnraidCLaW 版本为 X.X.X，最新版本为 0.1.27，建议升级以获得更好的兼容性"
升级方式：在 Unraid 社区应用里搜索 "UnraidClaw" 更新，或手动下载最新 txz 包

如果版本高于 0.1.27：

说明：技能描述基于 0.1.27，如遇 API 差异请告知

已知版本历史:

0.1.27 — 当前测试版本
0.1.21 — 历史安装包（仍存在于磁盘）

API 端点总表

分类	方法	端点	权限
Health	GET	`/api/health`	无
Docker	GET	`/api/docker/containers`	docker:read
Docker	GET	`/api/docker/containers/:id`	docker:read
Docker	GET	`/api/docker/containers/:id/logs`	docker:read
Docker	POST	`/api/docker/containers`	docker:create
Docker	POST	`/api/docker/containers/:id/:action`	docker:update
Docker	DELETE	`/api/docker/containers/:id`	docker:delete
VMs	GET	`/api/vms`	vms:read
VMs	GET	`/api/vms/:id`	vms:read
VMs	POST	`/api/vms/:id/:action`	vms:update
VMs	DELETE	`/api/vms/:id`	vms:delete
Array	GET	`/api/array/status`	array:read
Array	GET	`/api/array/parity/status`	array:read
Array	POST	`/api/array/start`	array:update
Array	POST	`/api/array/stop`	array:update
Array	POST	`/api/array/parity/start`	array:update
Array	POST	`/api/array/parity/pause`	array:update
Array	POST	`/api/array/parity/resume`	array:update
Array	POST	`/api/array/parity/cancel`	array:update
Disks	GET	`/api/disks`	disk:read
Disks	GET	`/api/disks/:id`	disk:read
Shares	GET	`/api/shares`	share:read
Shares	GET	`/api/shares/:name`	share:read
Shares	PATCH	`/api/shares/:name`	share:update
System	GET	`/api/system/info`	info:read
System	GET	`/api/system/metrics`	info:read
System	GET	`/api/system/services`	services:read
System	POST	`/api/system/reboot`	os:update
System	POST	`/api/system/shutdown`	os:update
Notifications	GET	`/api/notifications`	notification:read
Notifications	GET	`/api/notifications/overview`	notification:read
Notifications	POST	`/api/notifications`	notification:create
Notifications	POST	`/api/notifications/:id/archive`	notification:update
Notifications	DELETE	`/api/notifications/:id`	notification:delete
Network	GET	`/api/network`	network:read
Users	GET	`/api/users/me`	me:read
Logs	GET	`/api/logs/syslog`	logs:read

权限矩阵

Read Full Documentation on GitHub

Metadata

Author@ashanzzz

Stars4126

Updated2026-04-15

View Author Profile

AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill

Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-ashanzzz-ashanzzz-unraidclaw": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

Ashan Skill Creator

Skill by ashanzzz

ashanzzz 4473

sure-api

Use the we-promise/sure REST API with X-Api-Key auth. Covers accounts, transactions, categories, tags, merchants, imports, holdings, trades, valuations, chats, official docs URLs, self-update workflow from upstream OpenAPI, and ClawHub publish readiness.

ashanzzz 4473

vikunja-task-api

Install: clawhub install ashanzzz-vikunja-task-api Full Vikunja v2 API integration — projects, tasks, labels, teams, views, comments, attachments, bulk operations, and more.

ashanzzz 4473

Verified Research

Skill by ashanzzz

ashanzzz 4473

unraid-xml-generator

Generate Unraid DockerMan user template XML files from structured input. Use when: the user asks to "生成 Unraid XML 模板", "创建 Docker 模板", "为 XXX 写 Unraid 模板", or "生成 DockerMan XML" for any container. Key technique learned (2026-04-02): Unraid DockerMan templates support <ExtraParams>--entrypoint /bin/sh</ExtraParams> + <PostArgs> to bypass the container image's ENTRYPOINT. This allows overriding any image's startup command from the template. Config variables use: <Config Name="..." Target="ENV_VAR" Default="..." Type="..." Display="..." Required="..." Mask="..."> These become environment variables passed into the container. The skill generates a complete, valid XML and optionally deploys it to /boot/config/plugins/dockerMan/templates-user/my-<name>.xml (requires user confirmation before writing).

ashanzzz 4473