Installation Guide
Everything you need to install ClawdBot on your system.
Prerequisites
- Node.js 22+ — Required. Download from nodejs.org
- pnpm — Optional, recommended for source builds. Install:
npm i -g pnpm - Brave Search API — Optional, enables web search. Get at brave.com/search/api
Platform Notes
Windows: WSL2 (Ubuntu) is strongly recommended. Native Windows works but some features may be limited. Install WSL2:
wsl --install
macOS: If building from source, install Xcode Command Line Tools:
xcode-select --install
Installation Methods
One-Line Installer (Recommended)
Fastest way to get started:
macOS / Linux / WSL2
curl -fsSL https://clawd.bot/install.sh | bashWindows PowerShell
iwr -useb https://clawd.bot/install.ps1 | iexNPM / PNPM
Install globally via package manager:
npm
npm install -g clawdbotpnpm
pnpm add -g clawdbotBuild from Source
For developers who want full control:
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install
pnpm ui:build
pnpm buildVerify Installation
clawdbot --versionYou should see the version number. If you get "command not found":
- Close and reopen your terminal
- Check npm global bin is in PATH:
npm config get prefix - Add that path +
/binto your shell profile
Success? Continue to Setup & Configuration
Troubleshooting
Node.js version error
ClawdBot requires Node.js 22+. Use nvm to manage versions:
nvm install 22
nvm use 22Permission denied (Linux/macOS)
Fix npm global permissions:
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrcWindows: command not found
- Close and reopen PowerShell
- Restart your computer
- Or use WSL2 instead (recommended)
Still stuck?
Run diagnostics and share the output:
clawdbot status --allGet help on Discord or GitHub Issues.