← 返回 Skills 市场
Unifi
作者
Oliver Drobnik
· GitHub ↗
· v3.2.1
1210
总下载
0
收藏
0
当前安装
12
版本数
在 OpenClaw 中安装
/install unifi-site-manager
功能描述
Monitor and configure UniFi network infrastructure. Auto-routes between local gateway and cloud connector. Manage hosts, sites, devices, clients, WLANs, radi...
安全使用建议
This skill appears to be what it claims: a UniFi Site Manager CLI that needs your UniFi API key and optionally a local gateway key/IP. Before installing: 1) Verify the source code (the GitHub homepage is listed) so you trust the script; 2) Store your API key securely — config.json is local but still sensitive; prefer using environment variables if your agent environment is isolated; 3) Note the doc/code mismatch about certificate pinning: the README suggests local access may work without a fingerprint, but the included script will exit unless a gateway_fingerprint is configured — expect to supply a pinned fingerprint for secure local access; 4) Limit the API key's scope on the UniFi portal if possible and rotate it if you suspect compromise; 5) Run the script in a trusted environment only (it performs network calls to api.ui.com and to any gateway IP you configure). If you want extra assurance, review the full scripts/unifi.py file (the code is included) before enabling the skill.
功能分析
Type: OpenClaw Skill
Name: unifi-site-manager
Version: 3.2.1
The OpenClaw skill bundle is classified as benign. The `scripts/unifi.py` code interacts with legitimate UniFi cloud and local APIs, handling API keys and sensitive configuration (like `gateway_fingerprint` for TLS pinning) securely. It includes input sanitization (`_sanitize_path_param`) to prevent injection vulnerabilities in API paths. There is no evidence of data exfiltration to unauthorized endpoints, backdoor installation, or arbitrary command execution. The `SKILL.md` and `SETUP.md` files provide clear, non-malicious instructions for the AI agent and user, with the `openssl` command in `SETUP.md` being a safe, user-executed setup step for certificate pinning.
能力评估
Purpose & Capability
Name/description match the requested environment variables and code: the skill uses a UniFi cloud API key (UNIFI_API_KEY) and optionally a local gateway IP and local API key to manage sites, devices, clients, WLANs, and events via api.ui.com and a local gateway. Required env vars and files (config.json) are appropriate for the stated purpose.
Instruction Scope
SKILL.md directs the agent to run the included Python CLI (scripts/unifi.py) and to store credentials in config.json or environment variables. The instructions and code limit actions to cloud API calls and local gateway calls. However there are small inconsistencies between docs and implementation: SETUP.md implies local access may work without a pinned fingerprint, while the included code refuses to proceed for local connections unless a gateway_fingerprint is configured (exits with an error). Also SKILL.md lists an optional UNIFI_BASE_URL env var, but the visible code sets BASE_URL to https://api.ui.com (no override shown in the truncated file). These are functional/documentation mismatches, not evidence of malicious behavior.
Install Mechanism
No install spec is present; the skill is delivered as a Python script and docs. This is low-risk: nothing is downloaded or installed automatically. The script requires the requests library (documented in SETUP.md).
Credentials
Only UNIFI_API_KEY is required (with UNIFI_GATEWAY_IP and UNIFI_LOCAL_API_KEY optional for local access). These credentials are exactly what a UniFi site manager would need. The script reads config.json from the skill directory or environment variables; there are no other unexplained secret/env requirements.
Persistence & Privilege
The skill does not request always: true and does not attempt to modify other skills or system-wide agent settings. It runs as an on-demand CLI entry point and uses network requests to UniFi endpoints or a local gateway only.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install unifi-site-manager - 安装完成后,直接呼叫该 Skill 的名称或使用
/unifi-site-manager触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v3.2.1
Security: require certificate fingerprint for local HTTPS — no more verify=False fallback
v3.2.0
Add get-network-dns and set-network-dns commands
v3.1.0
set-client command, HTTPS certificate fingerprint pinning, local transport fix
v3.0.4
Remove configurable base_url; hardcode cloud API endpoint
v3.0.3
Remove warning suppression; auto-detect HTTPS via gateway cert
v3.0.2
Security: local requests use HTTP instead of HTTPS with verify=False, path parameter sanitization
v3.0.1
Updated SETUP.md: document both API keys, auto-routing, drop obsolete base_url/ap_locations
v3.0.0
v3: Auto-routing (local/cloud), classic API support, 7 new commands (WLAN config, radio config, label-client, AP clients, events, known clients, firmware status). 18 commands total.
v1.1.2
Remove debug test script (unifi_api.py)
v1.1.1
Rename .clawdhubignore to .clawhubignore
v1.1.0
Refactor: move setup to SETUP.md, keep SKILL.md lean
v1.0.3
Publish under non -skill slug (policy); README points to new slug.
元数据
常见问题
Unifi 是什么?
Monitor and configure UniFi network infrastructure. Auto-routes between local gateway and cloud connector. Manage hosts, sites, devices, clients, WLANs, radi... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 1210 次。
如何安装 Unifi?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install unifi-site-manager」即可一键安装,无需额外配置。
Unifi 是免费的吗?
是的,Unifi 完全免费(开源免费),可自由下载、安装和使用。
Unifi 支持哪些平台?
Unifi 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Unifi?
由 Oliver Drobnik(@odrobnik)开发并维护,当前版本 v3.2.1。
推荐 Skills