Skill

unifi

From sundial-org-awesome-openclaw-skills-4

Queries and monitors UniFi networks via local gateway API: lists devices and clients, health status, top DPI apps, recent alerts. For network status checks like 'who's connected' or 'UniFi health'.

Bash

monitoring

infrastructure

Install

npx claudepluginhub joshuarweaver/cascade-ai-ml-agents-misc-2 --plugin sundial-org-awesome-openclaw-skills-4

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Monitor and query your UniFi network via the local UniFi OS gateway API (tested on Cloud Gateway Max).

Supporting Assets

README.mdreferences/unifi-readonly-endpoints.mdscripts/alerts.shscripts/clients.shscripts/dashboard.shscripts/devices.shscripts/health.shscripts/top-apps.shscripts/unifi-api.sh

SKILL.md

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

139.2k

mcp-builder

9 files

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

anthropics-skills-13

124.2k

canvas-design

20 files

Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.

anthropics-skills-13

124.2k

Stats

Stars586

Forks75

Last CommitFeb 1, 2026

Actions

View Source View Plugin View on GitHub View README

UniFi Network Monitoring Skill

Monitor and query your UniFi network via the local UniFi OS gateway API (tested on Cloud Gateway Max).

Purpose

This skill provides read-only access to your UniFi network's operational data:

Devices (APs, switches, gateway) status and health
Active clients (who's connected where)
Network health overview
Traffic insights (top applications via DPI)
Recent alarms and events

All operations are GET-only and safe for monitoring/reporting.

Setup

Create the credentials file: ~/.clawdbot/credentials/unifi/config.json

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

url: Your UniFi OS gateway IP/hostname (HTTPS)
username: Local UniFi OS admin username
password: Local UniFi OS admin password
site: Site name (usually default)

Commands

All commands support optional json argument for raw JSON output (default is human-readable table).

Network Dashboard

Comprehensive view of all network stats (Health, Devices, Clients, Networks, DPI, etc.):

bash scripts/dashboard.sh
bash scripts/dashboard.sh json  # Raw JSON for all sections

Output: Full ASCII dashboard with all metrics.

List Devices

Shows all UniFi devices (APs, switches, gateway):

bash scripts/devices.sh
bash scripts/devices.sh json  # Raw JSON

Output: Device name, model, IP, state, uptime, connected clients

List Active Clients

Shows who's currently connected:

bash scripts/clients.sh
bash scripts/clients.sh json  # Raw JSON

Output: Hostname, IP, MAC, AP, signal strength, RX/TX rates

Health Summary

Site-wide health status:

bash scripts/health.sh
bash scripts/health.sh json  # Raw JSON

Output: Subsystem status (WAN, LAN, WLAN), counts (up/adopted/disconnected)

Top Applications (DPI)

Top bandwidth consumers by application:

bash scripts/top-apps.sh
bash scripts/top-apps.sh 15  # Show top 15 (default: 10)

Output: App name, category, RX/TX/total traffic in GB

Recent Alerts

Recent alarms and events:

bash scripts/alerts.sh
bash scripts/alerts.sh 50  # Show last 50 (default: 20)

Output: Timestamp, alarm key, message, affected device

Workflow

When the user asks about UniFi:

"What's on my network?" → Run bash scripts/devices.sh + bash scripts/clients.sh
"Is everything healthy?" → Run bash scripts/health.sh
"Any problems?" → Run bash scripts/alerts.sh
"What's using bandwidth?" → Run bash scripts/top-apps.sh
"Show me a dashboard" or general checkup → Run bash scripts/dashboard.sh

Always confirm the output looks reasonable before presenting it to the user (check for auth failures, empty data, etc.).

Notes

Requires network access to your UniFi gateway
Uses UniFi OS login + /proxy/network API path
All calls are read-only GET requests
Tested endpoints are documented in references/unifi-readonly-endpoints.md

Reference

Tested Endpoints — Full catalog of verified read-only API calls on your Cloud Gateway Max