Guide to Using the OpenClaw ClawHub Skill Marketplace

Introduction

ClawHub is OpenClaw's official skill marketplace, similar to what npm is to Node.js or extensions are to VS Code. Through ClawHub, you can install community-developed skills with a single command and share your own skills with the world.

As of now, ClawHub hosts hundreds of skills spanning productivity tools, information queries, entertainment, and more.

How ClawHub Works

ClawHub skills are essentially SKILL.md files that are stored in the ~/.openclaw/skills/ directory after installation. Each skill is a Markdown file that defines trigger conditions, behavioral logic, and output formats.

~/.openclaw/skills/
├── weather.SKILL.md
├── translator.SKILL.md
├── reminder.SKILL.md
└── github-notify.SKILL.md

Browsing the Skill Marketplace

Online Browsing

Visit the official ClawHub website to view all available skills:

https://clawhub.dev

The website offers category browsing, trending recommendations, and latest releases.

Command-Line Browsing

You can also browse and search for skills from the terminal:

# List installed skills
openclaw skill list

# Search for skills
npx clawhub@latest search weather

# View skill details
npx clawhub@latest info weather-forecast

Example search results:

Search results for "weather":
  weather-forecast    ★ 4.8  ↓ 12.3k  Weather forecast with multi-source data
  weather-alert       ★ 4.5  ↓ 3.2k   Severe weather alerts and notifications
  weather-clothing    ★ 4.2  ↓ 1.1k   Clothing recommendations based on weather

3 skills found

Installing Skills

Basic Installation

Use the npx clawhub@latest install command to install skills:

# Install the weather forecast skill
npx clawhub@latest install weather-forecast

# Install the translator skill
npx clawhub@latest install translator

# Install multiple skills
npx clawhub@latest install weather-forecast translator reminder

After installation, restart OpenClaw to activate the skills:

openclaw restart

Installing a Specific Version

# Install a specific version
npx clawhub@latest install [email protected]

# Install the latest preview version
npx clawhub@latest install weather-forecast@next

Installing from a Git Repository

If a skill hasn't been published to ClawHub yet, you can install it directly from a Git repository:

npx clawhub@latest install --git https://github.com/username/my-skill.git

Installing a Local Skill

During development, you can install from a local directory:

npx clawhub@latest install --local ./my-weather-skill/

Managing Installed Skills

Viewing Installed Skills

openclaw skill list

Example output:

Installed Skills:
  NAME               VERSION   STATUS    SOURCE
  weather-forecast   1.3.2     active    clawhub
  translator         2.1.0     active    clawhub
  reminder           1.0.5     active    clawhub
  custom-greeter     -         active    local

4 skills installed, 4 active

Updating Skills

# Update a single skill
npx clawhub@latest update weather-forecast

# Update all skills
npx clawhub@latest update --all

# Check for available updates (without applying them)
npx clawhub@latest outdated

Example outdated output:

Outdated Skills:
  NAME               CURRENT   LATEST    CHANGELOG
  weather-forecast   1.3.2     1.4.0     Added hourly forecast support
  translator         2.1.0     2.2.1     Fixed CJK language detection

2 skills can be updated
Run 'npx clawhub@latest update --all' to update

Uninstalling Skills

# Uninstall a single skill
npx clawhub@latest uninstall weather-forecast

# Uninstall and clean up data
npx clawhub@latest uninstall weather-forecast --purge

Enabling/Disabling Skills

You can temporarily disable a skill without uninstalling it:

# Disable a skill
openclaw skill disable translator

# Re-enable it
openclaw skill enable translator

You can also manage this in the configuration file:

{
  skills: {
    // Global disable list
    disabled: ["translator"],
    // Or use a whitelist approach
    // enabled: ["weather-forecast", "reminder"]
  }
}

Skill Categories and Recommendations

Skills on ClawHub are organized into the following categories:

Publishing Your Skill to ClawHub

Preparation

1. Register a ClawHub developer account:

npx clawhub@latest register

2. Log in:

npx clawhub@latest login

Skill Directory Structure

Before publishing, your skill needs to follow this structure:

my-awesome-skill/
├── SKILL.md            # Skill definition file (required)
├── clawhub.json        # Metadata file (required)
├── README.md           # Documentation (recommended)
├── CHANGELOG.md        # Changelog (recommended)
└── examples/           # Usage examples (recommended)
    └── demo.md

Metadata File

Create a clawhub.json to describe your skill:

{
  "name": "my-awesome-skill",
  "version": "1.0.0",
  "description": "A brief description of what this skill does",
  "author": "your-username",
  "license": "MIT",
  "keywords": ["utility", "productivity"],
  "category": "效率工具",
  "openclaw": {
    "minVersion": "1.0.0"
  },
  "repository": "https://github.com/username/my-awesome-skill"
}

Pre-Publish Validation

# Run validation in the skill directory
npx clawhub@latest validate

# Test install locally
npx clawhub@latest install --local ./

Publishing

# Publish to ClawHub
npx clawhub@latest publish

# Publish a preview version
npx clawhub@latest publish --tag next

Updating a Published Skill

# Bump the version number and republish
npx clawhub@latest publish

# Unpublish a version (within 24 hours)
npx clawhub@latest unpublish [email protected]

Skill Security Review

ClawHub performs security reviews on all published skills:

1. Automated Scanning: Checks for malicious code and privacy leak risks
2. Community Review: Popular skills undergo community review
3. Signature Verification: File integrity is verified during installation

You can view a skill's security rating:

npx clawhub@latest info weather-forecast --security

Security Report: [email protected]
  Verified author:     ✓
  No external calls:   ✓ (uses MCP tools only)
  Community reviewed:  ✓ (23 reviews)
  Security score:      A+

FAQ

Installed Skill Doesn't Work

# Confirm the skill is properly installed
openclaw skill list

# Restart OpenClaw
openclaw restart

# Check if the skill is disabled
openclaw skill list | grep disabled

Skill Version Conflicts

If two skills conflict, check their priority settings:

# View skill load order
openclaw skill list --verbose

npx Commands Are Slow

You can install the ClawHub CLI globally:

npm install -g clawhub@latest

# Then use it directly
clawhub install weather-forecast
clawhub search translator

Summary

The ClawHub skill marketplace greatly extends OpenClaw's capabilities. With simple command-line operations, you can add all kinds of useful features to your AI assistant. If you've developed a great skill, you're welcome to publish it to ClawHub and share it with the community.

Next, you can follow the skill development tutorials to learn how to create your own Skills from scratch.