ez-unifiUse when asked to manage UniFi network - list/restart/upgrade devices, block/unblock clients, manage WiFi networks, control PoE ports, manage traffic rules, create guest vouchers, or any UniFi controller task. Works with UDM Pro/SE, Dream Machine, Cloud Key Gen2+, or self-hosted controllers.
Install via ClawdBot CLI:
clawdbot install araa47/ez-unifiAgent-friendly UniFi Network tools powered by the aiounifi library. Supports UDM Pro/SE, Dream Machine, Cloud Key Gen2+, and self-hosted controllers.
Run all commands with: uv run scripts/unifi.py
Step 1: Ask user to create a dedicated local admin account
To manage your UniFi network, I need API access. Please create a dedicated local admin account:
>
1. Open your UniFi controller (e.g., https://192.168.1.1)
2. Go to Settings → System → Admins & Users
3. Click Add Admin
4. Enter a username (e.g., agent-api)
5. Enter an email and password
6. Important: Disable "Remote Access" - local-only avoids MFA issues
7. Set Role to Super Admin or Site Admin
8. Click Add
>
Then provide:
- Controller IP (e.g., 192.168.1.1)
- Username
- Password
- Is it a UDM Pro/SE/Dream Machine? (yes/no)
Step 2: Save credentials to .env
UNIFI_HOST=https://192.168.1.1
UNIFI_USERNAME=agent-api
UNIFI_PASSWORD=the_password
UNIFI_SITE=default
UNIFI_IS_UDM=trueSet UNIFI_IS_UDM=false for Cloud Key Gen1 or self-hosted controllers.
unifi.py sites # List all sites
unifi.py sysinfo # System information
unifi.py health # Site health status (WAN, WLAN, LAN)unifi.py devices # List all devices
unifi.py device MAC # Device details
unifi.py restart MAC # Restart device
unifi.py restart MAC --hard # Hard restart (cycles PoE on switches)
unifi.py upgrade MAC # Upgrade device firmware
unifi.py locate MAC # Blink LED to locate
unifi.py unlocate MAC # Stop LED blinking
unifi.py led MAC on|off|default # Set LED status
unifi.py led MAC on --color=#FF0000 --brightness=50 # With color/brightnessunifi.py ports # List all switch ports
unifi.py port MAC PORT_IDX # Port details
unifi.py port-enable MAC PORT_IDX # Enable switch port
unifi.py port-disable MAC PORT_IDX # Disable switch port
unifi.py poe MAC PORT_IDX MODE # Set PoE mode (auto|off|passthrough|24v)
unifi.py power-cycle MAC PORT_IDX # Power cycle a PoE portunifi.py outlets # List all outlets
unifi.py outlet MAC IDX on|off # Control outlet relay
unifi.py outlet-cycle MAC IDX on|off # Enable/disable auto-cycle on internet downunifi.py clients # List active clients
unifi.py clients-all # List all clients (including offline/known)
unifi.py client MAC # Client details
unifi.py block MAC # Block client from network
unifi.py unblock MAC # Unblock client
unifi.py reconnect MAC # Kick/reconnect client
unifi.py forget MAC [MAC2...] # Forget client(s) permanentlyunifi.py wlans # List wireless networks
unifi.py wlan ID # WLAN details
unifi.py wlan-enable ID # Enable WLAN
unifi.py wlan-disable ID # Disable WLAN
unifi.py wlan-password ID NEWPASS # Change WLAN password
unifi.py wlan-qr ID # Generate WiFi QR code (PNG file)
unifi.py wlan-qr ID -o myqr.png # Custom output filenameunifi.py port-forwards # List port forwarding rules
unifi.py port-forward ID # Port forward detailsunifi.py traffic-rules # List traffic rules
unifi.py traffic-rule ID # Traffic rule details
unifi.py traffic-rule-enable ID # Enable traffic rule
unifi.py traffic-rule-disable ID # Disable traffic rule
unifi.py traffic-rule-toggle ID on|off # Toggle traffic rule stateunifi.py traffic-routes # List traffic routes
unifi.py traffic-route ID # Traffic route details
unifi.py traffic-route-enable ID # Enable traffic route
unifi.py traffic-route-disable ID # Disable traffic routeunifi.py firewall-policies # List firewall policies
unifi.py firewall-policy ID # Firewall policy details
unifi.py firewall-zones # List firewall zones
unifi.py firewall-zone ID # Firewall zone detailsunifi.py dpi-apps # List DPI restriction apps
unifi.py dpi-app ID # DPI app details
unifi.py dpi-app-enable ID # Enable DPI app restriction
unifi.py dpi-app-disable ID # Disable DPI app restriction
unifi.py dpi-groups # List DPI restriction groups
unifi.py dpi-group ID # DPI group detailsunifi.py vouchers # List vouchers
unifi.py voucher-create --duration=60 --quota=1 --note="Guest"
unifi.py voucher-create --duration=1440 --quota=5 --rate-up=5000 --rate-down=10000
unifi.py voucher-delete ID # Delete voucherVoucher options:
--duration - Duration in minutes (default: 60)--quota - Number of uses (default: 1)--usage-quota - Usage quota in MB--rate-up - Upload rate limit in Kbps--rate-down - Download rate limit in Kbps--note - Note/descriptionunifi.py events # Stream events in real-time (Ctrl+C to stop)unifi.py raw GET /stat/health # Raw GET request
unifi.py raw POST /cmd/devmgr '{"cmd":"restart","mac":"aa:bb:cc:dd:ee:ff"}'
unifi.py raw PUT /rest/wlanconf/ID '{"enabled":false}'Add --json flag to any list command for JSON output:
unifi.py devices --json # JSON output
unifi.py clients --json# Check network health
uv run scripts/unifi.py health
# List all connected clients
uv run scripts/unifi.py clients
# Block a device
uv run scripts/unifi.py block "aa:bb:cc:dd:ee:ff"
# Restart an access point
uv run scripts/unifi.py restart "11:22:33:44:55:66"
# Disable guest WiFi
uv run scripts/unifi.py wlan-disable "5f8b3d2e1a4c7b9e0d6f8a2c"
# Upgrade device firmware
uv run scripts/unifi.py upgrade "11:22:33:44:55:66"
# Power cycle a PoE port (useful for rebooting PoE devices)
uv run scripts/unifi.py power-cycle "switch_mac" 5
# Create a guest voucher (24 hours, single use)
uv run scripts/unifi.py voucher-create --duration=1440 --quota=1 --note="Guest access"
# Generate WiFi QR code for easy connection
uv run scripts/unifi.py wlan-qr "wlan_id" -o guest_wifi.png
# Control traffic rule
uv run scripts/unifi.py traffic-rule-disable "rule_id"wlans and look for the ID columndevices and look for the MAC columnclients or clients-all and look for the MAC columntraffic-rules and look for the ID columnvouchers and look for the ID columnGenerated Mar 1, 2026
A small business uses UniFi devices for their office network. The IT manager can use this skill to monitor device health, restart malfunctioning access points, and block unauthorized clients without logging into the controller UI. It simplifies routine maintenance tasks like upgrading firmware across multiple devices.
A hotel or cafe deploys UniFi for guest WiFi. Staff can create timed vouchers with usage limits for guests, disable WiFi networks during off-hours, and monitor client activity to ensure bandwidth fairness. This automates guest access while maintaining security and control over the network.
A school or university with UniFi infrastructure uses this skill to manage network policies. Administrators can enable/disable traffic rules for specific applications, control PoE ports to power devices in classrooms, and generate QR codes for easy WiFi access during events, reducing IT support tickets.
A tech-savvy homeowner with UniFi gear integrates this skill into a smart home setup. They can automate tasks like turning off LED lights on devices at night, power-cycling PoE cameras remotely, and blocking unknown clients detected on the network, enhancing convenience and security.
An MSP managing multiple client networks with UniFi controllers uses this skill to streamline remote support. Technicians can quickly restart devices, check system health, and adjust firewall policies across different sites via scripts, improving response times and reducing manual intervention.
Offer a monthly subscription where businesses pay for automated network monitoring and management using this skill. Include features like health checks, client blocking alerts, and voucher generation, with tiered pricing based on the number of devices or sites managed.
Sell a one-time package to set up and integrate this skill for clients, including credential configuration, custom script development, and training. Target small businesses or individuals who lack in-house IT expertise but want automated UniFi management.
Provide the core skill for free to attract users, then charge for advanced features like bulk operations, detailed analytics, or integration with other systems (e.g., Slack, Home Assistant). Monetize through in-app purchases or enterprise licenses.
💬 Integration Tip
Ensure the .env file with UniFi credentials is securely stored and not shared; consider using environment variables in production to avoid hardcoding sensitive data in scripts.
Automatically update Clawdbot and all installed skills once daily. Runs via cron, checks for updates, applies them, and messages the user with a summary of what changed.
Full desktop computer use for headless Linux servers. Xvfb + XFCE virtual desktop with xdotool automation. 17 actions (click, type, scroll, screenshot, drag,...
Essential Docker commands and workflows for container management, image operations, and debugging.
Tool discovery and shell one-liner reference for sysadmin, DevOps, and security tasks. AUTO-CONSULT this skill when the user is: troubleshooting network issues, debugging processes, analyzing logs, working with SSL/TLS, managing DNS, testing HTTP endpoints, auditing security, working with containers, writing shell scripts, or asks 'what tool should I use for X'. Source: github.com/trimstray/the-book-of-secret-knowledge
Deploy applications and manage projects with complete CLI reference. Commands for deployments, projects, domains, environment variables, and live documentation access.
Monitor topics of interest and proactively alert when important developments occur. Use when user wants automated monitoring of specific subjects (e.g., product releases, price changes, news topics, technology updates). Supports scheduled web searches, AI-powered importance scoring, smart alerts vs weekly digests, and memory-aware contextual summaries.