Review the system requirements before you
install. The native installer is the shortest path on macOS and Linux;
Windows uses npm.
macOS and Linux
Run the installer as your normal user. Do not run it throughsudo.
~/.local by default. If ~/.local/bin is not on PATH, the installer prints
the path you need to add.
To inspect the installer before running it:
Choose a different prefix
The prefix must be an absolute path that your user can write. The executable goes in<prefix>/bin and versioned files go in <prefix>/share/clawdi.
Windows or npm-managed installation
Install Node.js 22.5 or newer, then use npm:Verify the installation
clawdi, open a new terminal and check the install
directory is on PATH.
Install an exact release
Use an exact version when reproducing an environment or testing an upgrade.- Native
- npm
X.Y.Z with a published semantic version. The native installer
accepts the version without the release tag prefix. Find published versions on GitHub
Releases or npm.