How to Install ClawHub Skills
Comprehensive guide to installing OpenClaw skills from ClawHub. Learn CLI commands, troubleshooting, and best practices.
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.
⚡ Quick Start
Install a ClawHub skill with a single command:
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
openclaw skill install github-integration
openclaw skill install notion-integration
openclaw skill install slack-integration
Install Specific Version
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
openclaw skill install notion-integration --with-deps
# Dependencies are resolved automatically by default
Method 2: Web Interface
Browse and find skills on ClawHub.ai:
- Visit https://clawhub.ai
- Search for desired skill using vector search
- Click on the skill to view details
- Copy the installation command provided
- 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:
Examples
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
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
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
--forceonly as last resort
Verification After Installation
List Installed Skills
openclaw skill list
# Output shows skill name, version, and status
# [email protected] (installed)
# [email protected] (installed)
# [email protected] (installed)
Check Skill Information
openclaw skill info github-integration
# Shows: name, version, description, dependencies,
# author, stars, downloads, installation date
Verify Skill Functionality
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
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
- Run with appropriate permissions (avoid sudo if possible)
- Use
--userflag for user-level installation - Check file system permissions
Issue 2: Version Conflict
Error: Version conflict detected
- Update conflicting skill to compatible version
- Specify compatible version range
- Use
openclaw skill outdatedto check
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
- Check internet connection
- Try different registry mirror
- Check firewall settings
- Retry installation
openclaw skill install github-integration --verbose
# Use different timeout
openclaw skill install github-integration --timeout=30000
Issue 4: Dependency Errors
Error: Dependency resolution failed
- Install dependencies manually first
- Use
--forceto override checks - Clear cache and retry
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
- Verify skill name spelling
- Check if skill was removed from ClawHub
- Search for alternative skills
- Visit ClawHub.ai to confirm availability
openclaw skill search github integration
# Check exact name on ClawHub.ai
# Visit: https://clawhub.ai/skills
Uninstalling Skills
Remove Single Skill
openclaw skill remove github-integration
# Uninstall with confirmation prompt
openclaw skill remove notion-integration --confirm
Remove with Dependencies
openclaw skill remove github-integration --cascade
# Clean up all unused dependencies
openclaw skill prune
Verify Removal
openclaw skill list
# Skill should no longer appear in the list
Updating Skills
Update Single Skill
openclaw skill update github-integration
# Update to specific version
openclaw skill update [email protected]
Update All 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.