Docs
Install

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: /docs/install/installer/

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

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

  4. Other options: Docker / Nix / Ansible / Bun (CLI-only).
    Start here: /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: /docs/install/updating/
  • Uninstall: /docs/install/uninstall/

Further reading

  • Source path: install/index.md