OpenClaw コマンドラインアップグレードとゲートウェイトラブルシュートの概念図

2026年 OpenClaw openclaw update 後の「ゲートウェイ未起動／channels 空／モデル 401」：update status、Update restart 保留と plugin load failed 段階修復マトリックス

openclaw update 直後にゲートウェイが起動せず channels が空、モデルが 401 を返す——週次マイナー更新現場の典型です。公式 After an update では update status と Update restart handoff を先に確認し、プラグイン依存ツリーと OAuth シャドウを処理します。本稿は 15 分コマンド段階、決定マトリックス、v2026.5.20 の複数 Node 注意点を示します。

1. 四層切り分け：split brain・無返信 channels との境界

誤った層で gateway restart を繰り返さないでください。L0：status --all の Update restart pending/failed＝handoff 問題。L1：Runtime: stopped→《macOS gateway restart》《Linux systemd HOME》。L2：plugin load failed→§5；probe 緑で無返信→《channels 無返信》。L3：401→doctor --fix、《credentials》；旧 CLI がサービス拒否→《split brain》。日常段階は《公式ラダー》。

2. 三つの高頻度論点

論点一：channels 空≠ネットワーク。 plugin load failed: dependency tree corrupted では設定は残るがプラグイン登録がロード前に失敗します。

論点二：handoff 保留中の設定変更。 未完了時の openclaw.json 編集は Invalid config の原因。status の次コマンドを先に。

論点三：401 で全 Key ローテーション。 期限切れ per-agent OAuth shadow は doctor --fix で削除します。

3. 表象→最初の証拠 決定マトリックス

表象 最初の証拠 層 次の一手
update 後コマンド遅延 Update restart pending L0 update status --json
channels 空 plugin load failed L2 doctor --fix → restart
一部 agent 401 shadow 警告 L3 doctor --fix
restart 拒否 lastTouchedVersion が新しい split brain PATH 整合
メモリ上昇 大きな .jsonl セッション 《本番ログ脱敏》

4. 公式アップグレード後コマンド段階（15 分）

  1. nginx・token・プラグインの並行変更を凍結。
  2. openclaw status --all で Update restart を記録。
  3. openclaw update status --json で pending/failed を保存。
  4. openclaw gateway status --deep で cli/service Config を照合。
  5. openclaw doctor --fix を実行。
  6. openclaw gateway restart；失敗時 install --force。
  7. openclaw channels status --probe で検証。
openclaw status --all
openclaw update status --json
openclaw gateway status --deep
openclaw doctor --fix
openclaw gateway restart
openclaw channels status --probe

5. Update restart、プラグインツリー、401、複数 Node

Update restart：pending＝引き渡し未完；failed は次コマンド付き。即二度目 update は避け stable/beta と tag を確認。health WS が 10 秒超なら《v2026.4.26 回帰》参照。

plugin corrupted：doctor --fix を使い node_modules 盲削除は不可。 messenger 1 本の A/B が有効です。

401：一部 agent→OAuth shadow；全体→credentials と systemd EnvironmentFile。v2026.5.20 以降 update は Node を静かに切替えない想定ですが、サービスユニットに Node 絶対パスを明記してください。

6. 定量指標

  • handoff < 5 分；probe 全緑 < 120 秒。
  • ロールバック tag を 72 時間保持；設定 diff < 50 行。

7. FAQ とまとめ

Q：update status を省略？ 非推奨です。handoff 未完の restart は失敗しやすい。Q：split brain との関係？ 先に PATH を揃え、本稿段階を続けてください。

openclaw update は新版本のインストールまで。可用性は handoff・プラグインツリー・Node・OAuth の整合に依存します。ノート PC のスリープや WSL、低スペック VPS は失敗率を上げます。開発 PC 兼ゲートウェイは 7×24 に不向き。常時オンライン macOS リモートノード＋launchd＋SFTP/rsync スナップショットで「15 分段階」を再現可能に。SFTPMAC の Apple Silicon ホスティングは《公式ラダー》《split brain》《gateway restart》《本番ログ脱敏》と連なる 2026 高頻度更新向け運用基盤です。