openclaw-workspace/memory/projects/unifi-monitoring.md

UniFi Network Monitoring

Status: 🔄 In Progress
Location: ~/.openclaw/workspace/skills/unifi/
Added: 2026-02-27

Overview

Network monitoring via UniFi Controller API. Read-only access to:

• Device status (APs, switches, USG)
• Connected clients
• Network health
• DPI traffic stats
• Alerts/alarms

Hardware

• Gateway: UniFi USG
• Controller: Running on Home Assistant box (192.168.0.39:8123)
• API URL: https://192.168.0.39:8443 (standard controller port)

Setup Status

• Skill files installed
• Credentials configured
• Connection tested
• Commands verified working

Commands

Script	Purpose
bash scripts/devices.sh	List UniFi devices
bash scripts/clients.sh	List connected clients
bash scripts/health.sh	Network health
bash scripts/top-apps.sh	Top bandwidth consumers
bash scripts/alerts.sh	Recent alarms
bash scripts/dashboard.sh	Full dashboard

All support json argument for raw output.

Configuration

File: ~/.clawdbot/credentials/unifi/config.json

{
  "url": "https://192.168.0.39:8443",
  "username": "admin",
  "password": "YOUR_PASSWORD",
  "site": "default"
}

Notes

• Requires local admin account (not UniFi SSO)
• Scripts use curl -k for self-signed controller certs
• DPI must be enabled in UniFi for bandwidth stats
• Read-only API access (safe for monitoring)

Related

• Skill Docs: skills/unifi/README.md
• API Reference: skills/unifi/references/unifi-readonly-endpoints.md
• Source: OpenClaw official skills repo