← 返回 Skills 市场
ricanwarfare

UniFi Network

作者 ricanwarfare · GitHub ↗ · v1.1.0 · MIT-0
cross-platform ⚠ suspicious
148
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install 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...
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install unifi-network
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /unifi-network 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
Slug unifi-network
版本 1.1.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 148 次。

如何安装 UniFi Network?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install unifi-network」即可一键安装,无需额外配置。

UniFi Network 是免费的吗?

是的,UniFi Network 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

UniFi Network 支持哪些平台?

UniFi Network 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 UniFi Network?

由 ricanwarfare(@ricanwarfare)开发并维护,当前版本 v1.1.0。

💬 留言讨论