Skip to main content
Choose the native installer on supported macOS and Linux computers, or npm on any platform that can run the required Node.js version.

​
Supported installation paths

The native installer does not require Node.js.

​
Native installer requirements

The macOS and Linux installer requires:
  • A writable home directory, or an absolute writable path supplied through CLAWDI_INSTALL_PREFIX.
  • curl, tar, gzip, and awk.
  • Either sha256sum or shasum for release verification.
  • An x64 or arm64 CPU.
Run the installer as the user who will use Clawdi. It rejects a sudo invocation that targets another user.

​
npm requirements

The npm package requires:
  • Node.js 22.5 or newer.
  • npm and permission to write to npm’s global package location.
Confirm the versions before installation:

​
Network access

Installation and normal use require outbound HTTPS access. The installer reads the current package release, downloads exact assets from GitHub Releases, and the CLI opens the Clawdi sign-in flow and connects to the Clawdi service. If a proxy or firewall blocks one of those steps, keep the complete error message but remove URLs containing credentials or private query parameters before sharing it with Support.

​
Agent software

The CLI can be installed without Agent software. To create a Connected Agent, install one of the supported Agent software options before running clawdi setup, or identify an existing installation with clawdi setup --agent <software>.
Last modified on August 2, 2026