ClawHub

ClawHub Skill Installer

Data & APIs

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.

Install

openclaw skills install 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:

    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):

    chmod +x install.cjs

  3. Test it:

    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 todoist@1.2.3

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

🙏 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! ⭐

More in Data & APIs