Installation
ClawIDE is installed using a single command that downloads the latest pre-built binary for your system.
Install
curl -fsSL https://www.clawide.app/install.sh | bash
This script will:
- Detect your OS and architecture
- Download the requested version (or latest) pre-built binary from clawide.app
- Install to
~/.local/bin - Display the installation plan before proceeding
- Verify the download’s SHA256 against the release’s
checksums.txtand stop without installing if it doesn’t match or can’t be checked (setCLAWIDE_SKIP_VERIFY=1, as incurl -fsSL https://www.clawide.app/install.sh | CLAWIDE_SKIP_VERIFY=1 bash, to skip only the “can’t be checked” case, with a warning)
You can inspect the script before running it:
- View the script: https://www.clawide.app/install.sh
- Review the release history: Changelog
Install a Specific Version
Pin the version with the VERSION environment variable:
curl -fsSL https://www.clawide.app/install.sh | VERSION=2.0.0 bash
The leading v prefix is optional — VERSION=v2.0.0 and VERSION=2.0.0 are equivalent. If the version does not exist, the script exits with an error and a link to the releases page.
Custom Install Directory
Override the default install directory (~/.local/bin) with INSTALL_DIR:
INSTALL_DIR=/usr/local/bin curl -fsSL https://www.clawide.app/install.sh | bash
Prerequisites
ClawIDE requires tmux as its terminal multiplexer backend:
# macOS
brew install tmux
# Debian/Ubuntu
sudo apt install tmux
Windows (WSL2)
ClawIDE runs on Windows inside WSL2. A native Windows build is not supported yet, so use WSL2.
Open PowerShell as administrator and install WSL2. This installs Ubuntu by default:
wsl --installReboot when prompted, then open Ubuntu from the Start menu and create your Linux user.
Inside Ubuntu, install tmux:
sudo apt update && sudo apt install tmuxStill inside the WSL shell, run the same install command:
curl -fsSL https://www.clawide.app/install.sh | bashRun
clawide, then open http://localhost:9800 in your Windows browser (WSL2 forwards localhost, so no extra setup is needed).
Start ClawIDE
Once installed, simply run:
clawide
Then open http://localhost:9800 in your browser.
Verify the Installation
# Check the version
clawide --version
# Run on a custom port
clawide --port 8080
# Run with a specific projects directory
clawide --projects-dir /home/user/code
Uninstall
To remove ClawIDE, run the uninstall script:
curl -fsSL https://www.clawide.app/uninstall.sh | bash
This will remove the clawide binary and the ~/.clawide configuration directory after asking for confirmation. It does not modify your shell config files (e.g., PATH entries in ~/.bashrc or ~/.zshrc).
You can override the locations with INSTALL_DIR and CLAWIDE_DATA_DIR:
INSTALL_DIR=/usr/local/bin CLAWIDE_DATA_DIR=/opt/clawide curl -fsSL https://www.clawide.app/uninstall.sh | bash
Next Steps
- Configuration — Customize host, port, projects directory, and more
- Dashboard — Create your first project