skills-search

核心用法

skill-search 是 ClawHub 生态系统的核心基础设施技能，为 Agent 提供动态发现和能力扩展机制。其核心工作流程包含五个环节：通过关键词、分类或标签搜索技能；浏览热门趋势技能；获取特定技能的元数据、质量评分和依赖信息；提取技能内容到临时目录；以及执行加载的技能。用户可通过 skillhub.sh 脚本与 skills.droyd.ai API 交互，实现即搜即用的灵活体验。

显著优点

该技能最大价值在于打破传统技能安装的刚性约束，实现"按需加载、用完即走"的轻量化模式。29 个内置分类覆盖开发、金融、媒体、智能家居等全场景，配合趋势发现和评分机制，大幅降低技能筛选成本。脚本内置严格的安全审查警告（第 5-27 行），主动提示 API 密钥提取、提示注入等风险，体现负责任的安全设计。临时目录隔离机制确保系统关键位置不受影响。

潜在缺点与局限性

作为技能加载器，其本质风险在于代理执行未经验证的第三方代码。尽管自身代码规范，但无法保证下游技能的安全性。网络依赖导致离线场景不可用，且搜索查询需发送至外部服务器存在隐私考量。动态加载模式也可能带来版本不一致和依赖冲突问题。

适合的目标群体

主要面向需要快速探索 ClawHub 生态的开发者、希望临时试用技能而不愿永久安装的用户，以及构建自适应 Agent 系统的架构师。对安全敏感的生产环境，建议配合沙箱使用。

使用风险

除上述代码执行风险外，需注意：外部 API 服务中断将导致功能失效；高频调用可能触发速率限制；提取的多文件技能需独立解析执行逻辑，增加认知负担。

核心用法

skill-search 是 ClawHub 生态的 Skill 发现与动态加载入口，提供四大能力：

1. 搜索发现：通过关键词、分类、标签检索 Skill，支持结果数量限制
2. 趋势浏览：查看热门 Skill，可按时间窗口（7d/30d）和领域筛选
3. 详情审查：获取 Skill 元数据、质量评分、依赖项、所需 API 密钥等关键信息
4. 动态加载：提取远程 Skill 内容至 /tmp/openclaw-skills/，供 Agent 即时执行而无需永久安装

典型工作流：search → detail → content --extract → 读取 SKILL.md → 执行。所有交互通过 HTTPS 与 skills.droyd.ai 通信。

显著优点

• 零安装即用：动态加载避免污染本地环境，适合一次性任务或安全沙箱测试
• 丰富生态：覆盖 30+ 分类（DeFi、自动化、媒体处理、智能家居等），快速补齐 Agent 能力缺口
• 完善安全提示：脚本内置详细警告，提醒审查 API 密钥窃取、提示词注入、加密货币盗窃等恶意模式
• 来源可信：由 OpenClaw GitHub 组织维护（T2 级别），维护者有公开提交历史
• 隐私友好：不收集敏感数据，不遍历环境变量，符合 GDPR 数据最小化原则

潜在缺点与局限性

• 单层动态代码风险（L1）：远程 Skill 内容经提取后需 Agent 主动执行，虽非自动触发，但仍依赖用户/Agent 的事后审查
• 外部服务依赖：核心功能完全依赖 skills.droyd.ai，服务不可用或被攻破将中断使用（当前无离线缓存）
• 权限控制宽松：提取文件使用系统默认权限，未自动收紧为 600，同一主机其他用户可能读取
• 无签名验证：目前缺乏数字签名机制，无法验证下载内容是否被篡改
• 沙箱执行依赖建议：虽文档建议沙箱首次执行，但无强制隔离机制

适合人群

• 需要快速为 Agent 增加特定能力（如浏览器自动化、PDF 处理、加密交易）的开发者
• 希望在隔离环境测试陌生 Skill 的安全研究人员
• 追求轻量、避免永久安装污染系统的效率用户
• 熟悉基础安全审查、能理解并接受动态代码风险的技术用户

常规风险

| 风险类别 | 等级 | 说明 |

|---------|------|------|

| 动态代码执行 | 中 | 单层远程拉取，需人工/Agent 审查后执行 |

| 供应链攻击 | 中 | 依赖 ClawHub registry 安全性，无签名验证 |

| 网络可用性 | 低 | 外部 API 依赖，建议添加超时重试 |

| 本地信息泄露 | 低 | /tmp 目录权限宽松，建议提取后收紧权限 |

| 恶意 Skill 内容 | 中 | 需结合 CLS-Certify 等工具二次扫描 |

建议操作：提取后先用 CLS-Certify 扫描，沙箱验证行为，再用于生产环境。