Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
Added homepage metadata, improved safety documentation, enhanced blocklist config format
What This Skill Does
Scans local networks using nmap to discover connected devices and collect their IP addresses, MAC addresses, vendor names, and hostnames via reverse DNS. Blocks scanning of public IP ranges and blocklisted networks to prevent accidental abuse.
Built-in public IP and blocklist checks prevent the accidental scans of non-private ranges that a raw nmap command would allow.
When to use it
- Check what devices are connected to your home network
- Identify an unknown device by its MAC address and vendor
- Generate a device inventory table for network documentation
- Detect new devices joining an office network
- Run automated presence detection for home automation
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: scan my home network and show me all devices
- 1Run python3 scripts/scan.py home to target the configured home network CIDR
- 2nmap scans 192.168.1.0/24 with sudo for ARP-based MAC discovery
- 3dig performs reverse DNS lookups on each responding IP
- 4Script maps MAC prefixes to vendor names
- 5Format results as a markdown table with IP, hostname, MAC, and vendor columns
Markdown table listing each device with its IP, hostname (e.g. router.local), MAC address, and vendor (e.g. Ubiquiti, Synology), plus a device count summary
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.