Skip to Content
👋 Welcome to HowToUseMoltbot Quick Start
InstallationOverview

Install Moltbot

Use the installer. Unless you’ve got a reason not to—in which case we’ve got npm, Docker, Nix, and more below.

Quick install

Mac / Linux:

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

Windows (PowerShell):

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

That’s it. The script drops in the CLI and kicks off onboarding. If you skip onboarding now, run this later:

moltbot onboard --install-daemon

What you need

  • Node.js 22+ — Only hard requirement. The installer can install it for you (Homebrew on macOS, NodeSource on Linux).
  • macOS, Linux, or Windows (WSL2) — Native Windows is untested; WSL2 is the way.
  • pnpm — Only if you’re building from source.

Install paths

Global npm install + optional onboarding in one go:

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

See all flags:

curl -fsSL https://molt.bot/install.sh | bash -s -- --help

Skip the wizard (CI / scripted installs):

curl -fsSL https://molt.bot/install.sh | bash -s -- --no-onboard

Details: Installer internals.

2) Global install (manual)

Already have Node 22+?

npm install -g moltbot@latest

If sharp blows up (e.g. you have libvips from Homebrew), force prebuilt binaries:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g moltbot@latest

Or with pnpm:

pnpm add -g moltbot@latest

Then run the wizard yourself:

moltbot onboard --install-daemon

3) From source (contributors / dev)

git clone https://github.com/moltbot/moltbot.git
cd moltbot
pnpm install
pnpm ui:build
pnpm build
moltbot onboard --install-daemon

No global install? Use pnpm moltbot ... from the repo.

4) Other options

  • Docker — Docker (containerized gateway or sandbox)
  • Nix — Nix
  • Ansible — Ansible
  • Bun (CLI only) — Bun

After install

  • Onboarding: moltbot onboard --install-daemon
  • Sanity check: moltbot doctor
  • Gateway health: moltbot status and moltbot gateway probe
  • Dashboard: moltbot dashboard → http://127.0.0.1:18789/

Install method: npm vs git (installer)

The installer can do two things:

  • npm (default) — npm install -g moltbot@latest
  • git — Clone the repo, build, and run from a checkout (handy if you’re already in the repo)

Flags:

  • --install-method npm|git
  • --git-dir <path> (default: ~/moltbot)
  • --no-git-update — Don’t pull when using an existing checkout
  • --no-prompt — No prompts (for CI)
  • --dry-run — Print what would happen, change nothing
  • --no-onboard — Skip onboarding

Same via env: CLAWDBOT_INSTALL_METHOD, CLAWDBOT_GIT_DIR, CLAWDBOT_NO_PROMPT, CLAWDBOT_DRY_RUN, CLAWDBOT_NO_ONBOARD, SHARP_IGNORE_GLOBAL_LIBVIPS.

Troubleshooting: moltbot not found (PATH)

Your shell can’t see global npm bins. Quick check:

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

If $(npm prefix -g)/bin (macOS/Linux) isn’t in PATH, add it. Example for zsh/bash:

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

Stick that in ~/.zshrc or ~/.bashrc, then open a new terminal (or rehash / hash -r). On Windows, add the output of npm prefix -g (and its \bin) to your PATH.

Update / uninstall

Last updated on:
FlyInstaller