From 8bc60421bf57ae742ef722703b050c22efc544c3 Mon Sep 17 00:00:00 2001 From: Naveen Chatlapalli Date: Thu, 29 Jan 2026 01:12:21 -0600 Subject: [PATCH] docs: recommend @beta instead of @latest for npm install Update documentation to recommend `npm install -g moltbot@beta` instead of `moltbot@latest` since the @latest tag on npm currently points to v0.1.0 which lacks the `bin` field and CLI binary. This is a workaround until the npm @latest tag is updated to point to the current beta/stable releases. Affected docs: - README.md - docs/index.md - docs/install/index.md - docs/install/installer.md - docs/start/getting-started.md - docs/help/faq.md Fixes #3787 Co-Authored-By: Claude Opus 4.5 --- README.md | 6 ++++-- docs/help/faq.md | 2 +- docs/index.md | 5 +++-- docs/install/index.md | 8 +++++--- docs/install/installer.md | 10 +++++++--- docs/start/getting-started.md | 6 ++++-- 6 files changed, 24 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index 49085c76f..aa38a7749 100644 --- a/README.md +++ b/README.md @@ -45,12 +45,14 @@ Model note: while any model is supported, I strongly recommend **Anthropic Pro/M Runtime: **Node ≥22**. ```bash -npm install -g openclaw@latest -# or: pnpm add -g openclaw@latest +npm install -g openclaw@beta +# or: pnpm add -g openclaw@beta openclaw onboard --install-daemon ``` +> **Note:** Use `@beta` instead of `@latest` until npm `@latest` is updated. The `@latest` tag currently points to an old version (v0.1.0) that lacks the CLI binary. See [#3787](https://github.com/moltbot/moltbot/issues/3787). + The wizard installs the Gateway daemon (launchd/systemd user service) so it stays running. ## Quick start (TL;DR) diff --git a/docs/help/faq.md b/docs/help/faq.md index e960d6a19..bc397fd6e 100644 --- a/docs/help/faq.md +++ b/docs/help/faq.md @@ -813,7 +813,7 @@ openclaw gateway restart From git → npm: ```bash -npm install -g openclaw@latest +npm install -g openclaw@beta # Use @beta until npm @latest is updated openclaw doctor openclaw gateway restart ``` diff --git a/docs/index.md b/docs/index.md index ade5c5e23..ea1b583a1 100644 --- a/docs/index.md +++ b/docs/index.md @@ -111,8 +111,9 @@ Runtime requirement: **Node ≥ 22**. ```bash # Recommended: global install (npm/pnpm) -npm install -g openclaw@latest -# or: pnpm add -g openclaw@latest +npm install -g openclaw@beta +# or: pnpm add -g openclaw@beta +# Note: Use @beta until npm @latest is updated (see issue #3787) # Onboard + install the service (launchd/systemd user service) openclaw onboard --install-daemon diff --git a/docs/install/index.md b/docs/install/index.md index 9ec0cabd1..94500e9a3 100644 --- a/docs/install/index.md +++ b/docs/install/index.md @@ -62,13 +62,15 @@ curl -fsSL https://openclaw.bot/install.sh | bash -s -- --no-onboard If you already have Node: ```bash -npm install -g openclaw@latest +npm install -g openclaw@beta ``` +> **Note:** Use `@beta` instead of `@latest` until npm `@latest` is updated. The `@latest` tag currently points to an old version (v0.1.0) that lacks the CLI binary. + If you have libvips installed globally (common on macOS via Homebrew) and `sharp` fails to install, force prebuilt binaries: ```bash -SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest +SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@beta ``` If you see `sharp: Please add node-gyp to your dependencies`, either install build tooling (macOS: Xcode CLT + `npm install -g node-gyp`) or use the `SHARP_IGNORE_GLOBAL_LIBVIPS=1` workaround above to skip the native build. @@ -76,7 +78,7 @@ If you see `sharp: Please add node-gyp to your dependencies`, either install bui Or: ```bash -pnpm add -g openclaw@latest +pnpm add -g openclaw@beta ``` Then: diff --git a/docs/install/installer.md b/docs/install/installer.md index f838735cf..7d960b358 100644 --- a/docs/install/installer.md +++ b/docs/install/installer.md @@ -30,14 +30,16 @@ If the installer completes but `openclaw` is not found in a new terminal, it’s ## install.sh (recommended) +> **Note:** The installer currently uses `@latest`, but `@latest` points to an old version (v0.1.0) without CLI support. Until the installer is updated, use manual install with `npm install -g moltbot@beta` instead. See [#3787](https://github.com/moltbot/moltbot/issues/3787). + What it does (high level): - Detect OS (macOS / Linux / WSL). - Ensure Node.js **22+** (macOS via Homebrew; Linux via NodeSource). - Choose install method: - - `npm` (default): `npm install -g openclaw@latest` + - `npm` (default): `npm install -g openclaw@beta` (recommended; `@latest` is outdated) - `git`: clone/build a source checkout and install a wrapper script -- On Linux: avoid global npm permission errors by switching npm’s prefix to `~/.npm-global` when needed. +- On Linux: avoid global npm permission errors by switching npm's prefix to `~/.npm-global` when needed. - If upgrading an existing install: runs `openclaw doctor --non-interactive` (best effort). - For git installs: runs `openclaw doctor --non-interactive` after install/update (best effort). - Mitigates `sharp` native install gotchas by defaulting `SHARP_IGNORE_GLOBAL_LIBVIPS=1` (avoids building against system libvips). @@ -83,11 +85,13 @@ curl -fsSL https://openclaw.bot/install-cli.sh | bash -s -- --help ## install.ps1 (Windows PowerShell) +> **Note:** The installer currently uses `@latest`, but `@latest` points to an old version (v0.1.0) without CLI support. Until the installer is updated, use manual install with `npm install -g moltbot@beta` instead. See [#3787](https://github.com/moltbot/moltbot/issues/3787). + What it does (high level): - Ensure Node.js **22+** (winget/Chocolatey/Scoop or manual). - Choose install method: - - `npm` (default): `npm install -g openclaw@latest` + - `npm` (default): `npm install -g openclaw@beta` (recommended; `@latest` is outdated) - `git`: clone/build a source checkout and install a wrapper script - Runs `openclaw doctor --non-interactive` on upgrades and git installs (best effort). diff --git a/docs/start/getting-started.md b/docs/start/getting-started.md index 5102632c4..0dea05afc 100644 --- a/docs/start/getting-started.md +++ b/docs/start/getting-started.md @@ -68,13 +68,15 @@ iwr -useb https://openclaw.ai/install.ps1 | iex Alternative (global install): ```bash -npm install -g openclaw@latest +npm install -g openclaw@beta ``` ```bash -pnpm add -g openclaw@latest +pnpm add -g openclaw@beta ``` +> **Note:** Use `@beta` instead of `@latest` until npm `@latest` is updated. The `@latest` tag currently points to an old version (v0.1.0) that lacks the CLI binary. + ## 2) Run the onboarding wizard (and install the service) ```bash