bot/docs/install/index.md

summary, read_when, title

summary	read_when	title
Install Hanzo Bot — installer script, npm/pnpm, from source, Docker, and more	You need an install method other than the Getting Started quickstart You want to deploy to a cloud platform You need to update, migrate, or uninstall	Install

Install

Recommended: installer script

The fastest way to install. It detects your OS, installs Node if needed, installs Hanzo Bot, and launches onboarding.

```bash curl -fsSL https://hanzo.bot/install.sh | bash ``` ```powershell iwr -useb https://hanzo.bot/install.ps1 | iex ```

To install without running onboarding:

```bash curl -fsSL https://hanzo.bot/install.sh | bash -s -- --no-onboard ``` ```powershell & ([scriptblock]::Create((iwr -useb https://hanzo.bot/install.ps1))) -NoOnboard ```

For all flags and CI/automation options, see Installer internals.

System requirements

• Node 24 (recommended) or Node 22.16+ — the installer script handles this automatically
• macOS, Linux, or Windows — both native Windows and WSL2 are supported; WSL2 is more stable. See Windows.
• pnpm is only needed if you build from source

Alternative install methods

npm or pnpm

If you already manage Node yourself:

```bash npm install -g @hanzo/bot@latest hanzo-bot onboard --install-daemon ``` ```bash pnpm add -g openclaw@latest pnpm approve-builds -g hanzo-bot onboard --install-daemon ```

<Note>
pnpm requires explicit approval for packages with build scripts. Run `pnpm approve-builds -g` after the first install.
</Note>

If `sharp` fails due to a globally installed libvips:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g @hanzo/bot@latest

From source

For contributors or anyone who wants to run from a local checkout:

git clone https://github.com/hanzoai/bot.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon

Or skip the link and use pnpm hanzo-bot ... from inside the repo. See Setup for full development workflows.

Install from GitHub main

npm install -g github:hanzoai/bot#main

Containers and package managers

Containerized or headless deployments. Rootless container alternative to Docker. Declarative install via Nix flake. Automated fleet provisioning. CLI-only usage via the Bun runtime.

Verify the install

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw gateway status # verify the Gateway is running

Hosting and deployment

Deploy Hanzo Bot on a cloud server or VPS:

Any Linux VPS Shared Docker steps K8s Fly.io Hetzner Google Cloud Azure Railway Render Northflank

Update, migrate, or uninstall

Keep Hanzo Bot up to date. Move to a new machine. Remove Hanzo Bot completely.

Troubleshooting: openclaw not found

If the install succeeded but openclaw is not found in your terminal:

node -v           # Node installed?
npm prefix -g     # Where are global packages?
echo "$PATH"      # Is the global bin dir in PATH?

If $(npm prefix -g)/bin is not in your $PATH, add it to your shell startup file (~/.zshrc or ~/.bashrc):

export PATH="$(npm prefix -g)/bin:$PATH"

Then open a new terminal. See Node setup for more details.