- name
- asus-router
- description
- Monitor and manage Asus routers running AsusWRT firmware. Supports status checks, device listing, presence detection, AiMesh mesh topology, WAN diagnostics, and reboots. Works with ZenWiFi, RT-AX, GT-AX, and other AsusWRT-based routers.
- metadata
- {"clawdbot":{"emoji":"📡","requires":{"bins":["ping"],"pip":["asusrouter","aiohttp"]}}}
Asus Router Management
Manage Asus routers via the asusrouter Python library. Works with any Asus router running stock AsusWRT or Merlin firmware.
Setup
1. Install dependencies
pip install asusrouter aiohttp2. Create config file
Copy config.example.yaml to config.yaml and fill in your router details:
cp skills/asus-router/config.example.yaml skills/asus-router/config.yamlEdit config.yaml with your router's IP, username, and password.
3. Verify connection
python3 skills/asus-router/router.py statusSupported Routers
Any Asus router with the AsusWRT web interface:
- ZenWiFi (XT8, XT12, XD6, etc.) — full AiMesh support
- RT-AX series (RT-AX86U, RT-AX88U, etc.)
- GT-AX gaming series
- Merlin firmware variants
- AiMesh nodes (RP-AX56, RP-AX58, etc.)
Commands
All commands use router.py. Activate your venv first if using one.
Quick Status
python3 router.py status # WAN, CPU, RAM, mesh nodes, client count
python3 router.py status --json # Machine-readable outputList Connected Devices
python3 router.py clients # All devices
python3 router.py clients --online # Online only
python3 router.py clients --filter "iphone" # Search by name/IP/MAC
python3 router.py clients --json # JSON outputWho's Home (Presence Detection)
python3 router.py whoChecks for known devices defined in config.yaml to determine who's home.
WAN Details
python3 router.py wan # IP, gateway, DNS, lease, dual-WAN
python3 router.py wan --jsonAiMesh Topology
python3 router.py mesh # Which clients connect to which node
python3 router.py mesh --jsonFind a Device
python3 router.py find "samsung"
python3 router.py find "192.168.1.100"
python3 router.py find "AA:BB:CC:DD:EE:FF"Network Latency Check
python3 router.py pingPings targets defined in config.yaml (default: gateway + Cloudflare + Google).
Reboot Router
python3 router.py reboot --confirm⚠️ Requires --confirm flag. Causes 2-3 min downtime.
Common Tasks
"Is the internet down?"
status— check WAN link stateping— check latency to external IPswan— check DHCP lease and DNS
"What's using bandwidth?"
clients --online --json — check rx_speed/tx_speed fields
"Who's home?"
who — checks for devices listed in config.yaml under known_devices
"Why is WiFi slow?"
mesh— check client distribution across nodesstatus— check CPU/RAM (high CPU = overloaded)find <device>— check signal strength (rssi)
Configuration
All settings live in config.yaml. See config.example.yaml for the full template.
Key settings:
router.host— Router IP addressrouter.username— Admin usernamerouter.password— Admin passwordrouter.ssl— Use HTTPS (default: false)known_devices— Devices for presence detectionping_targets— Custom ping targets for latency checks
JSON Output
Add --json to any command for machine-readable output. Useful for cron jobs, heartbeat checks, and alerting.
Integration with Home Assistant
For persistent monitoring, also install ha-asusrouter via HACS: https://github.com/Vaskivskyi/ha-asusrouter