openclaw/docs/install
Zakaria Rahali 014ec7d50a
docs(install): npm 12 blocks openclaw install scripts by default (#115224)
The documented `npm install -g openclaw@latest` does not run OpenClaw's
preinstall/postinstall steps on npm 12, which blocks package lifecycle
scripts by default. Nothing in the install docs mentioned this.

Adds a note to the npm tab with the working command. The pnpm tab
already documents its equivalent (`pnpm approve-builds -g`), so npm was
the only tab without one.

Scoped to npm 12 rather than 11.16: `strict-allow-scripts` is undefined
on npm 11.12.1 and false on both 11.16.0 and 12.0.1, and only npm 12
reports the scripts as "blocked because they are not covered by
allowScripts". npm 11.16.x warns that they are "not yet covered" and
still runs them, so the note describes it as warning-only and keeps the
ENOMATCH caveat about the approve-scripts remedy it suggests.

Closes #114665

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
Co-authored-by: Peter Steinberger <steipete@gmail.com>
2026-07-29 03:53:35 -04:00
..
ansible.md docs(install): recommend Node 26 as the OpenClaw runtime (#114399) 2026-07-27 04:32:21 -04:00
azure.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
bun.md docs(install): recommend Node 26 as the OpenClaw runtime (#114399) 2026-07-27 04:32:21 -04:00
clawdock.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
development-channels.md feat(update): notify extended-stable availability (#100438) 2026-07-06 19:57:03 -07:00
digitalocean.md [AI-assisted] docs: recommend Node 26 in quickstart, landing, and platform install docs (#115064) 2026-07-28 12:37:06 -04:00
docker-vm-runtime.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
docker.md docs(browser): correct Docker sandbox setup (#115254) 2026-07-28 23:18:40 +08:00
exe-dev.md chore: migrate active GPT-5.5 references to GPT-5.6 (#104452) 2026-07-11 06:30:57 -07:00
fly.md fix(sqlite): serialize offline maintenance with gateway (#106210) 2026-07-13 18:15:32 +08:00
gcp.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
hetzner.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
hostinger.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
index.md docs(install): npm 12 blocks openclaw install scripts by default (#115224) 2026-07-29 03:53:35 -04:00
installer.md [AI-assisted] docs: recommend Node 26 in quickstart, landing, and platform install docs (#115064) 2026-07-28 12:37:06 -04:00
kubernetes.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
macos-vm.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
migrating-claude.md feat(onboard): stage migration imports before promotion (#112798) 2026-07-23 07:06:01 -04:00
migrating-hermes.md feat(onboard): stage migration imports before promotion (#112798) 2026-07-23 07:06:01 -04:00
migrating.md feat(onboard): stage migration imports before promotion (#112798) 2026-07-23 07:06:01 -04:00
nix.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
node.md docs(install): recommend Node 26 as the OpenClaw runtime (#114399) 2026-07-27 04:32:21 -04:00
northflank.mdx docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
oracle.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
podman.md fix(docker): package selected external plugins in source-built images (#103629) 2026-07-10 13:00:50 +01:00
railway.mdx docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
raspberry-pi.md [AI-assisted] docs: recommend Node 26 in quickstart, landing, and platform install docs (#115064) 2026-07-28 12:37:06 -04:00
render.mdx docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
uninstall.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
updating.md feat(scripts): reference update script for source-checkout gateway servers (#112557) 2026-07-22 07:25:14 +00:00
upstash.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00