OpenClaw 2.0 へのアップグレード（v2026.8.x 安定ライン）
任意の2026.xからOpenClaw 2.0へ安全にアップグレード：バックアップ、更新、doctor移行、検証、ロールバック。2つの破壊的変更（OpenProse削除とcodex/*ルート移行）に対応。
前提条件
- A running OpenClaw 2026.x install (any channel)
- Terminal access and free disk space
- A verified backup completed before upgrading (step 1)
ステップ
現在のバージョンを確認し検証済みバックアップを作成
OpenClaw 2.0は設定を移行するため、まず現在のバージョンを記録し、検証付きの完全な状態復元ポイントを作成します。openclaw updateの自動設定コピーは完全バックアップではありません。
コマンド
openclaw --version mkdir -p ~/Backups/openclaw && openclaw backup create --output ~/Backups/openclaw --verify ヒント
- Backup archives may contain credentials and channel state; store them owner-only
- Note the backup point: restoring state later discards changes made after it
アップグレードをプレビューして実行
openclaw updateはインストール種別（npm/pnpm/Bun/git）を検出し、最新版を取得してdoctorを実行しGatewayを再起動します。まず--dry-runで確認。本番環境はstableチャネルを推奨。
コマンド
openclaw update --dry-run openclaw update ヒント
- v2026.8.2 (Sep 1) is the stable line's first update: dock the Home agent with Cmd/Ctrl+Shift+H; a Linux .deb/AppImage desktop companion lands; upgrade protection improved (newer config preserved, incomplete migrations no longer claim success). Upgrading straight to it is recommended.
- For long-lived stability switch to extended-stable: openclaw update --channel extended-stable (long-lived channel with backported fixes)
- Avoid the beta channel on production installs
doctorを実行して2つの移行を完了
OpenClaw 2.0には2つの破壊的変更があります：バンドルのOpenProseプラグインと/proseコマンドの削除、およびcodex/*・openai-codex/*参照のopenai/*への移行（プロバイダー設定・保存セッション・自動化ルート対象）。openclaw doctor --fixが両方を処理し、競合をフラグ表示します。
コマンド
openclaw doctor --fix ヒント
- Gateway startup also auto-runs safe config migrations, but an explicit doctor --fix after upgrade is more reliable
Gatewayを再起動して各項目を検証
移行完了後、Gatewayを再起動し、バージョン・ヘルス・プラグイン一覧・詳細プローブがすべて通るか確認します。
コマンド
openclaw gateway restart openclaw health openclaw plugins list --json openclaw gateway status --deep --json ヒント
- Expect version 2026.8.1; if plugins list is missing BytePlus, Mistral, Volcengine or other provider packages, run openclaw update repair and restart — providers now install on demand in 2.0
後処理：.proseファイルとルート競合
両移行の仕上げ：既存の.proseファイルは保持され、上流のAgent Skill方式で利用します。doctorがフラグしたopenai/*ルートの競合は手動確認が必要です。特にカスタムプロバイダー設定や自動化タスクにハードコードされたcodex/参照。
ヒント
- Search your config and automations for codex/ and openai-codex/ and switch them to openai/
- Smoke-test any Codex-model-routed task before returning it to daily use
プラグイン・SDK開発者：9月1日のゲート
カスタムプラグインを保守している場合、複数のplugin-sdk-*サブパスインポートがopenclaw/plugin-sdk/の集約インポートに統合されます。公式ゲートは2026年9月1日。維持される公開ヘルパーは呼び出し名が不変のため、テスト環境で互換性警告を実行し対象インポートを特定できます。
ヒント
- The official SDK migration guide lists the full subpath mapping — replace them one by one
- Unmigrated plugins will hard-fail on the new runtime after September 1
問題時は2層でロールバック
ロールバックは2層：第一層はOpenClawコードのみを戻し状態を保持（まずこちら）。旧コードが移行済み設定やDBを読めない場合のみ、更新前バックアップの状態復元（以降の変更は失われる最終手段）。
コマンド
npm i -g openclaw@2026.7.1 # コードレベルのロールバック例：旧版を再インストールし状態を保持 openclaw gateway restart ヒント
- Restore the backup state only when the old code cannot read the migrated config or database