unifi — Skillopedia

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: - : Your UniFi OS gateway IP/hostname (HTTPS) - : Local UniFi OS admin username - : Loc…

\\t'\n","content_type":"application/x-sh; charset=utf-8","language":"bash","size":550,"content_sha256":"f3a2857083bf85e7d092a77320db569012c8f7e4d917904c3a7de8c10afee9fe"},{"filename":"scripts/clients.sh","content":"#!/usr/bin/env bash\n# List active UniFi clients\nset -euo pipefail\n\nSCRIPT_DIR=\"$(cd \"$(dirname \"${BASH_SOURCE[0]}\")\" && pwd)\"\nsource \"$SCRIPT_DIR/unifi-api.sh\"\n\nFORMAT=\"${1:-table}\"\n\ndata=$(unifi_get \"/api/s/$UNIFI_SITE/stat/sta\")\n\nif [ \"$FORMAT\" = \"json\" ]; then\n echo \"$data\"\nelse\n # Table format\n echo \"$data\" | jq -r '\n [\"HOSTNAME\", \"IP\", \"MAC\", \"AP\", \"SIGNAL\", \"RX/TX (Mbps)\"],\n [\"--------\", \"--\", \"---\", \"--\", \"------\", \"------------\"],\n (.data[] | [\n (.hostname // .name // \"Unknown\"),\n .ip,\n .mac,\n (.ap_mac // \"N/A\")[0:17],\n ((.signal // 0 | tostring) + \" dBm\"),\n (((.rx_rate // 0) / 1000 | floor | tostring) + \"/\" + ((.tx_rate // 0) / 1000 | floor | tostring))\n ]) | @tsv\n ' | column -t -s

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.

\\t'\nfi\n","content_type":"application/x-sh; charset=utf-8","language":"bash","size":755,"content_sha256":"543cb1d966a3a5771d0f65053a8e4d64a7c4d9e12cf8d30ffec54c33965ba415"},{"filename":"scripts/dashboard.sh","content":"#!/bin/bash\n# UniFi Network Dashboard - Comprehensive overview\n# Usage: bash dashboard.sh [json]\n\nSCRIPT_DIR=\"$(cd \"$(dirname \"${BASH_SOURCE[0]}\")\" && pwd)\"\nsource \"$SCRIPT_DIR/unifi-api.sh\"\nOUTPUT_FILE=\"$HOME/clawd/memory/bank/unifi-inventory.md\"\n\n# Disable strict mode for dashboard (we handle errors gracefully)\nset +e\n\nOUTPUT_JSON=\"${1:-}\"\n\n# Ensure output directory exists\nmkdir -p \"$(dirname \"$OUTPUT_FILE\")\"\n\n# Create shared session for all requests\nexport UNIFI_COOKIE_FILE=$(mktemp)\ntrap \"rm -f '$UNIFI_COOKIE_FILE'\" EXIT\nunifi_login \"$UNIFI_COOKIE_FILE\"\n\n# Fetch all data upfront (using full API path format)\nHEALTH=$(unifi_get \"/api/s/$UNIFI_SITE/stat/health\")\nDEVICES=$(unifi_get \"/api/s/$UNIFI_SITE/stat/device\")\nCLIENTS=$(unifi_get \"/api/s/$UNIFI_SITE/stat/sta\")\nPORTFWD=$(unifi_get \"/api/s/$UNIFI_SITE/rest/portforward\")\nFWRULES=$(unifi_get \"/api/s/$UNIFI_SITE/rest/firewallrule\")\nNETWORKS=$(unifi_get \"/api/s/$UNIFI_SITE/rest/networkconf\")\nWLANS=$(unifi_get \"/api/s/$UNIFI_SITE/rest/wlanconf\")\nALARMS=$(unifi_get \"/api/s/$UNIFI_SITE/stat/alarm\")\nROUTING=$(unifi_get \"/api/s/$UNIFI_SITE/stat/routing\")\nSYSINFO=$(unifi_get \"/api/s/$UNIFI_SITE/stat/sysinfo\")\n\n# Debug: Dump all JSON to a file for troubleshooting\njq -n \\\n --argjson health \"$HEALTH\" \\\n --argjson devices \"$DEVICES\" \\\n --argjson clients \"$CLIENTS\" \\\n --argjson portforward \"$PORTFWD\" \\\n --argjson networks \"$NETWORKS\" \\\n --argjson wlans \"$WLANS\" \\\n '{health: $health, devices: $devices, clients: $clients, networks: $networks, wlans: $wlans}' \\\n > dashboard_debug_dump.json 2>/dev/null\n\nif [ \"$OUTPUT_JSON\" = \"json\" ]; then\n jq -n \\\n --argjson health \"$HEALTH\" \\\n --argjson devices \"$DEVICES\" \\\n --argjson clients \"$CLIENTS\" \\\n --argjson portforward \"$PORTFWD\" \\\n --argjson firewall \"$FWRULES\" \\\n --argjson networks \"$NETWORKS\" \\\n --argjson wlans \"$WLANS\" \\\n --argjson alarms \"$ALARMS\" \\\n --argjson routing \"$ROUTING\" \\\n --argjson sysinfo \"$SYSINFO\" \\\n '{health: $health, devices: $devices, clients: $clients, portforward: $portforward, firewall: $firewall, networks: $networks, wlans: $wlans, alarms: $alarms, routing: $routing, sysinfo: $sysinfo}'\n exit 0\nfi\n\n# Generate dashboard output and save to file\n{\n echo \"╔══════════════════════════════════════════════════════════════════════════════╗\"\n echo \"║ UNIFI NETWORK DASHBOARD ║\"\n echo \"╚══════════════════════════════════════════════════════════════════════════════╝\"\n echo \"\"\n\n # System Info\n echo \"┌─────────────────────────────────────────────────────────────────────────────┐\"\n echo \"│ SYSTEM INFO │\"\n echo \"└─────────────────────────────────────────────────────────────────────────────┘\"\n echo \"$SYSINFO\" | jq -r '\n .data[0] | \n \"Version: \\(.version // \"N/A\") | Hostname: \\(.hostname // \"N/A\") | Timezone: \\(.timezone // \"N/A\")\"\n ' 2>/dev/null || echo \" Unable to fetch system info\"\n echo \"\"\n\n # Health Overview\n echo \"┌─────────────────────────────────────────────────────────────────────────────┐\"\n echo \"│ HEALTH STATUS │\"\n echo \"└─────────────────────────────────────────────────────────────────────────────┘\"\n echo \"$HEALTH\" | jq -r '\n .data[] | \n \"\\(.subsystem | ascii_upcase): \\(if .status == \"ok\" then \"✅ OK\" else \"⚠️ \\(.status)\" end) | Gateways: \\(.gw_mac // \"N/A\") | Clients: \\(.num_user // 0)\"\n ' 2>/dev/null | head -10\n echo \"\"\n\n # Devices\n echo \"┌─────────────────────────────────────────────────────────────────────────────┐\"\n echo \"│ UNIFI DEVICES │\"\n echo \"└─────────────────────────────────────────────────────────────────────────────┘\"\n printf \"%-20s %-10s %-15s %-8s %-10s %-8s\\n\" \"NAME\" \"MODEL\" \"IP\" \"STATE\" \"UPTIME\" \"CLIENTS\"\n printf \"%-20s %-10s %-15s %-8s %-10s %-8s\\n\" \"----\" \"-----\" \"--\" \"-----\" \"------\" \"-------\"\n echo \"$DEVICES\" | jq -r '\n .data[] | \n [\n ((.name // .hostname // .mac)[:20]),\n ((.model // \"N/A\")[:10]),\n ((.ip // \"N/A\")[:15]),\n (if .state == 1 then \"✅\" else \"❌\" end),\n (((.uptime // 0) / 3600 | floor | tostring + \"h\")),\n ((.num_sta // 0 | tostring))\n ] | @tsv\n ' 2>/dev/null | while IFS=

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.

\\t' read -r name model ip state uptime clients; do\n printf \"%-20s %-10s %-15s %-8s %-10s %-8s\\n\" \"$name\" \"$model\" \"$ip\" \"$state\" \"$uptime\" \"$clients\"\n done\n echo \"\"\n\n # Client Summary\n TOTAL_CLIENTS=$(echo \"$CLIENTS\" | jq '.data | length' 2>/dev/null || echo 0)\n WIRED_CLIENTS=$(echo \"$CLIENTS\" | jq '[.data[] | select(.is_wired == true)] | length' 2>/dev/null || echo 0)\n WIFI_CLIENTS=$(echo \"$CLIENTS\" | jq '[.data[] | select(.is_wired == false)] | length' 2>/dev/null || echo 0)\n\n echo \"┌─────────────────────────────────────────────────────────────────────────────┐\"\n echo \"│ CLIENTS: $TOTAL_CLIENTS total ($WIRED_CLIENTS wired, $WIFI_CLIENTS wireless) │\"\n echo \"└─────────────────────────────────────────────────────────────────────────────┘\"\n printf \"%-25s %-15s %-18s %-10s %-12s\\n\" \"HOSTNAME\" \"IP\" \"MAC\" \"TYPE\" \"TX/RX MB/s\"\n printf \"%-25s %-15s %-18s %-10s %-12s\\n\" \"--------\" \"--\" \"---\" \"----\" \"----------\"\n echo \"$CLIENTS\" | jq -r '\n .data | sort_by(-(.[\"wired-rx_bytes\"] // .rx_bytes // 0)) | .[0:15] | .[] |\n [\n ((.name // .hostname // .mac // \"Unknown\") | tostring | .[:25]),\n ((.ip // .last_ip // \"N/A\") | tostring | .[:15]),\n ((.mac // \"N/A\") | tostring | .[:18]),\n (if .is_wired == true then \"Wired\" else \"WiFi\" end),\n \"\\( ((.[\"tx_bytes-r\"] // .[\"wired-tx_bytes-r\"] // 0) / 1000000 * 10 | floor / 10) )/\\( ((.[\"rx_bytes-r\"] // .[\"wired-rx_bytes-r\"] // 0) / 1000000 * 10 | floor / 10) )\"\n ] | @tsv\n ' 2>/dev/null | while IFS=

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.

\\t' read -r hostname ip mac type rate; do\n printf \"%-25s %-15s %-18s %-10s %-12s\\n\" \"$hostname\" \"$ip\" \"$mac\" \"$type\" \"$rate\"\n done || echo \" (error parsing client data)\"\n echo \" (showing top 15 by traffic)\"\n echo \"\"\n\n # Networks\n echo \"┌─────────────────────────────────────────────────────────────────────────────┐\"\n echo \"│ NETWORKS │\"\n echo \"└─────────────────────────────────────────────────────────────────────────────┘\"\n printf \"%-25s %-8s %-18s %-10s %-15s\\n\" \"NAME\" \"VLAN\" \"SUBNET\" \"PURPOSE\" \"DHCP\"\n printf \"%-25s %-8s %-18s %-10s %-15s\\n\" \"----\" \"----\" \"------\" \"-------\" \"----\"\n # Check if networks returned an error\n if echo \"$NETWORKS\" | jq -e '.error' >/dev/null 2>&1; then\n echo \" (API returned 401 - REST endpoints may require additional permissions)\"\n else\n echo \"$NETWORKS\" | jq -r '\n .data[] | \n [\n ((.name // \"N/A\") | tostring | .[:25]),\n ((.vlan // \"-\") | tostring | .[:8]),\n ((.ip_subnet // \"N/A\") | tostring | .[:18]),\n ((.purpose // \"N/A\") | tostring | .[:10]),\n (if .dhcpd_enabled == true then \"Enabled\" else \"Disabled\" end)\n ] | @tsv\n ' 2>/dev/null | while IFS=

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.

\\t' read -r name vlan subnet purpose dhcp; do\n printf \"%-25s %-8s %-18s %-10s %-15s\\n\" \"$name\" \"$vlan\" \"$subnet\" \"$purpose\" \"$dhcp\"\n done\n fi\n echo \"\"\n\n # WLANs\n echo \"┌─────────────────────────────────────────────────────────────────────────────┐\"\n echo \"│ WIRELESS NETWORKS │\"\n echo \"└─────────────────────────────────────────────────────────────────────────────┘\"\n printf \"%-30s %-10s %-15s %-10s\\n\" \"SSID\" \"ENABLED\" \"SECURITY\" \"BAND\"\n printf \"%-30s %-10s %-15s %-10s\\n\" \"----\" \"-------\" \"--------\" \"----\"\n # Check if wlans returned an error\n if echo \"$WLANS\" | jq -e '.error' >/dev/null 2>&1; then\n echo \" (API returned 401 - REST endpoints may require additional permissions)\"\n else\n echo \"$WLANS\" | jq -r '\n .data[] | \n [\n ((.name // \"N/A\") | tostring | .[:30]),\n (if .enabled == true then \"✅\" else \"❌\" end),\n ((.security // \"open\") | tostring | .[:15]),\n ((if .wlan_band then .wlan_band else \"both\" end) | tostring | .[:10])\n ] | @tsv\n ' 2>/dev/null | while IFS=

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.

\\t' read -r ssid enabled security band; do\n printf \"%-30s %-10s %-15s %-10s\\n\" \"$ssid\" \"$enabled\" \"$security\" \"$band\"\n done\n fi\n echo \"\"\n\n # Port Forwards\n echo \"┌─────────────────────────────────────────────────────────────────────────────┐\"\n echo \"│ PORT FORWARDS │\"\n echo \"└─────────────────────────────────────────────────────────────────────────────┘\"\n PF_COUNT=$(echo \"$PORTFWD\" | jq '.data | length' 2>/dev/null || echo 0)\n if [ \"$PF_COUNT\" -eq 0 ]; then\n echo \" No port forwards configured\"\n else\n printf \"%-25s %-10s %-8s %-15s %-8s %-10s\\n\" \"NAME\" \"ENABLED\" \"PROTO\" \"FWD TO\" \"PORT\" \"SRC PORT\"\n printf \"%-25s %-10s %-8s %-15s %-8s %-10s\\n\" \"----\" \"-------\" \"-----\" \"------\" \"----\" \"--------\"\n echo \"$PORTFWD\" | jq -r '\n .data[] | \n [\n ((.name // \"N/A\") | tostring | .[:25]),\n (if .enabled == true then \"✅\" else \"❌\" end),\n ((.proto // \"tcp\") | tostring | .[:8]),\n ((.fwd // \"N/A\") | tostring | .[:15]),\n ((.fwd_port // \"-\") | tostring | .[:8]),\n ((.src_port // .dst_port // \"-\") | tostring | .[:10])\n ] | @tsv\n ' 2>/dev/null | while IFS=

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.

\\t' read -r name enabled proto fwd port srcport; do\n printf \"%-25s %-10s %-8s %-15s %-8s %-10s\\n\" \"$name\" \"$enabled\" \"$proto\" \"$fwd\" \"$port\" \"$srcport\"\n done\n fi\n echo \"\"\n\n # Firewall Rules\n echo \"┌─────────────────────────────────────────────────────────────────────────────┐\"\n echo \"│ FIREWALL RULES │\"\n echo \"└─────────────────────────────────────────────────────────────────────────────┘\"\n FW_COUNT=$(echo \"$FWRULES\" | jq '.data | length' 2>/dev/null || echo 0)\n if [ \"$FW_COUNT\" -eq 0 ]; then\n echo \" No custom firewall rules configured\"\n else\n printf \"%-25s %-10s %-10s %-10s %-10s %-10s\\n\" \"NAME\" \"ENABLED\" \"ACTION\" \"PROTO\" \"RULESET\" \"INDEX\"\n printf \"%-25s %-10s %-10s %-10s %-10s %-10s\\n\" \"----\" \"-------\" \"------\" \"-----\" \"-------\" \"-----\"\n echo \"$FWRULES\" | jq -r '\n .data | sort_by(.rule_index) | .[] | \n [\n ((.name // \"N/A\") | tostring | .[:25]),\n (if .enabled == true then \"✅\" else \"❌\" end),\n ((.action // \"N/A\") | tostring | .[:10]),\n ((.protocol // \"all\") | tostring | .[:10]),\n ((.ruleset // \"N/A\") | tostring | .[:10]),\n ((.rule_index // 0) | tostring)\n ] | @tsv\n ' 2>/dev/null | while IFS=

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.

\\t' read -r name enabled action proto ruleset idx; do\n printf \"%-25s %-10s %-10s %-10s %-10s %-10s\\n\" \"$name\" \"$enabled\" \"$action\" \"$proto\" \"$ruleset\" \"$idx\"\n done\n fi\n echo \"\"\n\n # Static Routes\n echo \"┌─────────────────────────────────────────────────────────────────────────────┐\"\n echo \"│ ROUTES │\"\n echo \"└─────────────────────────────────────────────────────────────────────────────┘\"\n ROUTE_COUNT=$(echo \"$ROUTING\" | jq '.data | length' 2>/dev/null || echo 0)\n if [ \"$ROUTE_COUNT\" -eq 0 ]; then\n echo \" No static routes (using default)\"\n else\n printf \"%-20s %-18s %-15s %-12s %-10s\\n\" \"NAME\" \"DESTINATION\" \"NEXT HOP\" \"INTERFACE\" \"METRIC\"\n printf \"%-20s %-18s %-15s %-12s %-10s\\n\" \"----\" \"-----------\" \"--------\" \"---------\" \"------\"\n echo \"$ROUTING\" | jq -r '\n .data[] | \n [\n ((.name // .pfx // \"N/A\") | tostring | .[:20]),\n ((.pfx // \"N/A\") | tostring | .[:18]),\n ((.nh[0].t // .nh[0].gw // \"N/A\") | tostring | .[:15]),\n ((.nh[0].intf_name // \"N/A\") | tostring | .[:12]),\n ((.metric // 0) | tostring)\n ] | @tsv\n ' 2>/dev/null | head -10 | while IFS=

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.

\\t' read -r name dest nexthop intf metric; do\n printf \"%-20s %-18s %-15s %-12s %-10s\\n\" \"$name\" \"$dest\" \"$nexthop\" \"$intf\" \"$metric\"\n done\n fi\n echo \"\"\n\n # Recent Alarms\n echo \"┌─────────────────────────────────────────────────────────────────────────────┐\"\n echo \"│ RECENT ALARMS (last 10) │\"\n echo \"└─────────────────────────────────────────────────────────────────────────────┘\"\n ALARM_COUNT=$(echo \"$ALARMS\" | jq '.data | length' 2>/dev/null || echo 0)\n if [ \"$ALARM_COUNT\" -eq 0 ]; then\n echo \" ✅ No recent alarms\"\n else\n printf \"%-20s %-50s\\n\" \"TIME\" \"MESSAGE\"\n printf \"%-20s %-50s\\n\" \"----\" \"-------\"\n echo \"$ALARMS\" | jq -r '\n .data | sort_by(-.time) | .[0:10] | .[] |\n [\n ((.datetime // (.time | todate? // \"N/A\"))[:20]),\n ((.msg // .key // \"N/A\")[:50])\n ] | @tsv\n ' 2>/dev/null | while IFS=

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.

\\t' read -r time msg; do\n printf \"%-20s %-50s\\n\" \"$time\" \"$msg\"\n done\n fi\n echo \"\"\n\n echo \"╔══════════════════════════════════════════════════════════════════════════════╗\"\n echo \"║ Dashboard generated at $(date '+%Y-%m-%d %H:%M:%S') ║\"\n echo \"╚══════════════════════════════════════════════════════════════════════════════╝\"\n} | tee \"$OUTPUT_FILE\"\n","content_type":"application/x-sh; charset=utf-8","language":"bash","size":17852,"content_sha256":"88ffd244406813aeefb925abefb8405ea6a6dd6b845b555c203fdf2fbe6f0065"},{"filename":"scripts/devices.sh","content":"#!/usr/bin/env bash\n# List UniFi devices (APs, switches, gateway)\nset -euo pipefail\n\nSCRIPT_DIR=\"$(cd \"$(dirname \"${BASH_SOURCE[0]}\")\" && pwd)\"\nsource \"$SCRIPT_DIR/unifi-api.sh\"\n\nFORMAT=\"${1:-table}\"\n\ndata=$(unifi_get \"/api/s/$UNIFI_SITE/stat/device\")\n\nif [ \"$FORMAT\" = \"json\" ]; then\n echo \"$data\"\nelse\n # Table format\n echo \"$data\" | jq -r '\n [\"NAME\", \"MODEL\", \"IP\", \"STATE\", \"UPTIME\", \"CLIENTS\"],\n [\"----\", \"-----\", \"--\", \"-----\", \"------\", \"-------\"],\n (.data[] | [\n .name // .mac,\n .model,\n .ip,\n .state_name // .state,\n (.uptime | if . then (. / 3600 | floor | tostring) + \"h\" else \"N/A\" end),\n (.num_sta // 0 | tostring)\n ]) | @tsv\n ' | column -t -s

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.

\\t'\nfi\n","content_type":"application/x-sh; charset=utf-8","language":"bash","size":712,"content_sha256":"eca43cad67a05c8d876bceaf57a60c7c2cb6dfaf817fc0c27dabf53831a3c518"},{"filename":"scripts/health.sh","content":"#!/usr/bin/env bash\n# UniFi site health summary\nset -euo pipefail\n\nSCRIPT_DIR=\"$(cd \"$(dirname \"${BASH_SOURCE[0]}\")\" && pwd)\"\nsource \"$SCRIPT_DIR/unifi-api.sh\"\n\nFORMAT=\"${1:-table}\"\n\ndata=$(unifi_get \"/api/s/$UNIFI_SITE/stat/health\")\n\nif [ \"$FORMAT\" = \"json\" ]; then\n echo \"$data\"\nelse\n # Table format\n echo \"$data\" | jq -r '\n [\"SUBSYSTEM\", \"STATUS\", \"# UP\", \"# ADOPTED\", \"# DISCONNECTED\"],\n [\"---------\", \"------\", \"----\", \"---------\", \"--------------\"],\n (.data[] | [\n .subsystem,\n .status,\n (.num_user // .num_ap // .num_sw // .num_gw // 0 | tostring),\n (.num_adopted // 0 | tostring),\n (.num_disconnected // 0 | tostring)\n ]) | @tsv\n ' | column -t -s

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.

\\t'\nfi\n","content_type":"application/x-sh; charset=utf-8","language":"bash","size":705,"content_sha256":"b5b60747d03181783e3e07df29fc0317488e9cbc17e4f904faeef812ec2158e0"},{"filename":"scripts/top-apps.sh","content":"#!/usr/bin/env bash\n# Top applications by traffic (DPI)\nset -euo pipefail\n\nSCRIPT_DIR=\"$(cd \"$(dirname \"${BASH_SOURCE[0]}\")\" && pwd)\"\nsource \"$SCRIPT_DIR/unifi-api.sh\"\n\nLIMIT=\"${1:-10}\"\n\ndata=$(unifi_get \"/api/s/$UNIFI_SITE/stat/sitedpi\")\n\necho \"$data\" | jq -r --argjson limit \"$LIMIT\" '\n [\"APP\", \"CATEGORY\", \"RX (GB)\", \"TX (GB)\", \"TOTAL (GB)\"],\n [\"---\", \"--------\", \"-------\", \"-------\", \"----------\"],\n (.data[0].by_app // [] \n | sort_by(-.tx_bytes + -.rx_bytes) \n | .[:$limit][] \n | [\n .app,\n .cat,\n ((.rx_bytes // 0) / 1073741824 | . * 100 | floor / 100 | tostring),\n ((.tx_bytes // 0) / 1073741824 | . * 100 | floor / 100 | tostring),\n (((.rx_bytes // 0) + (.tx_bytes // 0)) / 1073741824 | . * 100 | floor / 100 | tostring)\n ]\n ) | @tsv\n' | column -t -s

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.

\\t'\n","content_type":"application/x-sh; charset=utf-8","language":"bash","size":803,"content_sha256":"512154ad0b3c90e393c50937269355dc6bf9ad613c6ebe0c583d6c317d9d377e"},{"filename":"scripts/unifi-api.sh","content":"#!/usr/bin/env bash\n# UniFi API helper - handles login and authenticated calls\nset -euo pipefail\n\nSCRIPT_DIR=\"$(cd \"$(dirname \"${BASH_SOURCE[0]}\")\" && pwd)\"\nCONFIG_FILE=\"${UNIFI_CONFIG_FILE:-$HOME/.clawdbot/credentials/unifi/config.json}\"\n\n# Load config\nif [ ! -f \"$CONFIG_FILE\" ]; then\n echo \"Error: UniFi not configured. Create $CONFIG_FILE with {\\\"url\\\": \\\"https://...\\\", \\\"username\\\": \\\"...\\\", \\\"password\\\": \\\"...\\\", \\\"site\\\": \\\"default\\\"}\" >&2\n exit 1\nfi\n\nUNIFI_URL=$(jq -r '.url' \"$CONFIG_FILE\")\nUNIFI_USER=$(jq -r '.username' \"$CONFIG_FILE\")\nUNIFI_PASS=$(jq -r '.password' \"$CONFIG_FILE\")\nUNIFI_SITE=$(jq -r '.site // \"default\"' \"$CONFIG_FILE\")\n\n# Login and store cookie\n# Usage: unifi_login [cookie_file_path]\nunifi_login() {\n local cookie_file=\"${1:-${UNIFI_COOKIE_FILE:-$(mktemp)}}\"\n \n # If it's a temp file we created just now, export it so subsequent calls use it\n if [ -z \"${UNIFI_COOKIE_FILE:-}\" ]; then\n export UNIFI_COOKIE_FILE=\"$cookie_file\"\n fi\n\n local payload\n payload=$(jq -nc --arg username \"$UNIFI_USER\" --arg password \"$UNIFI_PASS\" '{username:$username,password:$password}')\n \n # Try login\n curl -sk -c \"$cookie_file\" \\\n -H \"Content-Type: application/json\" \\\n -X POST \\\n \"$UNIFI_URL/api/auth/login\" \\\n --data \"$payload\" >/dev/null\n\n if [ ! -s \"$cookie_file\" ]; then\n echo \"Error: Login failed (empty cookie file)\" >&2\n return 1\n fi\n}\n\n# Make authenticated GET request\n# Usage: unifi_get \u003cendpoint>\n# Endpoint should be like \"stat/sta\" or \"rest/portforward\" - site path is added automatically\n# Uses UNIFI_COOKIE_FILE if set, otherwise logs in temporarily\nunifi_get() {\n local endpoint=\"$1\"\n local temp_cookie=false\n \n # Ensure we have a cookie\n if [ -z \"${UNIFI_COOKIE_FILE:-}\" ] || [ ! -f \"$UNIFI_COOKIE_FILE\" ]; then\n temp_cookie=true\n export UNIFI_COOKIE_FILE=$(mktemp)\n unifi_login \"$UNIFI_COOKIE_FILE\"\n fi\n \n # Handle both old format (/api/s/site/...) and new format (stat/...)\n local full_url\n if [[ \"$endpoint\" == /api/* ]]; then\n # Old format - use as-is with proxy/network prefix\n full_url=\"$UNIFI_URL/proxy/network$endpoint\"\n else\n # New format - add full path\n full_url=\"$UNIFI_URL/proxy/network/api/s/$UNIFI_SITE/$endpoint\"\n fi\n \n curl -sk -b \"$UNIFI_COOKIE_FILE\" \"$full_url\"\n \n # Cleanup if we created a temp cookie just for this request\n if [ \"$temp_cookie\" = true ]; then\n rm -f \"$UNIFI_COOKIE_FILE\"\n unset UNIFI_COOKIE_FILE\n fi\n}\n\nexport -f unifi_login\nexport -f unifi_get\nexport UNIFI_URL UNIFI_SITE\n","content_type":"application/x-sh; charset=utf-8","language":"bash","size":2522,"content_sha256":"4fc2401596439bc9304d66388058132a932cbcbdf670959dd1dc23798db399c5"}],"content_json":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"UniFi Network Monitoring Skill","type":"text"}]},{"type":"paragraph","content":[{"text":"Monitor and query your UniFi network via the local UniFi OS gateway API (tested on Cloud Gateway Max).","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Purpose","type":"text"}]},{"type":"paragraph","content":[{"text":"This skill provides ","type":"text"},{"text":"read-only","type":"text","marks":[{"type":"strong"}]},{"text":" access to your UniFi network's operational data:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Devices (APs, switches, gateway) status and health","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Active clients (who's connected where)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Network health overview","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Traffic insights (top applications via DPI)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Recent alarms and events","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"All operations are ","type":"text"},{"text":"GET-only","type":"text","marks":[{"type":"strong"}]},{"text":" and safe for monitoring/reporting.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Setup","type":"text"}]},{"type":"paragraph","content":[{"text":"Create the credentials file: ","type":"text"},{"text":"~/.clawdbot/credentials/unifi/config.json","type":"text","marks":[{"type":"code_inline"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"json"},"content":[{"text":"{\n \"url\": \"https://10.1.0.1\",\n \"username\": \"api\",\n \"password\": \"YOUR_PASSWORD\",\n \"site\": \"default\"\n}","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"url","type":"text","marks":[{"type":"code_inline"}]},{"text":": Your UniFi OS gateway IP/hostname (HTTPS)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"username","type":"text","marks":[{"type":"code_inline"}]},{"text":": Local UniFi OS admin username","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"password","type":"text","marks":[{"type":"code_inline"}]},{"text":": Local UniFi OS admin password","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"site","type":"text","marks":[{"type":"code_inline"}]},{"text":": Site name (usually ","type":"text"},{"text":"default","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Commands","type":"text"}]},{"type":"paragraph","content":[{"text":"All commands support optional ","type":"text"},{"text":"json","type":"text","marks":[{"type":"code_inline"}]},{"text":" argument for raw JSON output (default is human-readable table).","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Network Dashboard","type":"text"}]},{"type":"paragraph","content":[{"text":"Comprehensive view of all network stats (Health, Devices, Clients, Networks, DPI, etc.):","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"bash scripts/dashboard.sh\nbash scripts/dashboard.sh json # Raw JSON for all sections","type":"text"}]},{"type":"paragraph","content":[{"text":"Output:","type":"text","marks":[{"type":"strong"}]},{"text":" Full ASCII dashboard with all metrics.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"List Devices","type":"text"}]},{"type":"paragraph","content":[{"text":"Shows all UniFi devices (APs, switches, gateway):","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"bash scripts/devices.sh\nbash scripts/devices.sh json # Raw JSON","type":"text"}]},{"type":"paragraph","content":[{"text":"Output:","type":"text","marks":[{"type":"strong"}]},{"text":" Device name, model, IP, state, uptime, connected clients","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"List Active Clients","type":"text"}]},{"type":"paragraph","content":[{"text":"Shows who's currently connected:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"bash scripts/clients.sh\nbash scripts/clients.sh json # Raw JSON","type":"text"}]},{"type":"paragraph","content":[{"text":"Output:","type":"text","marks":[{"type":"strong"}]},{"text":" Hostname, IP, MAC, AP, signal strength, RX/TX rates","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Health Summary","type":"text"}]},{"type":"paragraph","content":[{"text":"Site-wide health status:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"bash scripts/health.sh\nbash scripts/health.sh json # Raw JSON","type":"text"}]},{"type":"paragraph","content":[{"text":"Output:","type":"text","marks":[{"type":"strong"}]},{"text":" Subsystem status (WAN, LAN, WLAN), counts (up/adopted/disconnected)","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Top Applications (DPI)","type":"text"}]},{"type":"paragraph","content":[{"text":"Top bandwidth consumers by application:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"bash scripts/top-apps.sh\nbash scripts/top-apps.sh 15 # Show top 15 (default: 10)","type":"text"}]},{"type":"paragraph","content":[{"text":"Output:","type":"text","marks":[{"type":"strong"}]},{"text":" App name, category, RX/TX/total traffic in GB","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Recent Alerts","type":"text"}]},{"type":"paragraph","content":[{"text":"Recent alarms and events:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"bash scripts/alerts.sh\nbash scripts/alerts.sh 50 # Show last 50 (default: 20)","type":"text"}]},{"type":"paragraph","content":[{"text":"Output:","type":"text","marks":[{"type":"strong"}]},{"text":" Timestamp, alarm key, message, affected device","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Workflow","type":"text"}]},{"type":"paragraph","content":[{"text":"When the user asks about UniFi:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"What's on my network?\"","type":"text","marks":[{"type":"strong"}]},{"text":" → Run ","type":"text"},{"text":"bash scripts/devices.sh","type":"text","marks":[{"type":"code_inline"}]},{"text":" + ","type":"text"},{"text":"bash scripts/clients.sh","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"Is everything healthy?\"","type":"text","marks":[{"type":"strong"}]},{"text":" → Run ","type":"text"},{"text":"bash scripts/health.sh","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"Any problems?\"","type":"text","marks":[{"type":"strong"}]},{"text":" → Run ","type":"text"},{"text":"bash scripts/alerts.sh","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"What's using bandwidth?\"","type":"text","marks":[{"type":"strong"}]},{"text":" → Run ","type":"text"},{"text":"bash scripts/top-apps.sh","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"Show me a dashboard\"","type":"text","marks":[{"type":"strong"}]},{"text":" or general checkup → Run ","type":"text"},{"text":"bash scripts/dashboard.sh","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"paragraph","content":[{"text":"Always confirm the output looks reasonable before presenting it to the user (check for auth failures, empty data, etc.).","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Notes","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Requires network access to your UniFi gateway","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Uses UniFi OS login + ","type":"text"},{"text":"/proxy/network","type":"text","marks":[{"type":"code_inline"}]},{"text":" API path","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"All calls are ","type":"text"},{"text":"read-only GET requests","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Tested endpoints are documented in ","type":"text"},{"text":"references/unifi-readonly-endpoints.md","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Reference","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Tested Endpoints","type":"text","marks":[{"type":"link","attrs":{"href":"references/unifi-readonly-endpoints.md","title":null}}]},{"text":" — Full catalog of verified read-only API calls on your Cloud Gateway Max","type":"text"}]}]}]},{"type":"hr","attrs":{"markup":"---"}}]},"metadata":{"date":"2026-06-05","name":"unifi","author":"@skillopedia","source":{"stars":609,"repo_name":"awesome-openclaw-skills","origin_url":"https://github.com/sundial-org/awesome-openclaw-skills/blob/HEAD/skills/unifi/SKILL.md","repo_owner":"sundial-org","body_sha256":"029aca0f0bd6dfc5ce873082a950723f6c8bf209e60de6b4476a24bc4aee662a","cluster_key":"d81e591524a3365b17b3abd6aceef5b438c03ac0065cc3f2f570302fcab85062","clean_bundle":{"format":"clean-skill-bundle-v1","source":"sundial-org/awesome-openclaw-skills/skills/unifi/SKILL.md","attachments":[{"id":"429f12fa-ab24-56ea-aaca-39c5ef2a40d5","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/429f12fa-ab24-56ea-aaca-39c5ef2a40d5/attachment.md","path":"README.md","size":2545,"sha256":"84a9486ec8f9bb7db3727bbf1addc806415f928e88d0daeecd9462b6e837c4a3","contentType":"text/markdown; charset=utf-8"},{"id":"f3322173-5929-5ae2-8a1d-b0b444012626","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/f3322173-5929-5ae2-8a1d-b0b444012626/attachment.md","path":"references/unifi-readonly-endpoints.md","size":6489,"sha256":"a64d35174a543cac16a46190bff6b9391da0fcb259ca07847e23226d26fbea62","contentType":"text/markdown; charset=utf-8"},{"id":"08260aa2-f02c-5c49-9b9a-b0a56f12e21f","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/08260aa2-f02c-5c49-9b9a-b0a56f12e21f/attachment.sh","path":"scripts/alerts.sh","size":550,"sha256":"f3a2857083bf85e7d092a77320db569012c8f7e4d917904c3a7de8c10afee9fe","contentType":"application/x-sh; charset=utf-8"},{"id":"daf17180-d256-587e-ba43-514832c55e53","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/daf17180-d256-587e-ba43-514832c55e53/attachment.sh","path":"scripts/clients.sh","size":755,"sha256":"543cb1d966a3a5771d0f65053a8e4d64a7c4d9e12cf8d30ffec54c33965ba415","contentType":"application/x-sh; charset=utf-8"},{"id":"2c3294ad-3281-5a44-b97f-fa30028c0c88","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/2c3294ad-3281-5a44-b97f-fa30028c0c88/attachment.sh","path":"scripts/dashboard.sh","size":17852,"sha256":"88ffd244406813aeefb925abefb8405ea6a6dd6b845b555c203fdf2fbe6f0065","contentType":"application/x-sh; charset=utf-8"},{"id":"df01e781-8552-50c9-baea-09ecc2903c00","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/df01e781-8552-50c9-baea-09ecc2903c00/attachment.sh","path":"scripts/devices.sh","size":712,"sha256":"eca43cad67a05c8d876bceaf57a60c7c2cb6dfaf817fc0c27dabf53831a3c518","contentType":"application/x-sh; charset=utf-8"},{"id":"c3370006-65ab-55c7-bedb-c2c156b867bf","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/c3370006-65ab-55c7-bedb-c2c156b867bf/attachment.sh","path":"scripts/health.sh","size":705,"sha256":"b5b60747d03181783e3e07df29fc0317488e9cbc17e4f904faeef812ec2158e0","contentType":"application/x-sh; charset=utf-8"},{"id":"699e4418-9c13-5dbb-b587-186d61de2f1d","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/699e4418-9c13-5dbb-b587-186d61de2f1d/attachment.sh","path":"scripts/top-apps.sh","size":803,"sha256":"512154ad0b3c90e393c50937269355dc6bf9ad613c6ebe0c583d6c317d9d377e","contentType":"application/x-sh; charset=utf-8"},{"id":"5baa9cc2-b7a6-5295-9141-d4baeea94752","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/5baa9cc2-b7a6-5295-9141-d4baeea94752/attachment.sh","path":"scripts/unifi-api.sh","size":2522,"sha256":"4fc2401596439bc9304d66388058132a932cbcbdf670959dd1dc23798db399c5","contentType":"application/x-sh; charset=utf-8"}],"bundle_sha256":"6a64b9b41bee8dd001a1a20313e3282b4f120f7d1ff68d6939293e606fcc7fb1","attachment_count":9,"text_attachments":9,"attachment_storage":"skillopedia-attachments-v1","binary_attachments":0,"excluded_attachments":[]},"cluster_size":1,"skill_md_path":"skills/unifi/SKILL.md","import_metadata":{"date":"2026-06-05","author":"@skillopedia","version":"v1","category":"devops-infrastructure","category_label":"DevOps"},"exact_dupes_collapsed_into_this":0},"version":"v1","category":"devops-infrastructure","metadata":{"clawdbot":{"emoji":"📡","requires":{"bins":["curl","jq"]}}},"import_tag":"clean-skills-v1","description":"Query and monitor UniFi network via local gateway API (Cloud Gateway Max / UniFi OS). Use when the user asks to \"check UniFi\", \"list UniFi devices\", \"show who's on the network\", \"UniFi clients\", \"UniFi health\", \"top apps\", \"network alerts\", \"UniFi DPI\", or mentions UniFi monitoring/status/dashboard."}},"renderedAt":1782981101883}

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.