Installation Guide
Complete guide to installing and configuring the clawhub CLI
On This Page
Prerequisites
Before installing clawhub, ensure your system meets these requirements:
Required Software
- Node.js 18.0.0 or higher
- Download from nodejs.org
- Verify:
node --version
- npm 9.0.0 or higher
- Included with Node.js
- Verify:
npm --version
- Claude Code CLI
- Install from claude.ai/claude-code
Supported Platforms
| Platform | Supported | Notes |
|---|---|---|
| macOS | ✅ Yes | macOS 11 (Big Sur) or later |
| Linux | ✅ Yes | Most distributions supported |
| Windows | ✅ Yes | Requires WSL2 or Git Bash |
| Windows (native) | ⚠️ Partial | Some features may not work |
Installation
Method 1: Using npm (Recommended)
Install clawhub globally using npm:
The -g flag installs clawhub globally, making it available from any directory.
Method 2: Using Yarn
If you prefer yarn:
Method 3: Using pnpm
If you use pnpm:
Method 4: Install from Source
For development or testing the latest features:
Permission Issues?
If you encounter permission errors during installation, avoid using sudo. Instead, configure npm to use a different directory or use a Node version manager like nvm.
Configuration
After installation, clawhub needs to be configured to work with your Claude Code installation.
Automatic Configuration
Run the setup wizard:
The wizard will:
- Detect your Claude Code installation
- Create necessary configuration files
- Set up skill installation directories
- Configure default preferences
Manual Configuration
If the automatic setup doesn't work, you can manually configure clawhub by creating a configuration file at ~/.clawhubrc:
Configuration Options
| Option | Description | Default |
|---|---|---|
claudeCodePath | Path to Claude Code installation | Auto-detected |
skillsDirectory | Where to install skills | ~/.clawhub/skills |
registry | ZhenSkill API endpoint | https://www.zhenskill.com/api |
autoUpdate | Auto-update skills | true |
Verifying Installation
Check Version
Verify clawhub is installed correctly:
Expected output:
Check Configuration
Verify your configuration:
This will display your current configuration settings.
Test Connection
Test connection to ZhenSkill registry:
If you see search results, your installation is working correctly!
Installation Complete!
You're ready to start installing skills. Check out the Getting Started guide to install your first skill.
Updating clawhub
Check for Updates
Update via npm
Update via yarn
Troubleshooting
Command Not Found
Problem: After installation, running clawhub returns "command not found".
Solution:
- Verify npm's global bin directory is in your PATH:npm config get prefix
- Add npm's bin directory to your PATH. Add this to your
~/.bashrcor~/.zshrc:export PATH="$PATH:$(npm config get prefix)/bin" - Restart your terminal
Permission Denied
Problem: "EACCES: permission denied" error during installation.
Solution:
- Use a Node version manager like nvm (recommended)
- Or change npm's default directory:mkdir ~/.npm-globalnpm config set prefix '~/.npm-global'export PATH=~/.npm-global/bin:$PATH
Claude Code Not Detected
Problem: clawhub can't find your Claude Code installation.
Solution:
- Verify Claude Code is installed and in your PATH
- Manually specify the path:clawhub config set claudeCodePath /path/to/claude-code
Network/Registry Issues
Problem: Can't connect to ZhenSkill registry.
Solution:
- Check your internet connection
- Verify you can access
https://www.zhenskill.com - Check if you're behind a corporate proxy and configure it:npm config set proxy http://proxy.company.com:8080
Still Having Issues?
If none of these solutions work:
- Check the GitHub Issues
- Join our Discord community
- Review the CLI Reference for more details