truenas-skill

What This Skill Does

The truenas-skill empowers the OpenClaw AI agent to act as a comprehensive administrative interface for your TrueNAS SCALE server. It enables the agent to monitor storage pool health, manage datasets, and handle snapshot lifecycle management directly through conversation. Beyond storage, it integrates with your containerized infrastructure via Dockge, allowing the agent to orchestrate container stacks, monitor services, and manage application states. The skill supports an extensive library of common homelab applications, including media management (Sonarr, Radarr, Plex), torrent and usenet clients, notification systems like ntfy, and productivity tools such as n8n or NocoDB, turning your chat interface into a powerful centralized dashboard.

Installation

To integrate this skill, use the command clawhub install openclaw/skills/skills/anotb/truenas-skill. Once installed, you must configure the required environment variables in your OpenClaw settings. Essential variables include TRUENAS_URL and TRUENAS_API_KEY. If you are using self-signed certificates, ensure TRUENAS_VERIFY_TLS is set to "0" to prevent handshake failures. For Dockge and ancillary services, populate the respective URL and API_KEY fields as specified in the skill documentation to enable full automation capabilities across your homelab stack.

Use Cases

This skill is designed for homelab enthusiasts and system administrators. Use it to check if your ZFS pools are healthy or if disks need replacement. It simplifies daily chores like pruning old snapshots, updating container images via Dockge, or checking the status of automated backups. It is also excellent for media library management, allowing you to quickly check if a movie or show has been correctly ingested by your ARR suite or to troubleshoot service availability.

Example Prompts

1. "Check the status of my ZFS storage pools and tell me if any disk has reported errors today."
2. "Update the Sonarr and Radarr containers in my media stack to the latest versions using Dockge."
3. "List all recent snapshots for the 'data/backups' dataset and delete any snapshots older than 30 days."

Tips & Limitations

Always prioritize security by using API keys with the minimum required permissions. Note that the REST API is deprecated; while currently supported, the skill will shift to native WebSocket communication in future updates to ensure long-term stability. Because this skill interacts with critical storage and service infrastructure, ensure that your OpenClaw agent instance is secured, as the agent will have the power to stop services and manipulate file systems.