Deployment Intermediate 20-40 min
OpenClaw 2.0+ へのアップグレード（v2026.8–2026.10 ライン、現行 v2026.10.2）
検証済みバックアップ、バージョン互換性確認、Doctorと復旧手順でOpenClawを更新。非常に古い設定は中間バージョンが必要な場合があり、どの版からも直接更新できるとは限らない。
#アップグレード#OpenClaw 2.0#移行
前提条件
- A running OpenClaw 2026.x install (any channel)
- Terminal access and free disk space
- A verified backup completed before upgrading (step 1)
ステップ
1
現在のバージョンを確認し検証済みバックアップを作成
OpenClaw 2.0は設定を移行するため、まず現在のバージョンを記録し、検証付きの完全な状態復元ポイントを作成します。openclaw updateの自動設定コピーは完全バックアップではありません。
コマンド
Windows / macOS / Linux
openclaw --version Windows / macOS / Linux
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
2
アップグレードをプレビューして実行
openclaw updateはインストール種別（npm/pnpm/Bun/git）を検出し、最新版を取得してdoctorを実行しGatewayを再起動します。まず--dry-runで確認。本番環境はstableチャネルを推奨。
コマンド
Windows / macOS / Linux
openclaw update --dry-run Windows / macOS / Linux
openclaw update ヒント
- v2026.10.2 (Oct 12): the first upgrade from stable v2026.10.1 now completes cleanly, and successful in-place updates no longer end in errors; Windows, cloned-filesystem, and private-Node update paths finish instead of stalling or rolling back. The stable line is now at v2026.10.2; follow current release notes and backup/compatibility checks before upgrading. v2026.9.4 (Sep 11) had introduced compatible failed-update recovery and the Plugins workspace.
- v2026.9.3 (Sep 8): updates are first rehearsed in an isolated candidate state and activated only after checks pass; the Node runtime floor rises to 24.16.0+ (or 26.1.0+) — upgrade Node BEFORE OpenClaw to avoid SQLite text truncation.
- v2026.9.2 (Sep 5): GPT-6 Astra model support (openai/gpt-6-astra via API key or ChatGPT/Codex account); automatic updates preserve settings/skills/default agent; failures come with actionable recovery guidance. Upgrade straight to this version on the 2026.9 line.
- v2026.9.1 (Sep 3, 2026.9-line stable): failed updates now roll back the npm candidate and preserve config and secret references — upgrade safety strengthened; new `openclaw skills library` personal skill libraries with ZIP import; fresh installs get a quick-start lane (auto-detects existing Claude Code/Codex logins). 2.0 users can upgrade across lines directly.
- v2026.8.2 (Sep 1) is the last of the 8.x line: dock the Home agent with Cmd/Ctrl+Shift+H; a Linux .deb/AppImage desktop companion lands.
- Avoid the beta channel on production installs
- Extended-stable 2026.8.35 (Oct 2) is gateway-only, based on end-of-August code plus backported fixes; it is not the full 2026.9 feature set.
- Very old configurations may need an intermediate 2026.9.5 upgrade and Doctor. Version 9.9 cannot downgrade or repair data converted by an October beta; preserve originals first.
3
doctorを実行して2つの移行を完了
OpenClaw 2.0には2つの破壊的変更があります：バンドルのOpenProseプラグインと/proseコマンドの削除、およびcodex/*・openai-codex/*参照のopenai/*への移行（プロバイダー設定・保存セッション・自動化ルート対象）。openclaw doctor --fixが両方を処理し、競合をフラグ表示します。
コマンド
Windows / macOS / Linux
openclaw doctor --fix ヒント
- Gateway startup also auto-runs safe config migrations, but an explicit doctor --fix after upgrade is more reliable
4
Gatewayを再起動して各項目を検証
移行完了後、Gatewayを再起動し、バージョン・ヘルス・プラグイン一覧・詳細プローブがすべて通るか確認します。
コマンド
Windows / macOS / Linux
openclaw gateway restart Windows / macOS / Linux
openclaw health Windows / macOS / Linux
openclaw plugins list --json Windows / macOS / Linux
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
5
後処理：.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
6
プラグイン・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
7
問題時は2層でロールバック
ロールバックは2層：第一層はOpenClawコードのみを戻し状態を保持（まずこちら）。旧コードが移行済み設定やDBを読めない場合のみ、更新前バックアップの状態復元（以降の変更は失われる最終手段）。
コマンド
Windows / macOS / Linux
npm i -g openclaw@2026.7.1 # コードレベルのロールバック例：旧版を再インストールし状態を保持 Windows / macOS / Linux
openclaw gateway restart ヒント
- Restore the backup state only when the old code cannot read the migrated config or database
よくある問題
アップグレード後に一部プロバイダープラグインがない？
OpenClaw 2.0からプロバイダーパッケージ（BytePlus、ComfyUI、Mistral、NovitaAI、OpenCode、Volcengine、Xiaomi等）はオンデマンドインストール。openclaw update repair（またはdoctor）実行後にGatewayを再起動してください。
codex関連のモデルやタスクルートが動かない？
v2026.8.1はcodex/*とopenai-codex/*をopenai/*に全面移行します。まずopenclaw doctor --fixを実行し、フラグされた競合を確認。カスタム設定のcodex/参照はopenai/に手動置換してください。
Androidクライアントはどの版を入れる？
公式注記によるとv2026.8.1のiOS/Androidネイティブ配布は「後日提供」で、以前のAndroidダウンロードは2026.8.1のネイティブ成果物ではありません。AndroidはGoogle Play版を利用するか公式パッケージを待ってください。
Linuxのroot所有グローバルインストール更新でEACCES？
まずGatewayを停止（openclaw gateway stop）し、システムnpmで置換：sudo /usr/bin/npm i -g openclaw@latest、その後 openclaw gateway install --force && openclaw gateway restart。