Fresh start - excluded large ROM JSON files

memory/projects/unifi-monitoring.md

@@ -0,0 +1,66 @@
+# 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
+
+- [x] 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`
+
+```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