romtuck/openclaw
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge 8bc60421bf into 09be5d45d5

Browse Source
This commit is contained in:
Naveen 2026-01-30 23:54:14 +08:00 committed by GitHub
commit b721a107fe
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
6 changed files with 24 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
README.md
View File

@ -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)

2
docs/help/faq.md
View File

@ -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
```

5
docs/index.md
View File

@ -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

8
docs/install/index.md
View File

@ -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:

10
docs/install/installer.md
View File

@ -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).

6
docs/start/getting-started.md
View File

@ -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