← Back to Skills Marketplace
wrentheai

Netmap

by wrentheai · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ✓ Security Clean
217
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install netmap
Description
Scan and map all devices on the local network. Discovers IPs, hostnames, vendors, and device types. Tracks when devices first appeared and were last seen. Su...
Usage Guidance
This skill appears to do what it claims: local network discovery using nmap and a local device DB. Before installing, ensure you: (1) have (or are willing to install) nmap; (2) are comfortable running network scans and occasional port fingerprinting (may be disallowed on some networks); (3) understand that MAC addresses are sent to api.macvendors.com for vendor lookup (privacy/third-party disclosure); (4) may need to run with sudo to see full MAC/vendor info; and (5) that the tool stores history in ~/.config/netmap/devices.json — delete that file if you want to remove stored data. If you need to avoid external calls, consider modifying the script to skip lookup_vendor or use a local OUI database instead.
Capability Analysis
Type: OpenClaw Skill Name: netmap Version: 1.0.2 The netmap skill is a legitimate network discovery utility that uses nmap and the system's ARP table to identify devices on a local subnet. It maintains a local device database in ~/.config/netmap/ and performs MAC vendor lookups using the public api.macvendors.com service. The code in scripts/netmap.py is well-structured, uses safe subprocess calls, and contains no evidence of malicious intent, data exfiltration, or unauthorized persistence.
Capability Assessment
Purpose & Capability
Name/description match behavior: script runs nmap, parses results, enriches with ARP and vendor lookups, persists a device DB at ~/.config/netmap/devices.json. No unrelated credentials, binaries, or config paths are requested.
Instruction Scope
SKILL.md and the script align: they instruct running nmap scans, listing, labeling, exporting, and a watch mode. The code performs reverse DNS and an external HTTP call to api.macvendors.com for vendor lookups — this external call is outside the LAN but is reasonably related to the stated purpose (vendor resolution). The instructions explicitly note sudo may be needed for full MAC/ARP info. There is no instruction to read unrelated local files or environment variables.
Install Mechanism
No install spec — instruction-only with an included Python script. The script expects nmap to be installed by the user (brew or package manager). Nothing is downloaded or installed automatically by the skill.
Credentials
The skill requires no credentials or env vars. However, it makes outbound HTTP requests to api.macvendors.com (sends MAC addresses) and writes persistent files under ~/.config/netmap (devices.json and vendor_cache.json). Consider privacy implications of vendor lookups and stored device history.
Persistence & Privilege
The skill persists only its own database and cache in the user's home config directory. It does not request always:true and does not modify other skills or system-wide agent settings. Watch mode performs periodic scans (default every 2 minutes) which is expected for the feature but may be noisy.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install netmap
  3. After installation, invoke the skill by name or use /netmap
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Maintenance release with no user-facing changes. - No updates to documentation or feature set.
v1.0.1
- Maintenance release; no user-facing changes. - Only internal code in scripts/netmap.py was modified. - No updates to features, commands, or documentation.
v1.0.0
netmap 1.0.0 - Initial release. - Scans the local network to discover devices, including their IPs, hostnames, MAC addresses, vendors, and device types. - Maintains a persistent device database with first-seen and last-seen timestamps. - Supports labeling devices with friendly names for easier identification. - Provides commands for scanning, deep scanning (with port fingerprinting), searching, labeling, and exporting device information. - Enables filtering new devices and running in continuous watch mode. - Requires nmap to be installed and uses a Python script for all operations.
Metadata
Slug netmap
Version 1.0.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is Netmap?

Scan and map all devices on the local network. Discovers IPs, hostnames, vendors, and device types. Tracks when devices first appeared and were last seen. Su... It is an AI Agent Skill for Claude Code / OpenClaw, with 217 downloads so far.

How do I install Netmap?

Run "/install netmap" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Netmap free?

Yes, Netmap is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Netmap support?

Netmap is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Netmap?

It is built and maintained by wrentheai (@wrentheai); the current version is v1.0.2.

💬 Comments