← 返回 Skills 市场
437
总下载
0
收藏
2
当前安装
2
版本数
在 OpenClaw 中安装
/install network-device-scanner
功能描述
扫描局域网内活跃设备及其开放端口,返回格式化Markdown表格。触发场景:(1) 用户说"查一下周边设备有哪些"、"扫描周边设备"、"看看网络有哪些设备"、"局域网有哪些设备" (2) 用户提到IP地址、MAC地址、端口扫描相关的查询
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install network-device-scanner - 安装完成后,直接呼叫该 Skill 的名称或使用
/network-device-scanner触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
常见问题
network-device-scanner 是什么?
扫描局域网内活跃设备及其开放端口,返回格式化Markdown表格。触发场景:(1) 用户说"查一下周边设备有哪些"、"扫描周边设备"、"看看网络有哪些设备"、"局域网有哪些设备" (2) 用户提到IP地址、MAC地址、端口扫描相关的查询. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 437 次。
如何安装 network-device-scanner?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install network-device-scanner」即可一键安装,无需额外配置。
network-device-scanner 是免费的吗?
是的,network-device-scanner 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
network-device-scanner 支持哪些平台?
network-device-scanner 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 network-device-scanner?
由 Li Xudong(@doooxu)开发并维护,当前版本 v1.0.1。
推荐 Skills