[Bug]: Can't install on my mac.

[Minessential]

Bug type

Behavior bug (incorrect output/state without crash)

Summary

i just run the install command, it install faild.

and this is my installation environment:
· Active Node.js: v24.14.0 (/Users/mine/.nvm/versions/node/v24.14.0/bin/node)
· Active npm: 11.9.0 (/Users/mine/.nvm/versions/node/v24.14.0/bin/npm)
· mac OS 26.3

Steps to reproduce

1. open zsh
2. run curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

Expected behavior

Successfully installed

Actual behavior

 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED  Failed to prepare git-hosted package fetched from "https://codeload.github.com/tloncorp/api-beta/tar.gz/7eede1c1a756977b09f96aa14a92e2b06318ae87": The git-hosted package "@tloncorp/api@0.0.2" needs to execute build scripts but is not in the "onlyBuiltDependencies" allowlist.

Add the package to "onlyBuiltDependencies" in your project's pnpm-workspace.yaml to allow it to run scripts. For example:
onlyBuiltDependencies:

• "@tloncorp/api"

OpenClaw version

2026.2.22

Operating system

mac OS 26.3

Install method

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

Logs, screenshots, and evidence

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

  🦞 OpenClaw Installer
  Your messages, your servers, Meta's tears.

✓ Detected: macos

Install plan
OS: macos
Install method: git
Requested version: latest
Git directory: /Users/mine/openclaw
Git update: 1

[1/3] Preparing environment
✓ Homebrew already installed
✓ Node.js v24.14.0 found
· Active Node.js: v24.14.0 (/Users/mine/.nvm/versions/node/v24.14.0/bin/node)
· Active npm: 11.9.0 (/Users/mine/.nvm/versions/node/v24.14.0/bin/npm)

[2/3] Installing OpenClaw
· Installing OpenClaw from git checkout: /Users/mine/openclaw
✓ Git already installed
✓ pnpm ready (pnpm)
✗ Installing dependencies failed — re-run with --verbose for details
Scope: all 37 workspace projects
Lockfile is up to date, resolution step is skipped
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +1092
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 WARN  GET https://registry.npmjs.org/ajv/-/ajv-8.18.0.tgz error (ECONNRESET). Will retry in 10 seconds. 2 retries left.
Progress: resolved 1092, reused 954, downloaded 0, added 235
Progress: resolved 1092, reused 954, downloaded 9, added 477
Progress: resolved 1092, reused 954, downloaded 15, added 861
Progress: resolved 1092, reused 954, downloaded 18, added 972
 WARN  Tarball download average speed 33 KiB/s (size 69 KiB) is below 50 KiB/s: https://registry.npmjs.org/jose/-/jose-4.15.9.tgz (GET)
Progress: resolved 1092, reused 954, downloaded 20, added 974
 WARN  Tarball download average speed 45 KiB/s (size 115 KiB) is below 50 KiB/s: https://registry.npmjs.org/@urbit/nockjs/-/nockjs-1.6.0.tgz (GET)
Packages are cloned from the content-addressable store to the virtual store.
  Content-addressable store is at: /Users/mine/Library/pnpm/store/v10
  Virtual store is at:             node_modules/.pnpm
 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED  Failed to prepare git-hosted package fetched from "https://codeload.github.com/tloncorp/api-beta/tar.gz/7eede1c1a756977b09f96aa14a92e2b06318ae87": The git-hosted package "@tloncorp/api@0.0.2" needs to execute build scripts but is not in the "onlyBuiltDependencies" allowlist.

Add the package to "onlyBuiltDependencies" in your project's pnpm-workspace.yaml to allow it to run scripts. For example:
onlyBuiltDependencies:
  - "@tloncorp/api"

Impact and severity

No response

Additional information

No response

[newcodebook]

Thanks — that error is coming from pnpm’s build-scripts allowlist when you install from a git checkout. @tloncorp/api@0.0.2 is a git-hosted dependency that needs to run a prepare script, but it isn’t in the repo’s onlyBuiltDependencies allowlist, so pnpm install stops.

Two practical ways forward:

1. If you just want a working install (recommended): re-run the installer using the npm package (not a git checkout):

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm

2. If you specifically need --install-method git: in your ~/openclaw checkout, add @tloncorp/api to onlyBuiltDependencies in pnpm-workspace.yaml, then re-run install:

onlyBuiltDependencies:
  - "@tloncorp/api"

Also: you’re on Node v24 via nvm; if you keep hitting install friction, try Node v22 LTS for now:

nvm install 22
nvm use 22

If it still fails after that, can you paste the output of pnpm -v and re-run the installer with --verbose and share the first error block?

Recommended reading:

• https://coclaw.com/getting-started/macos
• https://coclaw.com/getting-started

[Jah-yee]

This fixes the pnpm installation error on macOS by adding @tloncorp/api
to the onlyBuiltDependencies allowlist.

The git-hosted package @tloncorp/api@0.0.2 needs to execute build
scripts but was not in the allowlist.

[steipete]

Maintainer triage (2026-03-03):

• Rechecked on current main from a clean clone + fresh pnpm store.
• Could not reproduce ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED with git install flow.
• @tloncorp/api prepare/build runs during install in current state.

What this means:

• This report looks stale/outdated vs current main.

If you still hit this on latest installer + latest main, please reopen with:

1. pnpm -v
2. full first error block
3. output of git rev-parse HEAD from your checkout

Safety note:

• Use only official docs/installer links (openclaw.ai, docs.openclaw.ai).

[pointmax]

it didn't work for me with the latest pnpm version 10.30.0, by running corepack use pnpm@10.30.0 i managed to get the local install working again.
Adding @tloncorp/api to onlyBuiltDependencies in pnpm-workspace.yaml did not fix the issue for me

[Avan0203]

me too, I still stay in pnpm install

[HeytalePazguato]

@steipete the issue is still present, I pulled just a few minutes ago, then I had to add @tloncorp/api to the onlyBuiltDependencies but even with the workaround it still fails, and it is not only in Mac, I am running in Ubuntu

 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED  Failed to prepare git-hosted package fetched from "https://codeload.github.com/tloncorp/api-beta/tar.gz/7eede1c1a756977b09f96aa14a92e2b06318ae87": The git-hosted package "@tloncorp/api@0.0.2" needs to execute build scripts but is not in the "onlyBuiltDependencies" allowlist.

Add the package to "onlyBuiltDependencies" in your project's pnpm-workspace.yaml to allow it to run scripts. For example:
onlyBuiltDependencies:
  - "@tloncorp/api"

[slashpablo]

Upgrading pnpm did the trick for me. pnpm update pnpm