Apple Silicon で openclaw@2026.5.x を固定し、Node 24 を門限にし、curl の install.sh か npm -g の一方、onboard／デーモン、gateway status と doctor、config validate の JSON、tar チェックポイントまでを一列にします。詳細は トークン、validate ゲート。
MacPull 利用者がゲートウェイ安定を気にする理由
MacPull では高頻度 git pull と CI が同一ホストに重なりやすく、ゲートウェイがフラップすると依存プリフェッチや webhook 要約の制御面が同時に揺れます。2026.5.x＋Node 24 と validate＋doctor 連鎖で不確実性を圧縮し、status／doctor CI に続くチェックポイント層が本稿です。
Node 24 門限（2026.5.x ドキュメントに合わせる）
2026.5.x はサポート導入として Node 24 を軸に読み替えます。bootstrap 先頭で node -v、launchd も同じメジャー。OPENCLAW_HOME／OPENCLAW_CONFIG_HOME を隔離し chmod 700。PATH は 導入チェックリスト と同様に絶対パスで揃えます。
導入経路：curl … install.sh か npm グローバル（同時併用禁止）
イメージごとに経路は一つ。二重導入は PATH で二つの openclaw が争います。
| 経路 | 向き | ピン留めの作法 |
|---|---|---|
公式 curl … install.sh |
新規リモート Mac で、公式手順の写し込みを最優先するとき | 導入直後に openclaw --version。表示が 2026.5.x の範囲外ならチケット化 |
npm install -g "openclaw@^2026.5.0" |
社内 npm ミラーと semver 承認表でグローバル bin を統制しているとき | command -v openclaw をビルドログに必ず残し、パスをハッシュ化して保管 |
公式の curl 一行は利用中ビルドの READMEから貼り替え（本ページはログイン不要の相対リンクのみ）。openclaw.json を触る前に openclaw --version が 2026.5.x であること。
オンボードとデーモン
サービスユーザーで openclaw onboard。非対話は CI ゲート HowTo。長寿命ホストのみ --install-daemon。PR ランナーはポート競合回避でデーモン省略可。登録後は再起動し、status／doctor／ヘルスを同じ三連で再確認（SSH と plist の OPENCLAW_CONFIG_HOME を一致）。
gateway status、doctor、「緑」の意味
status は自己申告、doctor は環境監査で代替不可。JSON 出力はピン留め版の --help に従う。スキル反復は skills と doctor。
#!/usr/bin/env bash set -euo pipefail node -v command -v openclaw openclaw --version openclaw gateway status openclaw doctor
config validate：JSON を行動に写す
実際に読む openclaw.json に対し openclaw config validate。JSON フラグ名はピン留めビルドの --helpが一次情報。読み方は三層：（1）全体の成否と終了コード（CI は非ゼロで必ず失敗）、（2）正規化ブロック（安定差分の目印）、（3）issues／invalid-key のJSON ポインタをそのまま設定ファイルの座標に写す。典型例は validate CI ゲート。
- 終了コードでゲートする。
- 通過セクションは diff の安全域として記録。
- issue のパスを
openclaw.jsonで開き、推測で直さない。
openclaw doctor && \
openclaw config validate --config "${OPENCLAW_CONFIG_HOME}/openclaw.json"
MR ごとに stdout／stderr とマスク済み設定を隣接保管。
回復チェックポイント（最小・再現可能）
リスナ等を触る前に日付入り tar（共有先には生秘密を載せない）。
CK="openclaw-checkpoint-$(date -u +%Y%m%dT%H%M%SZ)-${HOSTNAME:-mac}"
tar -czf "${CK}.tgz" -C "${OPENCLAW_CONFIG_HOME}" openclaw.json
shasum -a 256 "${CK}.tgz" | tee "${CK}.tgz.sha256"
四半期リハ：launchctl 停止→tar 復元→必要なら記録パッチへ npm を合わせ→再読込→status／doctor／validate／ヘルスを同順。
長寿命リモート Mac向け・貼り付けスパイン
- Node 24 を示し、
OPENCLAW_HOMEとOPENCLAW_CONFIG_HOMEを export。 - 公式 curl … install.sh または
npm install -g "openclaw@^2026.5.0"のどちらか一方で導入し、openclaw --versionを残す。 openclaw.jsonを.tgzとチェックサムに収める。openclaw onboard、必要ならopenclaw onboard --install-daemon。openclaw gateway status、openclaw doctor、openclaw config validate --config …、認証付きヘルスを&&で連鎖。
FAQ
Node 22 のままよいか。 2026.5.x はNode 24 が中心。残すなら負債として記録。
curl と npm どちらが正か。 どちらも公式。一方に固定。
validate だけで足りるか。 実機ゲートウェイでは doctor 省略非推奨。
トークンは。 認証 HowTo 参照。
まとめと次の一歩（公開ページのみ）
Node 24→一方導入→チェックポイント→onboard／デーモン→status／doctor→validate の背骨で、MacPull 的な高頻度 pull／CI でも戻しを単調化できます。
指標例：semver 上げから doctor／validate／ヘルス再緑までの分と四半期リハ記録。