Install

Scope

This page helps you pick an install path for the moltbot CLI and get to a working, always-on Gateway.

Quick install (recommended)

macOS / Linux:

curl -fsSL https://clawd.bot/install.sh | bash

Windows (PowerShell):

iwr -useb https://clawd.bot/install.ps1 | iex

Next step (if you skipped onboarding):

moltbot onboard --install-daemon

Requirements

• Node.js 22+
• macOS, Linux, or Windows via WSL2
• pnpm only if you build from source

Choose an install method

1. Installer script (recommended): sets up the CLI and runs onboarding.
   Details: /en/docs/install/installer/

2. Global install (manual): if you already manage Node/npm yourself.
   Details: /en/docs/install/node/

3. From source (contributors/dev): clone, build, run from a checkout.
   Details: /en/docs/install/development-channels/

4. Other options: Docker / Nix / Ansible / Bun (CLI-only).
   Start here: /en/docs/install/docker/

After install (verify)

moltbot status
moltbot health
moltbot dashboard

Common troubleshooting

moltbot: command not found

Check where global npm installs go:

node -v
npm -v
npm prefix -g
echo "$PATH"

If the global npm bin directory isn’t in PATH, add it (macOS/Linux):

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

sharp install failures

If you have a system libvips (common on macOS) and sharp fails to build, forcing prebuilt binaries often helps:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g moltbot@latest

Update / uninstall

• Updating: /en/docs/install/updating/
• Uninstall: /en/docs/install/uninstall/

Further reading

• Source path: install/index.md