← 返回 Skills 市场
Port Manager
作者
damienCronw
· GitHub ↗
· v1.0.0
· MIT-0
290
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install port-manager
功能描述
Port Manager - Track and manage system port usage. Use when: (1) Port conflict when installing software, (2) Check port usage, (3) Release occupied ports, (4...
安全使用建议
What to check before installing: (1) Review the script contents yourself — it runs lsof/ps/jq and can call kill to terminate processes. (2) Ensure lsof and jq are present and trusted; the metadata should declare those dependencies but does not. (3) Note the inconsistent documented file location vs the script's actual path — verify where ports.json will be written and back it up if needed. (4) Prefer running the script manually first to confirm behavior and prompts; do not allow unattended/autonomous execution until you're comfortable it won't kill important services. (5) If you need stronger guarantees, request the package author to fix the metadata (declare binaries, correct file paths) and to add safer checks (e.g., extra confirmation, limited PID filtering) before trusting autonomous invocation.
功能分析
Type: OpenClaw Skill
Name: port-manager
Version: 1.0.0
The 'port-manager' skill is a utility designed to track and manage system port usage, allowing users to record service ports, query occupancy, and free ports by terminating associated processes. The implementation in 'port.sh' uses standard system tools like lsof, ps, kill, and jq, and includes user confirmation prompts before killing processes. No evidence of data exfiltration, obfuscation, or malicious intent was found; the code's behavior is strictly aligned with its stated purpose.
能力评估
Purpose & Capability
The skill's functionality (checking/listing/freeing ports) matches the script implementation, but the package metadata declares no required binaries while the script depends on system tools (lsof, jq, ps, kill). The SKILL.md and the script disagree about the ports.json location (SKILL.md: ~/.openclaw/workspace/.port-manager/ports.json vs script: ~/.openclaw/workspace/skills/port-manager/.data/ports.json). These mismatches are unexpected and should be corrected.
Instruction Scope
Instructions and script operate on system state: they run lsof/ps to enumerate processes, read/write a JSON file under your home workspace, and can terminate processes with kill. Terminating arbitrary processes is a high-impact action; although the script prompts for confirmation, an automated agent or a misused invocation could still terminate services. The SKILL.md also mentions netstat but the script uses lsof; minor mismatch but worth noting.
Install Mechanism
There is no external install/download step or remote code retrieval — the package is instruction+script only and writes files locally. No network fetches or archive extraction were found in the manifest.
Credentials
The skill requests no credentials, but it accesses the user's HOME to read/write ~/.openclaw workspace and queries system process/state (lsof/ps). It also requires jq and lsof which are not listed in metadata. The ability to inspect and terminate local processes is powerful and not represented in any declared permissions.
Persistence & Privilege
The skill persists its own data under ~/.openclaw/workspace/skills/port-manager/.data/ports.json (and includes sample .data files). It does not request always:true and does not modify other skills. However, because it can kill processes, consider the risk if the agent invokes this autonomously.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install port-manager - 安装完成后,直接呼叫该 Skill 的名称或使用
/port-manager触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release of Port Manager skill.
- Track, record, and manage system port usage to avoid conflicts.
- Record, query, and list service-port assignments.
- Check for port conflicts and prompt to release ports.
- Auto-allocate available ports if a requested port is occupied.
- Free (terminate) processes occupying specified ports.
- Stores port records in `~/.openclaw/workspace/.port-manager/ports.json`.
元数据
常见问题
Port Manager 是什么?
Port Manager - Track and manage system port usage. Use when: (1) Port conflict when installing software, (2) Check port usage, (3) Release occupied ports, (4... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 290 次。
如何安装 Port Manager?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install port-manager」即可一键安装,无需额外配置。
Port Manager 是免费的吗?
是的,Port Manager 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Port Manager 支持哪些平台?
Port Manager 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Port Manager?
由 damienCronw(@damiencronw)开发并维护,当前版本 v1.0.0。
推荐 Skills