← Back to Skills Marketplace
doooxu

network-device-scanner

by Li Xudong · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ⚠ suspicious
437
Downloads
0
Stars
2
Active Installs
2
Versions
Install in OpenClaw
/install network-device-scanner
Description
扫描局域网内活跃设备及其开放端口,返回格式化Markdown表格。触发场景:(1) 用户说"查一下周边设备有哪些"、"扫描周边设备"、"看看网络有哪些设备"、"局域网有哪些设备" (2) 用户提到IP地址、MAC地址、端口扫描相关的查询
Usage Guidance
Before installing or running this skill: (1) review the scripts yourself — they will actively probe IPs and ports on your local network (ARP, ping, TCP connect). Running them on networks you don't own or without permission can be illegal or disruptive. (2) Note the scripts are hard-coded to 172.16.10.0/24 and add 172.16.10.234 — edit the NETWORK/addresses or set SCAN_EXTRA_IPS if you need a different subnet. (3) SKILL.md mentions a Windows PowerShell script (scripts/scan.ps1) that is not included; Windows instructions as written will fail. (4) The tool does not exfiltrate results to external endpoints, but prints scan output locally — still treat scan output as sensitive. (5) Prefer running in a controlled environment or test VLAN first; if you proceed, run the Python/Node files with a non-privileged account and monitor network/security policies. If you need higher assurance, ask the publisher for a missing PowerShell script and for the ability to configure target subnet via parameters rather than hard-coded values.
Capability Analysis
Type: OpenClaw Skill Name: network-device-scanner Version: 1.0.1 The skill implements a network and port scanner targeting a specific hardcoded subnet (172.16.10.0/24) using Python (scripts/scan.py) and Node.js (scripts/scan.cjs). It employs high-risk capabilities including multi-threaded TCP port scanning and the execution of system commands such as 'arp', 'nmap', and 'fping' to discover local devices. While these actions are consistent with the stated purpose of network management, the use of reconnaissance techniques and shell execution qualifies as suspicious behavior under the security review criteria, despite the lack of evidence for data exfiltration or malicious intent.
Capability Assessment
Purpose & Capability
The name/description (LAN device + port scanning) aligns with the provided Python and Node scripts which perform ARP/ping discovery and TCP port scans. However both scripts are hard-coded to the 172.16.10.0/24 subnet and include a hard-coded additional IP (172.16.10.234). That restriction is surprising/unhelpful for general use and may not match a user's actual LAN. The SKILL.md also references a PowerShell script (scripts/scan.ps1) for Windows but that file is not present in the bundle (incoherence).
Instruction Scope
SKILL.md instructs running local scripts that will actively probe devices via ARP, ping, and TCP connects to multiple ports — this is within the stated scope. Note: the skill performs active network scans which can be noisy and, when run against networks you don't own/authorize, may be legally or operationally problematic. The SKILL.md warns 'only for user-owned networks' but does not (and cannot) enforce that.
Install Mechanism
No install spec; this is instruction-plus-scripts only. No external downloads or package installs are declared. The code relies on locally available tools (arp, fping, nmap, ping) if present, which is reasonable and low-risk from an install perspective.
Credentials
The registry metadata declares no required environment variables or credentials. The Python script, however, reads SCAN_EXTRA_IPS from the environment to add extra targets (defaulting to 172.16.10.234 if unset). That env-var use is minor but undocumented in SKILL.md metadata. No sensitive credentials are requested or used.
Persistence & Privilege
The skill does not request persistent inclusion (always:false) and does not modify system or other skills' configs. It simply runs local scripts when invoked.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install network-device-scanner
  3. After installation, invoke the skill by name or use /network-device-scanner
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- 跨平台支持:新增对 Linux 和 macOS 的扫描方法及命令说明,补充了 Python 脚本执行示例。 - 明确用途声明:强调本功能仅限管理用户自有网络。 - 补充环境要求:罗列对 Python 3.7+ 及网络扫描工具的需求。 - 设备发现细化:详细说明设备发现的多种优先级策略(/proc/net/arp、arp、fping、nmap等)。 - 常用端口扩展:扫描端口列表增加 53, 554, 8000, 37777 等。
v1.0.0
Initial release with js-based LAN scanning and targeted output: - Switched scanning implementation to js script (`scan.cjs`) focused on ARP and TCP port checks for common ports. - Removed Python scanning script (`scan.py`). - Now auto-identifies device type based on MAC prefix and open ports. - Output is a strict Markdown table with local device IP, MAC, open ports, and identified device type. - Documentation and usage instructions updated accordingly.
Metadata
Slug network-device-scanner
Version 1.0.1
License MIT-0
All-time Installs 2
Active Installs 2
Total Versions 2
Frequently Asked Questions

What is network-device-scanner?

扫描局域网内活跃设备及其开放端口,返回格式化Markdown表格。触发场景:(1) 用户说"查一下周边设备有哪些"、"扫描周边设备"、"看看网络有哪些设备"、"局域网有哪些设备" (2) 用户提到IP地址、MAC地址、端口扫描相关的查询. It is an AI Agent Skill for Claude Code / OpenClaw, with 437 downloads so far.

How do I install network-device-scanner?

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

Is network-device-scanner free?

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

Which platforms does network-device-scanner support?

network-device-scanner is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created network-device-scanner?

It is built and maintained by Li Xudong (@doooxu); the current version is v1.0.1.

💬 Comments