Agent Skills
返回列表
🔒

UniFi 网络监控

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-unifi。

技能介绍

典型痛点

家里或办公室跑着 UniFi(AP、交换机、网关),控制台在浏览器里,但要回答「现在谁连着哪台 AP」「WAN 是否正常」「哪几个应用在吃带宽」,往往得翻好几个页面。若在对话里做例行巡检或给同事报状态,手工查 API 文档又费时,还容易误触写操作。

技能怎么做

本技能通过本地 UniFi OS 网关上的只读 API(路径含 /proxy/network),用已配置的 url、username、password、site 拉取运维数据,全部为 GET,适合监控与汇报。

核心能力对应常见问法:

  • 网络总览:dashboard.sh 输出 ASCII 仪表盘,汇总健康、设备、客户端、网络与 DPI 等指标
  • 设备清单:列出 AP、交换机、网关的名称、型号、IP、状态、在线时长与下联客户端数
  • 在线客户端:主机名、IP、MAC、所连 AP、信号与收发速率
  • 健康摘要:WAN/LAN/WLAN 子系统状态及 up/adopted/disconnected 计数
  • 流量洞察:DPI 统计带宽占用靠前的应用及 RX/TX/总量
  • 近期告警:时间戳、告警键、消息与受影响设备

多数命令支持可选 json 参数,默认为人读表格;向用户呈现前宜核对鉴权失败或空数据等异常。

边界与注意

须能访问网关 HTTPS 地址,凭证放在 ~/.clawdbot/credentials/unifi/config.json。技能不负责 adopt、下发配置或踢客户端;变更仍走 UniFi 官方界面。公开资料以 Cloud Gateway Max 上验证的只读端点为准,其他型号需自行核对兼容性。

使用场景

  • 值班时要用自然语言快速列出当前在线客户端及所在 AP,而不逐个打开 UniFi 客户端页面
  • 周报前拉取站点健康摘要与近期告警,整理 WAN/LAN/WLAN 与设备上下线情况
  • 排查带宽异常时按 DPI 查看占用靠前的应用及 RX/TX 流量,对照用户投诉时间段
  • 远程协助同事时一次性输出 ASCII 网络仪表盘,覆盖设备、客户端与网络指标

适合人员

  • 管理家庭或小型办公 UniFi 站点、需要经常口头汇报「谁在线、网是否正常」的网络管理员
  • 采用 Cloud Gateway Max 等 UniFi OS 网关、希望用只读 API 做巡检而非改配置的 IT 运维
  • 负责员工上网投诉的一线支持,需快速查客户端关联 AP 信号与近期网关告警
  • 在 homelab 中自建 UniFi 环境、想通过助手执行 GET 查询的设备爱好者