← 返回 Skills 市场
jmagar

Unifi

作者 jmagar · GitHub ↗ · v1.0.1
cross-platform ⚠ suspicious
3381
总下载
3
收藏
13
当前安装
2
版本数
在 OpenClaw 中安装
/install unifi
功能描述
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.
安全使用建议
This skill appears to implement a legitimate UniFi read-only monitor, but review and accept a few risks before installing: - Credentials: the skill requires a local UniFi admin username/password stored in ~/.clawdbot/credentials/unifi/config.json (or via environment variables). That file contains plaintext credentials — ensure you set restrictive permissions (chmod 600) and consider creating a dedicated low-privilege local admin for the API. - Metadata mismatch: the registry entry lists no required config paths/env, but the skill actually requires the config file or env vars. Treat this as an indicator the package metadata is incomplete; verify the file location and ownership before running. - Disk writes: the scripts write files (dashboard_debug_dump.json and $HOME/clawd/memory/bank/unifi-inventory.md) that contain sensitive network data. If you don’t want that persisted, edit the scripts to disable dumps or change paths to a secure location. - SSL verification: the scripts use curl -k to skip TLS verification (common with self-signed UniFi certs). This is insecure in network environments where the gateway might be spoofed — if possible, use a valid certificate or modify scripts to verify certs. - Review scripts locally: because this is an instruction-based skill with runnable shell scripts, inspect scripts locally before use and consider running them in a controlled environment first. If you’re uncomfortable with plaintext creds or disk persistence, either modify the scripts to use a more secure auth method (token, restricted account) or do not install. If you want, I can list the exact places in the scripts to change to improve security (e.g., remove debug dump, enforce cert verification, set strict file perms).
功能分析
Type: OpenClaw Skill Name: unifi Version: 1.0.1 The skill is designed to query and monitor UniFi network devices via the local gateway API. All API calls are read-only GET requests to the specified UniFi controller URL, using credentials stored in `~/.clawdbot/credentials/unifi/config.json`. The `SKILL.md` and `README.md` clearly state the purpose and do not contain any prompt injection attempts. The use of `curl -k` (disabling SSL verification) is noted as a common necessity for UniFi's self-signed certificates and is not indicative of malicious intent in this context. A debug file `dashboard_debug_dump.json` is created locally by `scripts/dashboard.sh`, which is a minor concern but not malicious. The skill's behavior is aligned with its stated purpose and lacks clear evidence of intentional harmful actions.
能力评估
Purpose & Capability
The scripts and documentation align with the stated purpose: they use the UniFi OS local gateway API to GET monitoring endpoints (devices, clients, health, DPI, alerts). Required binaries (curl, jq) are appropriate. However, the skill expects a credentials file at ~/.clawdbot/credentials/unifi/config.json (or environment variables) even though the registry metadata declared no required config paths or env — that metadata omission is an incoherence.
Instruction Scope
SKILL.md and the scripts instruct the agent to read a local credentials file (containing username/password) and to perform login (POST /api/auth/login) then multiple GETs. The scripts also write data to disk (dashboard_debug_dump.json and $HOME/clawd/memory/bank/unifi-inventory.md). The README and scripts intentionally skip SSL verification (curl -k). While the operations are limited to the local UniFi gateway and are GET-only for configuration endpoints, the skill stores and reads plaintext credentials and persists potentially sensitive network data to files — these behaviors extend beyond simple transient monitoring and increase risk if not managed.
Install Mechanism
Instruction-only skill with bundled shell scripts (no external downloads or package installs). No install spec means nothing arbitrary is fetched during install — low install risk. The included scripts will be executed at runtime, so their contents matter (and were reviewed).
Credentials
Requesting UniFi local admin credentials is expected for the stated purpose, but the skill did not declare the required config path or environment variables in the registry metadata. Storing a local admin password in plaintext at ~/.clawdbot/credentials/unifi/config.json (or via env vars) is necessary for this implementation but is sensitive — the skill doesn't provide guidance on secure file permissions beyond the README. Using UNIFI_CONFIG_FILE override is supported but again not declared in metadata.
Persistence & Privilege
always:false and autonomous invocation not disabled (normal). The scripts create and write files under the user's home (OUTPUT_FILE=$HOME/clawd/memory/bank/unifi-inventory.md and dashboard_debug_dump.json). They also create temporary cookie files for sessions (deleted in most flows). Writing persistent dumps of network inventory/clients to disk is legitimate for some workflows but is a persistence/privacy concern that the user should explicitly accept.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install unifi
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /unifi 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
- Added a new README.md file with documentation. - Updated SKILL.md to increment version to 1.0.1. - No functional changes to code or features.
v1.0.0
Initial release
元数据
Slug unifi
版本 1.0.1
许可证
累计安装 13
当前安装数 13
历史版本数 2
常见问题

Unifi 是什么?

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

如何安装 Unifi?

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

Unifi 是免费的吗?

是的,Unifi 完全免费(开源免费),可自由下载、安装和使用。

Unifi 支持哪些平台?

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

谁开发了 Unifi?

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

💬 留言讨论