← Back to Skills Marketplace
UniFi Network
by
ricanwarfare
· GitHub ↗
· v1.1.0
· MIT-0
148
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install unifi-network
Description
Query and monitor UniFi network via local gateway API (Cloud Gateway Ultra / UniFi OS). Use when the user asks to "check UniFi", "list UniFi devices", "show...
Usage Guidance
This skill appears to do what it says: query a local UniFi gateway using a local admin account. Before installing or running it: (1) create a local read-only UniFi account as recommended (avoid using your cloud/primary admin), (2) be aware the scripts store your credentials in plaintext at ~/.openclaw/credentials/unifi.json — protect that file (restrict permissions) or use an OS-level secret store if possible, (3) the scripts disable TLS verification (curl -k) because many UniFi gateways use self-signed certs — consider whether you accept that risk on your network, (4) the dashboard writes dashboard_debug_dump.json containing the collected API responses in the current working directory — move/remove or audit that file if it contains sensitive info, and (5) the helper logs and performs an auth POST to /api/auth/login (expected for local login). If you accept those privacy/security trade-offs and run the tool in a controlled environment, the skill is coherent with its stated purpose.
Capability Analysis
Type: OpenClaw Skill
Name: unifi-network
Version: 1.1.0
The skill provides comprehensive UniFi network monitoring but employs several high-risk security practices. Specifically, `scripts/unifi-api.sh` explicitly disables SSL certificate verification (`curl -k`), which is a vulnerability that exposes the agent to man-in-the-middle attacks. The skill also requires the storage of local admin credentials in a plaintext JSON file (`~/.openclaw/credentials/unifi.json`). Furthermore, `scripts/dashboard.sh` creates a local debug dump (`dashboard_debug_dump.json`) containing sensitive network data such as firewall rules and port forwards, which could lead to unintended data exposure in the agent's working environment. While these capabilities are plausibly needed for the stated purpose, the lack of transport security and sensitive file handling warrants a suspicious classification.
Capability Assessment
Purpose & Capability
Name/description match the code and runtime instructions. Required binaries (curl, jq) are appropriate for calling the UniFi local API and formatting JSON. The scripts expect a local UniFi gateway and a local credential file (~/.openclaw/credentials/unifi.json), which is reasonable for this purpose.
Instruction Scope
Most runtime instructions stay within monitoring scope (login + GET to site/stat and rest endpoints). However: the scripts create a dashboard_debug_dump.json file (unconditionally) containing collected API responses (potentially sensitive network/config data) and write/read a plaintext credential file in the user's home directory. The code also uses curl -k/-s (skipping TLS verification) which is practical for self-signed UniFi certs but weakens transport security. SKILL.md claims 'GET-only' operations, but the helper performs a POST to /api/auth/login to authenticate (this is expected but is a small mismatch with the 'GET-only' wording).
Install Mechanism
This is an instruction/script-only skill with no install spec. Nothing is downloaded from external URLs or written to system locations by an installer—scripts are included in the bundle. Risk from install mechanism is low.
Credentials
No cloud API keys or unrelated credentials are requested. The skill requires a local credential file with username/password (stored in plaintext) and uses $HOME and temporary cookie files. Requesting local UniFi credentials is proportionate, but plaintext storage and creation of debug dump files merits caution.
Persistence & Privilege
Skill is not always-enabled, does not request system-wide privileges, and does not modify other skills or global agent configuration. It exports helper functions and environment variables within the script scope, which is normal for these scripts.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install unifi-network - After installation, invoke the skill by name or use
/unifi-network - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Synced from openclaw-skills repo
v1.0.0
Initial release of UniFi Network Monitoring skill.
- Monitor and query UniFi network via local gateway API (Cloud Gateway Ultra / UniFi OS).
- Provides dashboards, device/client lists, network health, DPI/top applications, and recent alerts.
- All operations are read-only and safe for monitoring/reporting.
- Simple setup using a credentials file; requires curl and jq.
- Output supports both human-readable tables and raw JSON options.
Metadata
Frequently Asked Questions
What is UniFi Network?
Query and monitor UniFi network via local gateway API (Cloud Gateway Ultra / UniFi OS). Use when the user asks to "check UniFi", "list UniFi devices", "show... It is an AI Agent Skill for Claude Code / OpenClaw, with 148 downloads so far.
How do I install UniFi Network?
Run "/install unifi-network" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is UniFi Network free?
Yes, UniFi Network is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does UniFi Network support?
UniFi Network is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created UniFi Network?
It is built and maintained by ricanwarfare (@ricanwarfare); the current version is v1.1.0.
More Skills