unifi

What This Skill Does

The UniFi skill serves as a read-only bridge between the OpenClaw AI agent and your Ubiquiti UniFi network infrastructure. It leverages the local UniFi OS API, specifically designed for Cloud Gateway Max and other UniFi OS-based gateways, to provide real-time operational insights. Rather than manually logging into a web browser dashboard, you can request network statistics, health reports, and device status directly through your AI agent interface. It provides comprehensive data visibility into network performance, including client connections, active device states, traffic analytics via Deep Packet Inspection (DPI), and event logging. By fetching data locally, it ensures that your network management data remains within your controlled environment while providing instant access to critical network information.

Installation

To begin monitoring your network, ensure your gateway is reachable via HTTPS. Create the required configuration file at ~/.clawdbot/credentials/unifi/config.json with the following structure:

{
  "url": "https://10.1.0.1",
  "username": "api",
  "password": "YOUR_PASSWORD",
  "site": "default"
}

Once configured, execute the installation command: clawhub install openclaw/skills/skills/jmagar/unifi. Ensure the environment has the necessary permissions to execute bash scripts, as the skill interfaces with the system via CLI utilities to perform its data fetching functions.

Use Cases

This skill is ideal for home lab enthusiasts, system administrators, and home users who want to monitor their network without navigating complex GUI menus. It is particularly useful for identifying bottleneck devices, tracking data-heavy applications, verifying that access points are online, and performing quick security health checks when an internet slowdown is detected. It streamlines the monitoring workflow by consolidating scattered network data into a single, conversational dashboard.

Example Prompts

1. "Check my UniFi network health and tell me if any devices are disconnected."
2. "What are the top 10 applications consuming my bandwidth right now?"
3. "Show me a list of all active clients and which access point they are connected to."

Tips & Limitations

Note that this skill is strictly read-only, meaning it cannot modify configurations, block clients, or reboot devices—it is strictly for observation and reporting. Always ensure your local API credentials have sufficient permissions, and treat the configuration file with the same security as a password file. If you encounter issues, verify the URL is accessible over your local network and the API credentials are valid.