OpenClaw 2.0（バージョンv2026.8.1）が2026年8月30日に発表され、翌8月31日に各メディアで報じられました。公表値では933名のコントリビューター（うち569名が初参加）と16,000件を超えるマージ済みプルリクエストが、約7週間という短い開発サイクルの中で積み上げられたとされています。数字の大きさに目を奪われがちですが、本番環境でOpenClawを運用している立場からすると、本当に気になるのは「自分の環境は無事に上がるのか」という一点に尽きるはずです。

先に結論を述べます。今回の破壊的変更は3点だけで、そのうち2点は openclaw doctor --fix による自動マイグレーションでカバーされます。残る1点もプラグイン開発者向けの話であり、プラグインを使うだけの利用者に実質的な影響はありません。本記事では、検証可能なバックアップの取得から3つの破壊的変更の影響範囲、実際の移行手順、そして移行後の動作確認までを、本番運用者の視点で順を追って整理します。

まず押さえるOpenClaw 2.0の全体像と移行の基本姿勢

大型アップデートと聞くと身構えてしまいますが、OpenClaw 2.0で公式に「破壊的変更」と明記されているのは3点のみです。それ以外の膨大な変更は、後方互換性を保ったまま取り込まれています。とりわけ運用者にとって安心材料になるのが、SKILL.mdのフォーマットが変更されていない点です。1.x向けに作成したスキルは、無変更のまま2.0上でそのまま動作します。手元のスキル資産を作り直す必要はありません。

移行の基本姿勢はシンプルに保ちます。いきなり本番のGatewayを上げるのではなく、検証可能なバックアップを取り、通常のアップデートを実行し、openclaw doctor --fix でマイグレーションを適用し、最後にGatewayを再起動する、という順序を崩さないことが肝心です。この4ステップを守るだけで、想定内の変更を想定内のまま完了させられます。以降の章では、各ステップの中身を具体的に掘り下げます。

アップグレード前に必ず取る検証可能なバックアップ

移行で最初にやるべきは、後から確実に戻せる状態を作っておくことです。OpenClaw 2.0では設定と状態のバックアップに openclaw backup sqlite が用意されており、単なるファイルコピーではなく検証可能なスナップショットを作成できます。稼働中のデータベースをそのまま cp で複製すると、書き込みの途中状態を巻き込んでコピーが壊れる恐れがありますが、専用コマンドはその問題を避けて安全にスナップショットを取得します。

openclaw backup sqlite
openclaw backup sqlite verify <snapshot-dir>

verify サブコマンドは、取得したスナップショットをプライベートな作業領域へ復元したうえで、SHA-256によるハッシュ照合、SQLiteのintegrity_check、foreign_key_check、スキーマバージョンの確認までを通します。ここまで通れば、そのバックアップは「壊れていないことを検証済み」と言える状態になります。移行前に必ずこの検証を済ませ、スナップショットの保存場所を控えておきましょう。何かあっても戻れるという安心感が、この後の作業を落ち着いて進める土台になります。

3つの破壊的変更とその影響範囲を理解する

破壊的変更は3点だけですが、それぞれ影響の当たり方が異なります。自分の環境がどれに該当するのかを先に見極めておくと、移行後の確認作業が驚くほど楽になります。ここでは順に整理します。

OpenProseプラグインの廃止

バンドルされていたOpenProseプラグインと /prose コマンドが削除されました。ただし影響範囲は限定的です。すでに作成済みの .prose ファイルそのものは削除されず、内容も失われません。設定に残ったOpenProse関連の記述は openclaw doctor --fix が自動でクリーンアップします。プロンプト生成の機能を引き続き使いたい場合は、アップストリームプロジェクトがAgent Skillへの移行方法をドキュメント化しているので、そちらへ乗り換える形になります。

OpenAIルートの統一

これまで codex/* および openai-codex/* の配下で参照していたモデルが、openai/* へと統一されました。影響が及ぶのはモデル参照だけではありません。プロバイダー設定、保存済みのセッション、そして自動化（automations）に書かれたモデル参照も対象に含まれます。ここも openclaw doctor --fix が古い参照を新しい表記へ自動で書き換えてくれるため、手作業で全設定を洗い出す必要はありません。もし新旧の参照が衝突するようなケースがあれば、運用者が確認して直せるようフラグが立ちます。

プラグインSDKサブパスの非推奨化

外部プラグインの開発者に関係するのがこの変更です。5つのレガシーなサブパスインポートが非推奨となり、フォーカスされた openclaw/plugin-sdk のエントリーポイントへ、2026年9月1日までに移行する必要があります。ここで押さえておきたいのは、プラグインを使うだけの利用者には実質的な影響がないという点です。利用者側は、プラグインの作者が更新を出すまで、これまでどおり使い続けられます。自分でプラグインを配布している場合にのみ、インポート経路の見直しが必要になります。

SQLite移行がもたらすダウングレード時の注意点

2.0ではセッションとトランスクリプトの保存先がSQLiteへ移行しました。通常のアップグレードでは意識する必要はありませんが、もし旧来のファイルベースのリリースへ戻す判断をする場合は注意が必要です。ダウングレードの前に、現行CLIでアーカイブしておいたレガシートランスクリプトの成果物を、先に復元しておく必要があります。

理由は保存形式の違いにあります。2.0へ移行した後に作成された新しいセッションは、SQLite側に保存されているため、ファイルベースの旧リリースからは表示されません。つまり、何も準備せずに巻き戻すと、移行後の会話履歴が見えなくなってしまいます。ダウングレードを選択肢として残しておくなら、レガシー成果物のアーカイブと復元手順をあらかじめ確認しておくと安全です。この点だけは doctor --fix の守備範囲外なので、運用者が意識して押さえておきましょう。

バックアップからGateway再起動までの移行手順

ここまでの内容を、実際に手を動かす順序へ落とし込みます。全体は4ステップで、上から順に実行するだけです。焦らず1ステップずつ結果を確認しながら進めてください。

openclaw backup sqlite
openclaw backup sqlite verify <snapshot-dir>
# 通常の手順でOpenClaw本体を2.0へアップデートする
openclaw doctor --fix
# Gatewayを再起動して新しい構成を読み込ませる

最初に openclaw backup sqlite で検証可能なスナップショットを取得し、verify で健全性を確認します。次に通常のアップデートを実行して本体を2.0へ上げます。続く openclaw doctor --fix が今回の要で、OpenProse関連設定のクリーンアップと codex/* から openai/* への参照書き換えを、設定とセッションと自動化にまたがってまとめて適用します。最後にGatewayを再起動して、新しい構成を読み込ませれば移行は完了です。

途中で doctor --fix が何らかの警告やフラグを出した場合は、その内容を確認してから次へ進みます。多くは自動で解決しますが、新旧参照の衝突など人の判断が要る箇所だけは、メッセージに従って手当てすれば十分です。

移行後に確認したい動作チェックリスト

Gatewayを再起動したら、移行が期待どおりに反映されたかを確認します。次の観点を上から順にチェックしていくと、見落としを防げます。

• バージョンが v2026.8.1 になっていることをCLIで確認する
• 設定内に codex/* や openai-codex/* の古い参照が残っていないことを確認する
• 普段使っている自動化（automations）が新しい openai/* 参照で問題なく動くことを確認する
• OpenProse関連の設定が消え、既存の .prose ファイル自体は残っていることを確認する
• 1.x向けに作った既存スキルが2.0上でそのまま動作することを確認する
• 移行後に作成したセッションがSQLite側に保存され、正しく読み出せることを確認する

これらがすべて確認できれば、本番環境のOpenClaw 2.0への移行は無事に完了です。破壊的変更が3点に絞られ、そのうち2点を openclaw doctor --fix が自動で処理してくれる今回のアップデートは、事前のバックアップさえ丁寧に取っておけば、落ち着いて乗り切れる内容になっています。バックアップを取り、順序を守り、最後にチェックリストで裏取りする、この一連の流れを守ることが、失敗しない移行への一番の近道です。