2026年に npm i -g openclaw で入れたのに、ビルドの最後に sharp / libvips や Node の native アドオンで詰まる——これは経路の混在とプレフィックスの揺れがほとんどです。本稿は SHARP_IGNORE_GLOBAL_LIBVIPS、公式 install.sh と install-cli.sh の使い分け、シンガポール・東京・ソウル・香港・米東・米西のMac mini M4で環境を固定し、openclaw doctor 一枚で受け入れる手順を短くまとめます。
1. なぜ npm -g 経路で sharp が落ちるのか
sharp は事前ビルド済バイナリを内蔵しているのが既定で、システム側の libvips を見ないように SHARP_IGNORE_GLOBAL_LIBVIPS=1 を入れるとミスマッチが消えます。社内ミラーやオフライン環境では事前バイナリが取れず、node-gyp から原生コンパイルへ落ちて、Xcode CLT 不足／Homebrew の libvips 版ずれ／Python の不一致で死ぬ典型です。Apple Silicon では arm64 既定なので、arch -x86_64 Rosetta 経由で入れた古い Node を引き当てると一瞬で破綻します。
2. install.sh と install-cli.sh：プレフィックス路線の選び方
OpenClaw 公式の install.sh はサーバー側ランタイム一式（GW・常駐・依存）を再構築する用途で、/usr/local や /opt/openclaw 直下に配置します。install-cli.sh はCLI だけを ~/.openclaw や $PREFIX/bin に置く軽量路線で、開発機やレビュアーに最適。同一 Mac で両方を同居させるとプレフィックスが二重化し、which openclaw と launchd の PATH がズレて「直したのに落ちる」原因になります。詳しくは 常駐機の購入とクラウド Mac の選定 FAQ。
3. ネイティブ依存の最小固定セット
node は22.x の LTSに固定し、nvm／fnm でユーザー全員揃えます。Mac 側は xcode-select --install、Homebrew で vips／pkg-config／cairo／pango を入れ、brew --prefix を確認。CI ではキャッシュキーに node -v と brew list --versions vips を含め、ビルダーを跨いだ「同じはずなのに違う」を排除します。Node 22 とゼロインストール路線 FAQ。
- 環境変数
SHARP_IGNORE_GLOBAL_LIBVIPS=1、再現が必要ならSHARP_FORCE_GLOBAL_LIBVIPS=1を試す。 npm config get prefixがユーザー固有か/usr/localかを把握しておく。launchdの plist にはEnvironmentVariablesで PATH と LANG を明示。
4. openclaw doctor を受入れの一枚に
導入後は openclaw doctor --json をログへ。確認すべきは node version／arch、prefix、sharp バイナリの種類（prebuilt or local build）、libvips バージョン、ゲートウェイ到達性、launchd ステータス。CI では doctor 出力を成果物に保存し、PR レビュー時にアタッチすると、環境ドリフトを差分で見られます。無画面セットアップと初回受入れ FAQ。
5. 六地域に同じ脊髄を載せる
シンガポール・東京・ソウル・香港・米東・米西のMac mini M4に同一インストール脊髄を流し、doctor で受入れてから DNS／Tailscale で公開。RAM／NVMe はビルドキャッシュと node_modules 見込みで 16GB/256GB または 24GB/512GB を選び、長時間ビルドは TB 拡張側へ。地域ごとに1 ホスト 1 路線に統一すれば、sharp の差は再発しません。
vpszap のクラウドなら、この一式が固定しやすい
本稿の install-cli.sh プレフィックス、SHARP_IGNORE_GLOBAL_LIBVIPS、Node 22 と Homebrew の vips を固定する作業は、仮想化なしの物理 M4 Mac miniで最も再現しやすくなります。vpszap は専有 CPU／メモリ／SSDを約5 分で開通し、SSH と VNC 同時提供、日／週／月／四半期課金で長期契約なし。東京で試し、米東に同じ脊髄を流し、香港で並列ビルドを回す——という運用も低レイテンシで組めます。vpszap のクラウド Mac miniから始めると、sharp の謎は環境差ではなく設定差に切り分けられます。