How to Install ClawHub Skills

Comprehensive guide to installing OpenClaw skills from ClawHub. Learn CLI commands, troubleshooting, and best practices.

🤖
AiBotClaw.Com Official

Run Your OpenClaw Agent 24/7

Stop managing servers. Let us host your OpenClaw agent with automatic updates, real-time monitoring, and instant scaling across all major messaging platforms.

⚡ One-Click Setup 🔒 Auto Security 📱 WhatsApp/Telegram/Discord 📊 Real-time Stats
Starting at $16.99/mo Get Started

⚡ Quick Start

Install a ClawHub skill with a single command:

openclaw skill install [skill-name]

Example: openclaw skill install github-integration

Installation Methods

Method 1: CLI Installation (Recommended)

The OpenClaw CLI is the primary method for installing skills from ClawHub.

Install Latest Version

# Install the latest version of a skill
openclaw skill install github-integration
openclaw skill install notion-integration
openclaw skill install slack-integration

Install Specific Version

# Install a specific version using Semver
openclaw skill install [email protected]

# Install with version range
openclaw skill install github-integration@^2.1.0 # Any 2.x.x version
openclaw skill install github-integration@~2.1.0 # Any 2.1.x version

Install with Dependencies

# Automatically install all dependencies
openclaw skill install notion-integration --with-deps

# Dependencies are resolved automatically by default

Method 2: Web Interface

Browse and find skills on ClawHub.ai:

  1. Visit https://clawhub.ai
  2. Search for desired skill using vector search
  3. Click on the skill to view details
  4. Copy the installation command provided
  5. Run the command in your terminal

💡 Vector Search

ClawHub uses embeddings-based semantic search. You can search using natural language like "automate my emails" and ClawHub will find relevant skills even without exact keyword matches.

Installation Options

Customize your installation with these command-line options:

--global

Install globally for all OpenClaw agents

--dev

Install as development dependency

--save

Save to skill.json dependencies

--force

Force reinstall, bypass cache

--verbose

Show detailed installation logs

--no-deps

Skip dependency installation

Examples

# Global installation
openclaw skill install github-integration --global

# Development dependency
openclaw skill install test-helper --dev

# Force reinstall
openclaw skill install github-integration --force

# Verbose output
openclaw skill install notion-integration --verbose

Version Management

Understanding Semantic Versioning (Semver)

ClawHub uses Semver in the format MAJOR.MINOR.PATCH (e.g., 2.1.3):

  • MAJOR (2.x.x): Breaking changes, incompatible API
  • MINOR (x.1.x): New features, backward compatible
  • PATCH (x.x.3): Bug fixes, backward compatible

Version Specifiers

# Install exact version
openclaw skill install [name]@1.2.3

# Compatible with 1.x.x (allows minor and patch updates)
openclaw skill install [name]@^1.2.0

# Compatible with 1.2.x (allows only patch updates)
openclaw skill install [name]@~1.2.0

# Install latest version
openclaw skill install [name]@latest

Check Installed Versions

# List all installed skills with versions
openclaw skill list

# Check specific skill version
openclaw skill info github-integration

# Check for outdated skills
openclaw skill outdated

⚠️ Version Conflicts

ClawHub automatically detects version conflicts between dependencies. If a conflict occurs:

  • Review the conflict message carefully
  • Update conflicting skills to compatible versions
  • Use --force only as last resort

Verification After Installation

List Installed Skills

# View all installed skills
openclaw skill list

# Output shows skill name, version, and status
# [email protected] (installed)
# [email protected] (installed)
# [email protected] (installed)

Check Skill Information

# View detailed skill information
openclaw skill info github-integration

# Shows: name, version, description, dependencies,
# author, stars, downloads, installation date

Verify Skill Functionality

# Test if skill is working correctly
openclaw test-skill github-integration

# Check skill status
openclaw skill status

Security Checks

⚠️ ClawHavoc Security Incident

In February 2026, 341 malicious skills containing Atomic Stealer malware were discovered on ClawHub. Always follow security best practices before installing any skill.

Pre-Installation Security Review

  • Check Author Reputation: Verify author identity and history
  • Read Community Comments: Look for security warnings
  • Review Star Count: Popular skills have more scrutiny
  • Check Update Frequency: Active maintenance is a good sign
  • Verify Skill Permissions: Review what access the skill requires
  • After ClawHavoc: Enhanced automated malware scanning

ClawHub's Security Measures

  • ✓ Automated malware scanning for all submissions
  • ✓ Community reporting system (3 reports = auto-hide)
  • ✓ Enhanced review processes
  • ✓ Real-time security monitoring
  • ✓ Moderation team review

Manual Security Review

# Before installing, review the skill's SKILL.md
openclaw skill view github-integration

# Check skill dependencies
openclaw skill deps github-integration

# Read user comments and ratings
openclaw skill comments github-integration

For detailed security guidelines, visit our Security Guide.

Common Installation Issues

Issue 1: Permission Denied

Error: EACCES: permission denied

Solution:
  • Run with appropriate permissions (avoid sudo if possible)
  • Use --user flag for user-level installation
  • Check file system permissions
openclaw skill install github-integration --user

Issue 2: Version Conflict

Error: Version conflict detected

Solution:
  • Update conflicting skill to compatible version
  • Specify compatible version range
  • Use openclaw skill outdated to check
# Update conflicting skill
openclaw skill update conflicting-skill

# Or install compatible version
openclaw skill install new-skill@^2.0.0

Issue 3: Network Errors

Error: ETIMEDOUT or ECONNREFUSED

Solution:
  • Check internet connection
  • Try different registry mirror
  • Check firewall settings
  • Retry installation
# Retry with verbose output
openclaw skill install github-integration --verbose

# Use different timeout
openclaw skill install github-integration --timeout=30000

Issue 4: Dependency Errors

Error: Dependency resolution failed

Solution:
  • Install dependencies manually first
  • Use --force to override checks
  • Clear cache and retry
# Install dependencies manually
openclaw skill install dependency-skill
openclaw skill install main-skill

# Or force installation
openclaw skill install main-skill --force

Issue 5: Skill Not Found

Error: Skill not found in registry

Solution:
  • Verify skill name spelling
  • Check if skill was removed from ClawHub
  • Search for alternative skills
  • Visit ClawHub.ai to confirm availability
# Search for the skill
openclaw skill search github integration

# Check exact name on ClawHub.ai
# Visit: https://clawhub.ai/skills

Uninstalling Skills

Remove Single Skill

# Uninstall a skill
openclaw skill remove github-integration

# Uninstall with confirmation prompt
openclaw skill remove notion-integration --confirm

Remove with Dependencies

# Remove skill and its unused dependencies
openclaw skill remove github-integration --cascade

# Clean up all unused dependencies
openclaw skill prune

Verify Removal

# Check if skill is removed
openclaw skill list

# Skill should no longer appear in the list

Updating Skills

Update Single Skill

# Update to latest version
openclaw skill update github-integration

# Update to specific version
openclaw skill update [email protected]

Update All Skills

# Update all installed skills
openclaw skill update --all

# Check for available updates first
openclaw skill outdated

Update Strategy

  • Critical Security Patches: Update immediately
  • Minor Updates: Test in development environment first
  • Major Updates: Review changelog for breaking changes
  • Subscribe: ClawHub security announcements

💡 Best Practice

Always check the changelog before updating to understand what changes were made. Use openclaw skill changelog [skill-name] to view version history.

Best Practices

Before Installing

  • ✓ Review skill description and documentation
  • ✓ Check author reputation
  • ✓ Read community feedback
  • ✓ Verify security status
  • ✓ Check compatibility with your OpenClaw version

Version Management

  • ✓ Pin specific versions in production
  • ✓ Use version ranges carefully
  • ✓ Test updates in development first
  • ✓ Document installed versions
  • ✓ Review changelogs before updating

Security

  • ✓ Prefer featured/verified skills
  • ✓ Avoid newly published, unverified skills
  • ✓ Report suspicious behavior immediately
  • ✓ Keep all skills updated
  • ✓ Regular security audits

Maintenance

  • ✓ Remove unused skills regularly
  • ✓ Monitor for outdated versions
  • ✓ Document why each skill is installed
  • ✓ Backup your skill configuration

Frequently Asked Questions

Q: How many skills can I install?

A: There's no hard limit, but consider performance impact. Monitor your OpenClaw agent's resource usage and remove unused skills.

Q: Can I install multiple versions of the same skill?

A: No, OpenClaw only supports one version of each skill at a time. Installing a new version will replace the existing one.

Q: Are all ClawHub skills free?

A: Yes, all 3,286 skills on ClawHub are completely free to use.

Q: How do I install skills offline?

A: Download the skill package as a zip file from ClawHub.ai and install locally using openclaw skill install ./path-to-skill.zip

Q: What happens if I install a malicious skill?

A: After the ClawHavoc incident, ClawHub has enhanced security measures. However, always review skills before installing and report suspicious behavior immediately. Visit our Security Guide for more information.