# Send Skill Safe Install to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "skill-safe-install", "name": "Skill Safe Install", "source": "tencent", "type": "skill", "category": "安全合规", "sourceUrl": "https://clawhub.ai/CHJ0w0/skill-safe-install", "canonicalUrl": "https://clawhub.ai/CHJ0w0/skill-safe-install", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/skill-safe-install", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=skill-safe-install", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "README.md", "SECURITY_PROCESS.md", "SKILL.md", "_meta.json", "scripts/safe-install.mjs" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "skill-safe-install", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-29T15:31:20.151Z", "expiresAt": "2026-05-06T15:31:20.151Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=skill-safe-install", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=skill-safe-install", "contentDisposition": "attachment; filename=\"skill-safe-install-2.0.1.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "skill-safe-install" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/skill-safe-install" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/skill-safe-install", "downloadUrl": "https://openagent3.xyz/downloads/skill-safe-install", "agentUrl": "https://openagent3.xyz/skills/skill-safe-install/agent", "manifestUrl": "https://openagent3.xyz/skills/skill-safe-install/agent.json", "briefUrl": "https://openagent3.xyz/skills/skill-safe-install/agent.md" } } ``` ## Documentation ### Skills 安全安装工具 在安装任何 Skill 前自动执行三层安全检查，包括 Skill-Vetter 代码审查、ClawHub 评分检查 和 ThreatBook 沙箱扫描。 ### 1. 配置 API Key # 获取微步在线 API Key: https://s.threatbook.com echo 'THREATBOOK_API_KEY=your_api_key_here' >> ~/.openclaw/.env ### 2. 使用安全安装 # 替代 clawhub install，自动执行完整检查 node ~/.openclaw/workspace/skills/skill-safe-install/scripts/safe-install.mjs skill-name # 或添加别名 alias clawhub-safe='node ~/.openclaw/workspace/skills/skill-safe-install/scripts/safe-install.mjs' clawhub-safe skill-name ### 安全检查流程 ┌─────────────────────────────────────────────────────────┐ │ Skills 安全安装流程 │ ├─────────────────────────────────────────────────────────┤ │ │ │ 1️⃣ Skill-Vetter 代码审查 │ │ ├─ 检查红旗（恶意代码模式） │ │ ├─ 评估来源信任层级 │ │ ├─ 发现极端红旗 → ❌ 禁止安装 │ │ └─ 发现高风险 → ❓ 询问任务下达者 │ │ │ │ 2️⃣ ClawHub 评分检查 │ │ ├─ 评分 ≥ 3.5 → ✅ 通过，继续 │ │ └─ 评分 < 3.5 → ❓ 询问任务下达者 │ │ │ │ 3️⃣ ThreatBook 沙箱扫描 │ │ ├─ safe → ✅ 允许安装 │ │ ├─ suspicious → ❓ 询问任务下达者 │ │ ├─ malicious → ❌ 禁止安装 │ │ └─ API 失败 → ❓ 询问任务下达者 │ │ │ │ 4️⃣ 执行安装 │ │ │ └─────────────────────────────────────────────────────────┘ ### 第一层：Skill-Vetter 代码审查 检查内容: 🔴 极端红旗（直接拒绝）: curl|bash, 访问 .ssh/, .aws/, eval(), 危险 rm 命令 🟡 高风险（需要确认）: exec(), 访问内存文件，sudo, 网络请求 🟢 低风险（允许）: 标准文件操作，日志记录 信任层级: 来源审查级别官方 OpenClaw较低审查已知作者中等审查未知来源最高审查 ### 第二层：ClawHub 评分检查 评分判定操作≥ 3.5 分✅ 高评分进入沙箱扫描< 3.5 分⚠️ 低评分❓ 必须询问任务下达者确认 ### 第三层：ThreatBook 沙箱扫描 结果含义操作safe安全✅ 允许安装suspicious可疑❓ 必须询问任务下达者确认malicious恶意❌ 禁止安装API 失败无法访问❓ 必须询问任务下达者是否继续 ### 决策矩阵 Vetter评分沙箱最终决策✅ 通过≥3.5safe✅ 直接安装✅ 通过≥3.5suspicious❓ 询问确认✅ 通过<3.5任意❓ 询问确认⚠️ 高风险任意任意❓ 询问确认🚨 极端风险任意任意❌ 禁止安装任意任意malicious❌ 禁止安装 ### 选项 选项说明--auto, --yes, -y自动模式（需要确认时自动询问任务下达者）--force强制安装（跳过可疑警告）--no-vetter跳过 Vetter 代码审查（不推荐）--no-scan跳过沙箱扫描（不推荐）--dry-run仅检查，不实际安装--timeout=<秒>沙箱扫描超时时间（默认 120 秒）--help显示帮助 ### 退出码 退出码含义0安装成功1检测到恶意代码，禁止安装2文件可疑，等待确认3API 调用失败4评分过低，等待确认5用户取消安装6Vetter 发现极端红旗 ### 环境变量 变量必需说明THREATBOOK_API_KEY✅微步在线沙箱 API KeyCLAWHUB_TOKEN❌ClawHub 认证 Token（如需要） ### 🚨 极端风险（直接拒绝） curl ... | bash - 远程代码执行 wget ... | bash - 远程代码执行 访问 ~/.ssh/ - SSH 密钥窃取 访问 ~/.aws/ - AWS 凭证窃取 rm -rf / - 危险删除命令 读取 /etc/passwd, /etc/shadow - 系统文件 ### 🔴 高风险（需要确认） eval() - 代码注入风险 exec() - 命令执行 访问 MEMORY.md, USER.md, SOUL.md - 记忆文件 sudo - 提权操作 发送数据到外部服务器 ### 🟡 中风险（记录） child_process - 子进程 net.connect - 网络连接 base64 decode - 解码操作 localStorage - 存储访问 ### 🟢 低风险（允许） fs 模块 - 文件操作 fetch HTTP 请求 - 网络请求 mktemp, /tmp/ - 临时文件 ### 成功安装 🛡️ 开始 Skills 安全安装流程 📋 检查 Skill: tavily-search ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 第一步：Skill-Vetter 代码审查 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 👤 作者：openclaw 📅 更新时间：2026-02-20 📦 版本：1.0.0 📊 信任层级评估... ✅ 官方 OpenClaw Skill - 较低审查 📄 发现 2 个脚本文件 ✅ 未发现红旗 风险等级：🟢 LOW ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 第二步：ClawHub 评分检查 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ✅ 评分：4.2/5.0 (高评分，通过) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 第三步：ThreatBook 沙箱扫描 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📤 上传文件到沙箱... ⏳ 等待分析结果... ✅ 分析完成 📊 扫描结果: 判定：SAFE 威胁等级：clean 可信度：98% ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 安全检查通过，开始安装... ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ✅ tavily-search 安装完成！ ### 发现极端红旗 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 第一步：Skill-Vetter 代码审查 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📄 发现 3 个脚本文件 ⚠️ 发现 2 个潜在问题: 🚨 Curl pipe to bash (scripts/install.sh:15) 🚨 Accessing .ssh directory (scripts/setup.js:8) 风险等级：⛔ EXTREME 🚨 发现极端危险代码，禁止安装！ 红旗列表: 🚨 Curl pipe to bash (scripts/install.sh:15) 🚨 Accessing .ssh directory (scripts/setup.js:8) ### 发现高风险（v2.0 新格式） 🛡️ 开始 Skills 安全安装流程 v2.0 📋 检查 Skill: some-skill ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 第一步：Skill-Vetter 代码审查 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📊 信任层级评估... ⚠️ 未知作者 - 最高审查 📄 发现 3 个脚本文件 ⚠️ 发现 3 个潜在问题: 🔴 Use of eval() (main.js:45) 🔴 Accessing memory files (config.js:12) 🟡 Network module (utils.js:5) 风险等级：🔴 HIGH ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 第二步：ClawHub 评分检查 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ✅ 评分：4.2/5.0 (高评分，通过) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 第三步：ThreatBook 沙箱扫描 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📤 上传文件到沙箱... ✅ 分析完成 📊 扫描结果: 判定：SAFE 威胁等级：clean 可信度：95% ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📋 复核结果摘要 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ┌─────────────────────────────────────────────────────┐ │ 三层安全检查结果 │ ├─────────────────────────────────────────────────────┤ │ 1️⃣ Vetter 审查 🔴 需确认 │ 风险：HIGH │ │ 2️⃣ ClawHub 评分 ✅ 通过 │ 评分：4.2/5.0 │ │ 3️⃣ ThreatBook ✅ 通过 │ 结果：safe │ └─────────────────────────────────────────────────────┘ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🎯 最终决策 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ⚠️ 需要任务下达者确认: • Vetter 发现 3 个潜在问题 (high 风险) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ❓ 等待确认 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Skill: some-skill 以下问题需要您确认: • Vetter 发现 3 个潜在问题 (high 风险) 是否继续安装？ 输入 y 或 yes 继续，其他键取消 > ### 相关文件 SKILL.md - Skill 元数据和使用说明 README.md - 完整文档 SECURITY_PROCESS.md - 安全流程详解 scripts/safe-install.mjs - 主安装脚本 ### 注意事项 API 配额: 免费账户有每日扫描次数限制 分析时间: 沙箱动态分析需要 1-2 分钟，默认超时 120 秒 文件大小: 单文件最大 100MB 隐私: 上传的文件会被微步在线分析，不要上传敏感/机密文件 网络: 需要能访问 api.threatbook.cn 和 ClawHub API ### v2.0 (2026-02-28) 🆕 新增 --auto 自动模式选项 🔄 重构决策逻辑为决策矩阵 📊 统一展示三层安全检查结果摘要 🎨 优化输出格式和用户体验 🐛 改进错误处理和堆栈跟踪 ### v1.1.0 (2026-02-27) 🎉 新增 Skill-Vetter 代码审查作为第一层检查 🎉 检测 25+ 种红旗模式 ### 许可证 MIT License ## Trust - Source: tencent - Verification: Indexed source record - Publisher: CHJ0w0 - Version: 2.0.1 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-04-29T15:31:20.151Z - Expires at: 2026-05-06T15:31:20.151Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/skill-safe-install) - [Send to Agent page](https://openagent3.xyz/skills/skill-safe-install/agent) - [JSON manifest](https://openagent3.xyz/skills/skill-safe-install/agent.json) - [Markdown brief](https://openagent3.xyz/skills/skill-safe-install/agent.md) - [Download page](https://openagent3.xyz/downloads/skill-safe-install)