Browse the docs

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.txt and stop without installing if it doesn’t match or can’t be checked (set CLAWIDE_SKIP_VERIFY=1, as in curl -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:

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.

  1. Open PowerShell as administrator and install WSL2. This installs Ubuntu by default:

    wsl --install
    
  2. Reboot when prompted, then open Ubuntu from the Start menu and create your Linux user.

  3. Inside Ubuntu, install tmux:

    sudo apt update && sudo apt install tmux
    
  4. Still inside the WSL shell, run the same install command:

    curl -fsSL https://www.clawide.app/install.sh | bash
    
  5. Run 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