← 返回 Skills 市场
skill_install
作者
otho2966-ai
· GitHub ↗
· v1.0.0
448
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install skillinstall
功能描述
Install OpenClaw skills from clawhub.ai ZIP files with automatic detection, validation, and Gateway updates. Supports file search, duplicate checking, and in...
安全使用建议
This package appears to do what it claims, but the installer code has two practical safety issues you should consider before running it on a production machine:
- Zip path traversal (zip-slip): the script calls zipfile.extractall() without sanitizing member paths. A malicious ZIP could include filenames like ../../etc/passwd or absolute paths and cause files to be written outside the intended temp folder. Always inspect ZIP contents before running (e.g., unzip -l my-skill.zip) and verify member paths.
- Predictable temp dir and copy semantics: the script extracts to a fixed /tmp/openclaw_skill_temp and then uses shutil.copytree to overwrite the skills directory. An attacker on the same system could exploit the predictable temp path (symlink/TOCTOU). Also installing untrusted ZIPs as root can overwrite system-wide files.
Recommendations:
- Only install skill ZIPs from trusted sources and inspect their contents first (list files, check for .. or absolute paths, review scripts inside).
- Run the installer as a non-root user and avoid running on production systems; prefer a sandbox or VM for initial testing.
- Consider patching the script to use a secure temporary directory (tempfile.mkdtemp), validate/normalize zip paths before extraction, and refuse entries with absolute paths or '..' components.
- Backup OpenClaw installation or test in a disposable environment before installing.
If you can share the specific ZIP(s) you intend to install or run the script in a controlled environment, confidence in safety could be raised after verifying those archives and/or fixing the extraction logic.
功能分析
Type: OpenClaw Skill
Name: skillinstall
Version: 1.0.0
The skill installer is designed to manage OpenClaw skills, performing file system operations and executing system commands. It is classified as 'suspicious' due to a critical ZIP Slip vulnerability in `scripts/skill_install.py` where `zipfile.ZipFile.extractall()` is used without path sanitization. This flaw could allow a malicious ZIP file to write arbitrary files outside the intended temporary directory, potentially leading to remote code execution or system compromise if the script is run with sufficient privileges. While this is a severe vulnerability, there is no clear evidence of intentional malicious behavior (e.g., data exfiltration, backdoor installation) designed by the skill itself, aligning it with the 'suspicious' rather than 'malicious' classification as per the provided guidelines.
能力评估
Purpose & Capability
Name, description, SKILL.md, README, and scripts/skill_install.py all align: the package is an installer for OpenClaw skills and only requires python3 and write access to the OpenClaw skills directory.
Instruction Scope
The runtime instructions and the script perform local filesystem discovery, unzip provided archives, copy files into the global skills directory, and restart the Gateway — all expected for an installer. However the script uses zipfile.extractall without sanitizing member paths (risk of zip-slip/path traversal) and extracts to a predictable /tmp/openclaw_skill_temp (risk of symlink/TOCTOU attacks). These behaviors expand the attack surface beyond benign install operations.
Install Mechanism
This is instruction + included script (no remote install). There are no remote downloads or network calls in the code. That lowers remote supply-chain risk, but because it runs local extraction and writes into system-level node_modules locations, local file-safety is important.
Credentials
The skill requests only python3 and no environment variables or credentials; this is proportionate to an installer that manipulates local files.
Persistence & Privilege
The skill writes files into the OpenClaw skills directory and restarts the OpenClaw Gateway (openclaw daemon restart) — this is expected for installing new skills. It does not request always:true and does not modify other skills' configs beyond copying the installed skill files.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install skillinstall - 安装完成后,直接呼叫该 Skill 的名称或使用
/skillinstall触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Version 1.0.0 (2025-02-26)
新增功能:
- ✨ 一键安装 OpenClaw skills
- 🔍 智能文件搜索和选择(支持多个文件时让用户选择)
- ✅ 自动检测 OpenClaw 安装位置
- ✅ 重复检查,避免覆盖已安装的 skill
- 🔄 自动重启 Gateway,使新 skill 生效
- 📋 列出所有已安装的 skills
- 📝 详细的进度反馈和状态消息
技术特性:
- 🛠️ 自动验证 skill 结构(SKILL.md, _meta.json)
- 🔧 支持多种 Node.js 安装路径(nvm, npm 全局等)
- 💻 跨平台兼容(Linux, macOS, Windows)
- ⚠️ 详细的错误处理和提示
- 📦 ZIP 文件解压和安装
改进:
- 📖 完整的使用文档和示例
- 🐛 修复了路径解析问题
- 🎯 改进了 ZIP 提取处理
- 🔐 更好的错误恢复机制
已知问题:
- 某些系统可能需要手动重启 Gateway
- 每次运行只能安装一个 skill
元数据
常见问题
skill_install 是什么?
Install OpenClaw skills from clawhub.ai ZIP files with automatic detection, validation, and Gateway updates. Supports file search, duplicate checking, and in... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 448 次。
如何安装 skill_install?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install skillinstall」即可一键安装,无需额外配置。
skill_install 是免费的吗?
是的,skill_install 完全免费(开源免费),可自由下载、安装和使用。
skill_install 支持哪些平台?
skill_install 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 skill_install?
由 otho2966-ai(@otho2966-ai)开发并维护,当前版本 v1.0.0。
推荐 Skills