unifi

What This Skill Does

The unifi skill provides a robust interface for interacting with your UniFi network infrastructure through the UniFi Site Manager API. Designed for network administrators and home automation enthusiasts, it enables real-time monitoring and oversight of your hardware ecosystem. By connecting to the UniFi cloud infrastructure, the skill abstracts complex API calls into simple, executable command-line operations, allowing you to quickly query your network topology without manually navigating web consoles.

Installation

To integrate this skill into your environment, use the command: clawhub install openclaw/skills/skills/odrobnik/unifi-skill. Post-installation, you must authenticate your connection. Either set the UNIFI_API_KEY environment variable in your shell configuration or create a config.json file in the skill directory, using config.json.example as your template. If you are operating a custom instance or private controller, ensure the UNIFI_BASE_URL variable is updated accordingly; otherwise, it defaults to the official UniFi cloud API.

Use Cases

This skill is ideal for environments where quick status updates are required. Administrators use it to audit current device firmware status, verify access point connectivity, and pull site-wide metrics during maintenance windows. It is particularly effective in headless server environments where you need to verify network health without opening a full GUI browser session. Developers can leverage the --json flag to pipe outputs into automated dashboard tools or custom alerting pipelines.

Example Prompts

• "Can you list all sites currently linked to my UniFi account and their connection status?"
• "I need to check the status of my UniFi Access Points. Please list them and identify which ones are currently online."
• "Generate a quick summary of my current network devices so I can verify my hardware inventory."

Tips & Limitations

This skill is currently optimized for high-level infrastructure oversight rather than deep-packet inspection or per-client troubleshooting. It focuses on aggregate site and hardware data. To maintain security, ensure your config.json file is added to your .gitignore to prevent leaking your API keys. If you require granular client-level traffic analysis or blocking, consider extending this implementation with the local UniFi Network API, as the Site Manager API is restricted to architectural and device-state visibility.