ez-unifi

What This Skill Does

The ez-unifi skill provides a robust interface for interacting with Ubiquiti UniFi network hardware using the aiounifi library. It acts as an abstraction layer between the OpenClaw AI agent and your UniFi Controller, enabling comprehensive network administration through natural language. Whether you are managing a UDM Pro, a Cloud Key, or a self-hosted instance, this skill allows for automated device maintenance, port management, and client oversight without needing to log into the web dashboard manually.

Installation

1. Install the skill via terminal: clawhub install openclaw/skills/skills/araa47/ez-unifi.
2. Create a dedicated local admin user in your UniFi controller settings (ensure Remote Access is disabled).
3. Populate your .env file with the following variables: UNIFI_HOST, UNIFI_USERNAME, UNIFI_PASSWORD, UNIFI_SITE, and UNIFI_IS_UDM.
4. Ensure the system is configured to execute scripts via uv run scripts/unifi.py.

Use Cases

This skill is perfect for home lab enthusiasts and IT administrators who need to perform quick health checks or maintenance on the go. Common use cases include: remotely power cycling a frozen access point, toggling PoE ports for connected IoT devices, generating temporary guest vouchers for visitors, and checking network health metrics like WAN status and throughput. It is particularly useful for rapid remediation of network issues by simply asking the agent to restart a specific device by its MAC address.

Example Prompts

1. "Check the current health of my network and tell me if any access points are offline."
2. "Power cycle the PoE port on switch with MAC AA:BB:CC:DD:EE:FF for port 5, my security camera is acting up."
3. "Create a guest WiFi voucher for 4 hours and let me know the code."

Tips & Limitations

Always ensure the local admin account used by the agent has the appropriate site permissions. Note that the skill relies on the internal API exposed by the controller; if your UniFi OS updates significantly, ensure your aiounifi dependencies are up to date. Avoid executing mass restarts on critical core infrastructure unless strictly necessary to prevent accidental downtime. The tool is designed for local network management and requires a stable connection between the OpenClaw environment and your UniFi controller instance.