UniFi网络监控

技能简介

通过本地UniFi OS网关API（Cloud Gateway Max）对UniFi网络进行只读监控，获取设备状态、在线客户端、网络健康度、流量应用排行及告警信息。

能做什么

• 查看所有UniFi设备（AP、交换机、网关）的运行状态
• 列出当前连接的客户端及其信号强度
• 获取站点整体健康度摘要
• 分析DPI数据，查看带宽占用最高的应用
• 检索近期网络告警与事件

使用说明

安装前提：系统需已安装 curl 和 jq。

配置步骤：

1. 创建凭证文件：~/.clawdbot/credentials/unifi/config.json
2. 填入以下内容：

   {"url":"https://10.1.0.1","username":"api","password":"YOUR_PASSWORD","site":"default"}

3. 确认网关IP、管理员账号密码及站点名称正确

常用命令：

• 综合仪表盘：bash scripts/dashboard.sh
• 设备列表：bash scripts/devices.sh
• 在线客户端：bash scripts/clients.sh
• 健康检查：bash scripts/health.sh
• 应用流量排行：bash scripts/top-apps.sh [数量]
• 近期告警：bash scripts/alerts.sh [数量]

所有命令支持追加 json 参数输出原始JSON格式。

输入与输出

见下方输入与输出表格。

风险提示

• 需要网络可达UniFi网关的443端口
• 凭证文件需妥善保管，避免泄露管理员密码
• 仅支持只读操作，无法修改网络配置
• 若认证失败或返回空数据，需检查凭证与网络连通性

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/jmagar/unifi/SKILL.md
来源类型：GitHub仓库