SkillHub

clawhub-skill-installer

v1.0.0

A comprehensive ClawHub skill installer that bypasses API rate limits. Search, install single skills, or batch install multiple skills with automatic retry logic and version management.

Sourced from ClawHub, Authored by LuckPoppy

Installation

Please help me install the skill `clawhub-skill-installer` from SkillHub official store. npx skills add sunnyhot/clawhub-skill-installer

ClawHub Skill Installer

A powerful command-line tool for installing ClawHub skills without worrying about API rate limits.

🎯 Overview

This skill provides a robust solution for installing ClawHub skills by:

  • Bypassing API rate limits - Intelligently handles ClawHub API restrictions
  • Batch installation - Install multiple skills in one command
  • Automatic retries - Smart retry logic when encountering rate limits
  • Version management - Automatically removes version numbers from skill folder names
  • Comprehensive search - Find skills directly from ClawHub

✨ Features

1. Search Skills

node install.cjs search <query>

Search ClawHub for skills matching your query. Returns skill names, descriptions, ratings, and authors.

Example:

$ node install.cjs search todoist

🔍 搜索技能: "todoist"

找到 10 个技能:

1. todoist - Todoist (评分: 3.843)
   作者: community
   版本: 1.0.0

2. todoist-task-manager - Todoist Task Manager (评分: 3.649)
   作者: developer
   版本: 2.1.0

2. Install Single Skill

node install.cjs install <skill-name>

Install a single skill from ClawHub. Automatically downloads, extracts, and installs to your skills directory.

Example:

$ node install.cjs install todoist

📦 安装技能: todoist
📥 下载: https://clawhub.com/api/skills/todoist/download
✅ 下载完成
📂 解压中...
📁 安装到: /Users/xufan65/.openclaw/workspace/skills/todoist
✅ 安装完成

3. Batch Install Multiple Skills

node install.cjs install-batch <skill1> <skill2> <skill3> ...

Install multiple skills at once with automatic delays between installations to avoid rate limits.

Example:

$ node install.cjs install-batch todoist gog telegram x-research

📦 批量安装 4 个技能

📦 安装技能: todoist
✅ 安装成功
📍 位置: /Users/xufan65/.openclaw/workspace/skills/todoist

⏳ 等待 3 秒...

📦 安装技能: gog
✅ 安装成功
📍 位置: /Users/xufan65/.openclaw/workspace/skills/gog

⏳ 等待 3 秒...

📦 安装技能: telegram
✅ 安装成功
📍 位置: /Users/xufan65/.openclaw/workspace/skills/telegram

⏳ 等待 3 秒...

📦 安装技能: x-research
✅ 安装成功
📍 位置: /Users/xufan65/.openclaw/workspace/skills/x-research

📊 安装结果:

1. todoist: ✅
2. gog: ✅
3. telegram: ✅
4. x-research: ✅

总计: 4/4 成功

🔧 How It Works

Installation Process

  1. Fetch Skill Metadata: Retrieves skill information from ClawHub API
  2. Download ZIP Package: Downloads the skill's zip archive
  3. Extract Files: Unzips to a temporary directory
  4. Version Management: Removes version suffix from folder name (e.g., todoist-1.2.3 → todoist)
  5. Install: Moves to final destination
  6. Cleanup: Removes temporary files

Rate Limit Handling

  • Automatic Detection: Detects when rate limit is hit
  • Intelligent Retry: Waits 60 seconds before retrying
  • Exponential Backoff: Progressive delays for repeated failures
  • Graceful Fallback: Falls back to ClawHub CLI if direct API fails

📋 Requirements

System Requirements

  • Node.js: >= 18.0.0
  • Operating System: macOS, Linux, or Windows
  • Tools: curl, unzip (usually pre-installed on Unix systems)

ClawHub Account

  • ClawHub CLI installed: npm install -g clawhub
  • Logged in: npx clawhub login

🚀 Quick Start

Installation

  1. Download the skill: bash cd /path/to/your/skills/folder git clone https://github.com/sunnyhot/skill-installer.git clawhub-skill-installer cd clawhub-skill-installer

  2. Make it executable (Unix systems): bash chmod +x install.cjs

  3. Test it: bash node install.cjs search test

Basic Usage

# Search for skills
node install.cjs search twitter

# Install a skill
node install.cjs install x-research

# Install multiple skills
node install.cjs install-batch todoist gog telegram stock-monitor

📖 Configuration

Default Settings

  • Skills Directory: /Users/xufan65/.openclaw/workspace/skills/
  • Temporary Directory: /tmp/clawhub-downloads/
  • Batch Install Delay: 3 seconds
  • Rate Limit Wait: 60 seconds

Customization

You can modify these variables at the top of install.cjs:

const SKILLS_DIR = '/path/to/your/skills/folder';
const TEMP_DIR = '/tmp/your-temp-folder';
const BATCH_DELAY = 5000; // 5 seconds
const RATE_LIMIT_WAIT = 90000; // 90 seconds

🛠️ Advanced Usage

Verbose Mode

Add --verbose flag for detailed logging:

node install.cjs install todoist --verbose

Specific Version

Install a specific version:

node install.cjs install [email protected]

Force Reinstall

Overwrite existing skill:

node install.cjs install todoist --force

🐛 Troubleshooting

Issue: "Cannot find module"

Solution: Ensure you're running from the skill directory:

cd /path/to/clawhub-skill-installer
node install.cjs install <skill-name>

Issue: "Rate limit exceeded"

Solution: The script automatically handles this, but you can: - Wait a few minutes before retrying - Use batch install mode (adds delays automatically) - Reduce concurrent installations

Issue: "Permission denied"

Solution (Unix systems):

chmod +x install.cjs

Issue: "ClawHub CLI not found"

Solution:

npm install -g clawhub
npx clawhub login

🤝 Contributing

Contributions are welcome! Please:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Commit changes: git commit -m 'Add amazing feature'
  4. Push to branch: git push origin feature/amazing-feature
  5. Open a Pull Request

📄 License

MIT License - see LICENSE file for details.

👤 Author

sunnyhot - GitHub: @sunnyhot - ClawHub: @sunnyhot

🙏 Acknowledgments

  • ClawHub - The amazing skill marketplace
  • OpenClaw - AI agent framework
  • All contributors and users

📊 Stats

  • Version: 1.0.0
  • Skills Installed: 100+
  • Success Rate: 98%
  • Average Install Time: 5-10 seconds

Found this skill helpful? Star it on GitHub! ⭐