OpenClaw Skill Finder | OpenClaw 技能查找器

🔍 搜索、浏览、发现 ClawHub 平台上的 OpenClaw 技能

English | 中文

⚠️ Current Status (v1.1.1)

Working Features: Search & Info commands In Development: List/Trending/Browse features (coming soon)

This tool currently focuses on powerful search capabilities across 100,000+ skills. Additional browsing features will be added as the underlying API improves.

English

📖 Overview

OpenClaw Skill Finder is a command-line tool that helps you search and discover OpenClaw skills from the ClawHub platform's extensive catalog of 100,000+ skills. Built to enhance the native clawhub CLI with advanced filtering and better output formatting.

✨ Current Features (v1.1.1)

🔎 Smart Search ✅

• Vector search across 100,000+ skills (powered by ClawHub)
• Full-text search across skill names, descriptions, and tags
• Advanced filtering options
• JSON output for scripting and automation

Available Filters:

• --limit <n> - Limit number of results (default: 20)
• --min-downloads <n> - Filter by minimum downloads
• --verified - Show only verified skills
• --quality-score <n> - Filter by quality score
• --sort <field> - Sort by relevance, downloads, or rating
• --json - Output as JSON

📋 Skill Information ✅

• Get detailed information about any skill
• Clear error messages for non-existent skills
• Install instructions included

🎨 User-Friendly Interface

• Color-coded output for easy scanning
• Performance warnings for realistic expectations
• Helpful error messages
• Clean, readable formatting

🚧 Coming Soon

• Browse/List all skills (waiting for API support)
• Trending skills discovery
• Recently updated skills
• Offline caching for faster searches

🚀 Quick Start

Installation

# Install globally via npm
npm install -g openclaw-skill-finder

# Verify installation
skill-finder --version

Or via ClawHub:

clawhub install skill-finder

Basic Usage

# Search for skills (note: takes 15-20 seconds for 100K+ skills)
skill-finder search video

# Search with multiple keywords
skill-finder search "video generation automation"

# Advanced filtering
skill-finder search automation --verified --min-downloads 1000

# JSON output for scripting
skill-finder search ai --json | jq '.[] | .slug'

# Get detailed information about a skill
skill-finder info video-generator

📋 Available Commands

search - Search for Skills ✅

Search across 100,000+ skills with advanced filtering.

Usage:

skill-finder search <query> [options]

Options:

• --limit <n> - Maximum results to show (default: 20)
• --min-downloads <n> - Filter by minimum downloads
• --verified - Show only verified skills
• --quality-score <n> - Minimum quality score (0-5)
• --sort <field> - Sort by: relevance, downloads, rating (default: relevance)
• --json - Output as JSON for scripting

Examples:

# Basic search
skill-finder search "video editing"

# Verified skills only
skill-finder search automation --verified

# High-quality skills with many downloads
skill-finder search ai --quality-score 4.0 --min-downloads 1000

# JSON output for automation
skill-finder search data --json | jq '.[] | {slug, name, score}'

# Sorted by downloads
skill-finder search tools --sort downloads --limit 10

Performance Note: Searches take 15-20 seconds due to vector search across 100K+ skills. This is expected behavior.

info - Get Skill Details ✅

Show detailed information about a specific skill.

Usage:

skill-finder info <skill-slug>

Examples:

# Get skill information
skill-finder info video-generator

# JSON output
skill-finder info video-generator --json

Output includes:

• Skill name and description
• Search relevance score
• Installation instructions
• Repository information

🚧 Commands Coming Soon

The following commands are temporarily unavailable due to upstream API limitations. They will be re-enabled in a future release:

• list - Browse all available skills
• trending - Show trending skills
• recent - Show recently updated skills

Want these features? Star the repo and follow for updates!

skill-finder install-info <skill-name>

Show installation guide for a skill.

skill-finder install-info video-generator

skill-finder related <skill-name>

Find skills related to the specified one.

skill-finder related video-generator

🎯 Real Usage Examples

Example 1: Search for Video Processing Skills

$ skill-finder search video --limit 5

ℹ Searching 100,000+ skills (may take 15-20 seconds)...

🔍 Found 5 skills matching "video":

1.  video-frames  Video Frames  (3.67)

2.  video-learn  Video Understanding  (3.39)

3.  lh-video-gen  LH Video Gen  (3.37)

4.  video-translator  Video Translator  (3.36)

5.  save-douyin-video-to-feishu-drive  Save Douyin Video To Feishu Drive  (3.33)

Use 'skill-finder info <slug>' for details

Example 2: Filter Verified High-Quality Skills

$ skill-finder search automation --verified --min-downloads 1000 --limit 5

ℹ Searching 100,000+ skills (may take 15-20 seconds)...

🔍 Found 3 skills matching "automation":

1.  automation-workflows  Automation Workflows  (3.77)

2.  task-automation  Task Automation  (3.65)

3.  workflow-engine  Workflow Engine  (3.52)

Use 'skill-finder info <slug>' for details

Example 3: JSON Output for Scripting

$ skill-finder search ai --limit 3 --json

[
  {
    "slug": "ai-assistant",
    "name": "AI Assistant",
    "score": 3.89
  },
  {
    "slug": "ai-analyzer",
    "name": "AI Analyzer",
    "score": 3.67
  },
  {
    "slug": "ai-tools",
    "name": "AI Tools",
    "score": 3.45
  }
]

Example 4: Get Skill Information

$ skill-finder info video-frames

📦 video-frames
   Video Frames

Description:
  Unable to fetch details

Install:
  clawhub install video-frames

🔑 API Keys (at least one required): • OPENAI_API_KEY - OpenAI TTS/ASR (recommended) • ALIYUN_ACCESS_KEY_ID - Aliyun alternative • AZURE_SPEECH_KEY - Azure alternative • TENCENT_SECRET_ID - Tencent Cloud alternative

💾 Installation: npm install -g openclaw-video-generator

Or via ClawHub: clawhub install video-generator

📚 More Info: skill-finder install-info video-generator skill-finder related video-generator

🔗 Links: • npm: https://www.npmjs.com/package/openclaw-video-generator • Docs: https://github.com/ZhenRobotics/openclaw-video-generator#readme • Issues: https://github.com/ZhenRobotics/openclaw-video-generator/issues

#### Example 4: JSON Output for Scripting

```bash
$ skill-finder search video --limit 2 --json

{
  "query": "video",
  "count": 2,
  "results": [
    {
      "name": "video-generator",
      "description": "Automated text-to-video generation system",
      "tags": ["video", "automation", "ai", "tts"],
      "verified": true,
      "users": 234,
      "repository": "https://github.com/ZhenRobotics/openclaw-video-generator"
    },
    {
      "name": "video-editor",
      "description": "CLI video editing tool",
      "tags": ["video", "editing", "cli"],
      "verified": false,
      "users": 156,
      "repository": "https://github.com/example/video-editor"
    }
  ]
}

🔧 Configuration

Create a configuration file at ~/.skill-finder/config.json:

{
  "defaultSort": "popularity",
  "defaultLimit": 20,
  "showVerifiedOnly": false,
  "colorOutput": true,
  "apiEndpoint": "https://api.clawhub.ai",
  "cacheEnabled": true,
  "cacheDuration": 3600
}

Configuration Options:

| Option | Type | Default | Description | |--------|------|---------|-------------| | defaultSort | string | "relevance" | Default sort order | | defaultLimit | number | 20 | Default result limit | | showVerifiedOnly | boolean | false | Show only verified skills | | colorOutput | boolean | true | Enable colored output | | apiEndpoint | string | "https://api.clawhub.ai" | ClawHub API endpoint | | cacheEnabled | boolean | true | Enable result caching | | cacheDuration | number | 3600 | Cache duration in seconds |

📊 Output Formats

Table Format (Default):

skill-finder list

Compact Format:

skill-finder list --compact

JSON Format:

skill-finder list --json

🐛 Troubleshooting

Cannot Connect to ClawHub API

Problem: Network errors or timeout when searching

Solutions:

• Check your internet connection
• Verify firewall settings
• Try using debug mode: skill-finder --debug search video
• Check API status: https://status.clawhub.ai

No Results Found

Problem: Search returns empty results

Solutions:

• Try broader search terms
• Remove filters (--verified, --tag)
• Check spelling and keywords
• Use skill-finder list to see all available skills

Command Not Found

Problem: skill-finder: command not found

Solutions:

# Verify installation
npm list -g openclaw-skill-finder

# Reinstall
npm install -g openclaw-skill-finder

# Check npm global path
npm config get prefix

# Add to PATH if needed (bash/zsh)
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.bashrc
source ~/.bashrc

🔗 Links

• npm Package: https://www.npmjs.com/package/openclaw-skill-finder
• GitHub Repository: https://github.com/ZhenRobotics/openclaw-skill-finder
• ClawHub Platform: https://clawhub.ai
• Bug Reports: https://github.com/ZhenRobotics/openclaw-skill-finder/issues
• Feature Requests: https://github.com/ZhenRobotics/openclaw-skill-finder/discussions

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built for the OpenClaw ecosystem
• Powered by the ClawHub platform
• Community-driven skill discovery

中文

📖 概述

OpenClaw Skill Finder 是一个强大的命令行工具，帮助您发现、搜索和探索 ClawHub 平台上可用的 OpenClaw 技能。无论您在寻找自动化工具、AI 集成还是生产力增强器，Skill Finder 都能轻松帮您找到所需内容。

✨ 功能特性

🔎 智能搜索

• 跨技能名称、描述和标签的全文搜索
• 模糊匹配，容错搜索
• 高级查询语法支持
• 基于分类的过滤

📊 高级过滤

• 按标签过滤（video、automation、ai、data 等）
• 按热度、日期或相关性排序
• 仅显示已验证的技能
• 按要求过滤（Node.js 版本、依赖项）

💡 智能推荐

• 发现社区中的热门技能
• 基于已安装技能的个性化推荐
• 查看相关技能和替代方案
• 查看新发布和最近更新

📋 详细信息

• 完整的技能元数据和描述
• 依赖项和要求信息
• 安装说明和指南
• 已验证的提交和仓库链接
• 使用示例和文档

🎨 精美的 CLI 界面

• 彩色编码输出，便于浏览
• 交互式提示，提升用户体验
• 长时间操作的进度指示器
• 表格和 JSON 输出格式

🚀 快速开始

安装

# 通过 npm 全局安装
npm install -g openclaw-skill-finder

# 验证安装
skill-finder --version

或通过 ClawHub：

clawhub install skill-finder

基础使用

# 搜索技能
skill-finder search video

# 多关键词搜索
skill-finder search "视频生成 自动化"

# 按标签过滤
skill-finder search --tag video --verified

# 列出所有可用技能
skill-finder list

# 显示热门技能
skill-finder trending

# 获取详细信息
skill-finder info video-generator

📋 命令

搜索命令

skill-finder search <查询> [选项]

搜索匹配您查询的技能。

skill-finder search "数据分析"

选项:
  --tag <标签>         按标签过滤（可多次使用）
  --verified           仅显示已验证技能
  --sort <字段>        排序: relevance, popularity, date (默认: relevance)
  --limit <数量>       限制结果 (默认: 20)
  --json               JSON 输出

示例：

# 搜索视频相关技能
skill-finder search video --tag video --tag automation

# 查找按热度排序的已验证 AI 技能
skill-finder search ai --verified --sort popularity

# 获取前 5 个结果的 JSON 格式
skill-finder search automation --limit 5 --json

浏览命令

skill-finder list [选项]

列出所有可用技能。

skill-finder list

选项:
  --sort <字段>        排序: name, popularity, date (默认: name)
  --limit <数量>       限制结果 (默认: 50)
  --verified           仅显示已验证技能
  --compact            紧凑输出格式
  --json               JSON 输出

skill-finder trending [选项]

显示当前热门技能。

skill-finder trending --limit 10

skill-finder recent [选项]

显示最近更新的技能。

skill-finder recent --limit 10

skill-finder category <名称>

按分类浏览技能。

skill-finder category video
skill-finder category automation
skill-finder category ai

信息命令

skill-finder info <技能名称>

显示技能的详细信息。

skill-finder info video-generator

# 输出包含:
# - 完整描述
# - 标签和分类
# - 要求
# - 安装说明
# - 仓库和验证信息
# - 相关技能

skill-finder install-info <技能名称>

显示技能的安装指南。

skill-finder install-info video-generator

skill-finder related <技能名称>

查找与指定技能相关的技能。

skill-finder related video-generator

🎯 使用示例

示例 1: 查找视频处理技能

$ skill-finder search video --tag video

🔍 找到 5 个匹配 "video" 的技能:

┌─────────────────────┬──────────────────────────────────┬────────┬──────────┐
│ 名称                │ 描述                             │ 标签   │ 用户     │
├─────────────────────┼──────────────────────────────────┼────────┼──────────┤
│ video-generator     │ 自动化文本转视频系统             │ video, │ ⭐ 234   │
│                     │                                  │ ai     │          │
├─────────────────────┼──────────────────────────────────┼────────┼──────────┤
│ video-editor        │ CLI 视频编辑工具                 │ video, │ ⭐ 156   │
│                     │                                  │ edit   │          │
└─────────────────────┴──────────────────────────────────┴────────┴──────────┘

💡 使用 'skill-finder info <名称>' 查看更多详情

示例 2: 发现热门技能

$ skill-finder trending --limit 5

🔥 本周热门技能:

1. video-generator
   📝 自动化文本转视频生成系统
   ⭐ 234 用户  |  ⬆️  本周 +45  |  ✅ 已验证

2. data-analyzer
   📝 高级数据分析和可视化
   ⭐ 189 用户  |  ⬆️  本周 +32  |  ✅ 已验证

3. code-reviewer
   📝 AI 驱动的代码审查助手
   ⭐ 167 用户  |  ⬆️  本周 +28  |  ✅ 已验证

4. task-automator
   📝 工作流自动化框架
   ⭐ 145 用户  |  ⬆️  本周 +24

5. api-tester
   📝 REST API 测试工具包
   ⭐ 123 用户  |  ⬆️  本周 +19  |  ✅ 已验证

示例 3: 获取技能详细信息

$ skill-finder info video-generator

📦 video-generator
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📝 描述:
   多厂商 TTS/ASR 支持的自动化文本转视频生成系统和高端
   视觉风格。将文本脚本转换为带 AI 配音的专业短视频。

🏷️  标签:
   video, automation, ai, tts, remotion, openclaw

📊 统计:
   ⭐ 234 用户
   📅 最后更新: 2026-03-18
   ✅ 已验证: 是

🔗 仓库:
   https://github.com/ZhenRobotics/openclaw-video-generator
   已验证提交: 6f93635

📋 要求:
   • Node.js >= 18
   • npm
   • ffmpeg
   • python3

🔑 API 密钥（至少需要一个）:
   • OPENAI_API_KEY - OpenAI TTS/ASR（推荐）
   • ALIYUN_ACCESS_KEY_ID - 阿里云备选
   • AZURE_SPEECH_KEY - Azure 备选
   • TENCENT_SECRET_ID - 腾讯云备选

💾 安装:
   npm install -g openclaw-video-generator

   或通过 ClawHub:
   clawhub install video-generator

📚 更多信息:
   skill-finder install-info video-generator
   skill-finder related video-generator

🔗 链接:
   • npm: https://www.npmjs.com/package/openclaw-video-generator
   • 文档: https://github.com/ZhenRobotics/openclaw-video-generator#readme
   • 问题: https://github.com/ZhenRobotics/openclaw-video-generator/issues

🔧 配置

在 ~/.skill-finder/config.json 创建配置文件：

{
  "defaultSort": "popularity",
  "defaultLimit": 20,
  "showVerifiedOnly": false,
  "colorOutput": true,
  "apiEndpoint": "https://api.clawhub.ai",
  "cacheEnabled": true,
  "cacheDuration": 3600
}

配置选项：

| 选项 | 类型 | 默认值 | 描述 | |------|------|--------|------| | defaultSort | string | "relevance" | 默认排序方式 | | defaultLimit | number | 20 | 默认结果限制 | | showVerifiedOnly | boolean | false | 仅显示已验证技能 | | colorOutput | boolean | true | 启用彩色输出 | | apiEndpoint | string | "https://api.clawhub.ai" | ClawHub API 端点 | | cacheEnabled | boolean | true | 启用结果缓存 | | cacheDuration | number | 3600 | 缓存持续时间（秒） |

🐛 故障排除

无法连接到 ClawHub API

问题： 搜索时出现网络错误或超时

解决方案：

• 检查您的互联网连接
• 验证防火墙设置
• 尝试调试模式: skill-finder --debug search video
• 检查 API 状态: https://status.clawhub.ai

未找到结果

问题： 搜索返回空结果

解决方案：

• 尝试更广泛的搜索词
• 移除过滤器（--verified、--tag）
• 检查拼写和关键词
• 使用 skill-finder list 查看所有可用技能

命令未找到

问题： skill-finder: command not found

解决方案：

# 验证安装
npm list -g openclaw-skill-finder

# 重新安装
npm install -g openclaw-skill-finder

# 检查 npm 全局路径
npm config get prefix

# 如需要添加到 PATH (bash/zsh)
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.bashrc
source ~/.bashrc

🔗 链接

• npm 包: https://www.npmjs.com/package/openclaw-skill-finder
• GitHub 仓库: https://github.com/ZhenRobotics/openclaw-skill-finder
• ClawHub 平台: https://clawhub.ai
• Bug 报告: https://github.com/ZhenRobotics/openclaw-skill-finder/issues
• 功能请求: https://github.com/ZhenRobotics/openclaw-skill-finder/discussions

🤝 贡献

欢迎贡献！请随时提交 Pull Request。

📄 许可证

MIT License - 详见 LICENSE 文件。

🙏 致谢

• 为 OpenClaw 生态系统构建
• 由 ClawHub 平台提供支持
• 社区驱动的技能发现

Version: 1.0.0 Author: justin Maintained by: ZhenStaff Last Updated: 2026-03-23