2026 年、OpenClaw の本番障害はコンパイルより同名二重バイナリ、launchd の旧パス残り、六都市ゲートウェイの昇格順ミスが多いです。openclaw updateとinstall.sh再実行の使い分け、npm -g とソース木の整理、ロールバック四点、openclaw healthで灰度を切る要点を短くまとめます。
1. update と install.sh
役割ごとチャネル一つ。端末は doctor 後に prefix でopenclaw update。常駐はタグ付きinstall.shでレイアウト再取得しデーモン用ユーザーで doctor。npm と clone 同居はログイン／SSH で--version不一致の元。
2. npm とソース木
PATH 順序が主因。Homebrew・npm bin・target/release競合で未知フラグ、MODULE_NOT_FOUND、スキーマ不一致。種別ごとにnpm かソース片方、サービス PATH 浄化、GW 用 OS ユーザー単一。
3. ロールバック四点セット
事前に保存：タグまたは npm 版、plist／Compose 実体、設定 tarball、旧 health。戻しは新停止→plist→旧バイナリ→設定→旧起動→health 比較。認証のみ不調ならシェル差を疑う。地域ごと日付ログ、カナリア health 二回成功まで DNS 凍結、NVMe とopenclaw.json部分編集禁止をセットで。
4. openclaw health を受入れゲートに
本昇格前にビルド ID・RTT・ディスク／launchd。同一ユーザーで health を二回一致させる。マスク済み出力を変更票へ。 基準線とスモークゲート FAQ。
5. 六都市の灰度と段階昇格
都市ごとカナリア→少量→health→DNS／Tailscale。出口で地域差。バイナリとモデル設定は片方ずつ。六都市の目安は 六都市クラウド Mac コスト FAQ 。
vpszap のクラウドなら、アップグレードも再現しやすい
vpszap は仮想化なしの物理 M4 Mac miniを専有提供し、CPU・メモリ・SSD を独占、約5 分でSSH と VNC、日／週／月／四半期課金・長期契約なし。多地域は東京で試して米東本番のリハーサルにも使えます。クラウド Mac miniでユーザーと Runner に近いリージョンから。
