update との分岐 · plan / dry-run · JSON 監査 · Gateway 18789
v2026.4.26 は、外部に分散していた「実行の権威」を OpenClaw 側へ正規化する作業を、感覚ではなく差分JSON と dry-runで進められるように整えたリリースラインだ。openclaw migrate は plan で触るパスとプロバイダ面、dry-run で実際に書き換わるキーを事前に曝露し、Claude Code / Claude Desktop に溜まった指示テンプレート、MCP カード、Skill、クレデンシャル周りのヒントを、衝突検知つきでマージする導線も同梱されている。一方でレンタル Mac では OPENCLAW_PLUGIN_DIR を只読イメージ層に向けてしまうと、依存の一部だけが途中で壊れたツリーに見える。症状は「たまに npm が通らない」「plugins list と UI が噛み合わない」といった中間失敗に化けやすい。本稿は換機・組織合併・Claude 側をソース・オブ・トゥルースにしたいオペレータ向けに、(1) update 単体で足りる境界 (2) migrate を選ぶ境界 (3) 八段の実運用ランブック (4) 変更管理へ貼れる四つの結論文 (5) SSH では覆いきれない VNC 上の Gateway・権限・ブラウザ検証表 を並べ、公式 Docker/Compose、launchd とデーモン、典型エラー十の手当、4.25 冷永続プラグインレジストリ と本文中で突合できるよう実スラッグだけを使う。歴史的対比として 3.x 時代の設定移行ガイド も参照し、4.26 が「五項目を手で写す」から「機械可読なマージ計画」へ寄せた点をはっきり区別してほしい。
誤った選択は工数ではなく信用を失う。patch リリースを追うだけなら openclaw update と openclaw doctor で十分なことが多い。問題は「二台のラップトップとオブジェクトストレージに設定の正規版が三分岐している」状態で update だけを走らせるパターンだ。update は単一系譜の鮮度を上げる。migrate は構造と権威の合流を扱う。混同すると Gateway のポートマップ、相対パス、state ディレクトリのエイリアスが黒盒化し、後から plugins repair を何度叩いても根本原因が残る。
同機・パッチ・外部インポートなし：update 優先。version が上がったからといって migrate を儀式のように回さない。
新ノードへ載せ替え：手で JSON を丸ごとscpする前に migrate plan でパス写像とポートを正規化する。
Claude ワークスペースに Skill/MCP の一覧がある：4.26 の合併インポートで監査可能な差分を残す。Slack に貼ったプロンプトを週替わりの正規版にしない。
プラグイン依存が EROFS 系で止まる：OPENCLAW_PLUGIN_DIR の向き先と書き込み権を migrate のチェックリストに含め、update を半端な木の上で繰り返さない。
Compose と裸機の二重起動：Docker 稿 でボリュームとループバックを読み、18789 を二重宣言しない。
launchd ラップ：ツリー変更後は launchd 稿 のとおり、plist の EnvironmentVariables が対話ユーザーと矛盾していないか再確認する。
オペレーションが速いチームほど、最初の分類を誤らない。下表は「まず何を疑うか」と「やってはいけない回避策」を明示する。混合 Gateway は 4.25 の repair フローとセットで読む。
| 見え方 | 第一動 | 次の手 | 避ける |
|---|---|---|---|
| パッケージ期限切れ通知だけ | update + doctor | キャッシュ/権限 | 全ツリー migrate |
| 新ホストでパスが全部変わる | migrate plan + JSON | secrets の差分レビュー | JSON 手書きコピーを正とする |
| Canonical が Claude 側 | 4.26 合併 + dry-run | チケットではマスクして貼る | 二重帳簿の恒久化 |
| インストールが只読で落ちる | 可写ルートの設計 | plugins repair | chmod 777 儀式 |
| 升級後に新旧混在 Gateway | バイナリと registry 整合 | 4.25 稿 | 再起動だけでごまかす |
各段は変更チケットの見出しにそのまま貼れる。レンタル Mac では、Gateway を動かす対話ユーザーと同一の VNC セッションを確保し、ブラウザ同意やセキュリティダイアログを SSH のログではなく画面で完了させる。18789 はローカルループかリバースプロキシ経由かを事前に固定し、dry-run JSON の listener 記述と突き合わせる。
指紋：openclaw --version、フル openclaw doctor、stable/beta、コンテナか裸機かを記録する。
バックアップ：リリースノート推奨の claw backup に加え、クラウドならデータボリュームのスナップショットも取得する。
Plan：migrate の plan 系サブコマンドで触るパス、プラグイン面、secrets 面を列挙させる。
Dry-run / JSON：追加キー、canonical へ寄せる別名、人間の二択が要る項目を色分けする。
Claude 合流レビュー：指示ファイル・MCP・Skill をマスクしたうえで OpenClaw 側の真値と突き合わせ、Wiki にどちらを正とするかを書く。
可写根と OPENCLAW_PLUGIN_DIR：依存の実インストール先を確定し、openclaw plugins repair と plugins doctor で 4.25 以降のレジストリ記述と整合させる。
Gateway：18789 のヘルス、WebSocket の安定性、典型エラー十の手当 の分岐表と照合する。
変更票の固定：dry-run と apply の差、ロールバック手順、Docker/launchd オーナーへの依存を一文ずつ残す。
openclaw --version && openclaw doctor claw backup openclaw migrate <plan | dry-run は製品ドキュメントの名称に従う> # JSON をレビューしてから apply / Claude 合流 openclaw plugins repair && openclaw plugins list openclaw status
OPENCLAW_PLUGIN_DIR 周りの失敗は可写性クラスとして分類し、ネットワーク一時障害としては扱わない。以下は「グラフィカルにしか成立しない確認」を切り出したものだ。共有ホストではスリープやディスプレイ省电と plist の期待が衝突しやすい点に注意する。
| 項目 | VNC で実施 | 合格ライン |
|---|---|---|
| ループバック / 逆プロキシ | 開発者ツールで Network と WS を観察 | 401 の連鎖なし、WS がフラップしない |
| システム権限 | 自動化ブラウザやローカルブリッジに関わる同意 | 同一ユーザーでダイアログ終結 |
| 睡眠 / 電源 | 長時間ジョブ前提の节点で方針確認 | launchd 記述と一致 |
| プラグイン UI | GUI の一覧と照合 | CLI plugins list と一致 |
ボリューム、ループバック、コンテナ検証と裸機比較。
読む →ツリー変更後の環境変数と常駐の整合。
読む →repair 週課と混合 Gateway の切り分け。
読む →通常は不要。節01のとおり単一系譜なら update。換機と外部一括取り込みが絡むなら plan / dry-run。
まず実ボリュームの書き込み可否。次に plugins repair。4.25 稿と背中合わせ。
CLI と JSON のみなら可。節05の同意・UI は VNC 側で閉じる。
4.26 で大きく合流し、4.25 で定常の repair と版整合を回す。
migrate は「 tarball を置いた気分」ではなく差分が証明できる操作に変えた。しかし只読レイヤ、睡眠ポリシー、SSH と対話ユーザーの不一致といった環境負債を残したままでは、失敗は再び「誰かが最後のダイアログを押し忘れた」という形で戻ってくる。自前物理機は資本と待機電力と OS の夜間パッチを引き受ける契約だ。チームが本当に守りたいのがマージの監査境界なら、SSH とレビュー可能な GUI を両方持つ Apple Silicon のレンタル Mac に運用の地殻を寄せる選択も現実的だ。
本稿の八段を同一セッションで踏みたい場合は VNCMac でノードを選び、購入ページ からプランを確認したうえで トップ の仕様とも照合してほしい。OpenClaw 関連の多言語稿は相互にリンクしてフォルダとして読むと、upgrade・migrate・定常健診の境界が一気にクリアになる。