OpenClaw v2.0 アップデート：破壊的変更を回避するための重要なアップデート前チェックリスト

OpenClawのメジャーアップデートには事前準備が必要

OpenClawは数か月ぶりの大規模アップデートをリリースし、12の破壊的変更、完全に新しいプラグインシステム、30以上のセキュリティパッチが含まれています。事前準備なしにnpm updateを実行すると、設定が黙って壊れてしまいます。

ステップ1: 環境変数を確認

OpenClawがClawdbotやMoltbotと呼ばれていた時代のレガシー環境変数はもう機能しません。互換性シム、フォールバック、警告は一切ありません。古い変数を確認してください：

env | grep -i clawdbot
env | grep -i moltbot

何か表示されたら、リネームしてください：

• CLAWDBOT_* → OPENCLAW_*
• MOLTBOT_* → OPENCLAW_*

.env、.bashrc、.zshrc、.profile、およびすべてのdocker-composeファイルを確認してください。変数が欠けていると、OpenClawはデフォルト設定で起動し、あなたの設定は適用されません。

ステップ2: 状態ディレクトリを確認

古いディレクトリ名の自動検出はなくなりました。現在の状態ディレクトリを確認してください：

ls ~/.moltbot 2>/dev/null && echo "移動が必要です"
ls ~/.openclaw 2>/dev/null && echo "問題ありません"

まだ~/.moltbotを使用している場合は、アップデート前に移動してください：

mv ~/.moltbot ~/.openclaw

またはパスを明示的に設定してください：

export OPENCLAW_STATE_DIR=~/.openclaw

先にアップデートすると、OpenClawは空の設定で新しい~/.openclawディレクトリを作成します。

ステップ3: 設定をバックアップ

アップデート前にバックアップを作成してください：

cp -r ~/.openclaw ~/.openclaw-backup-$(date +%Y%m%d)

これにはSOUL.md、USER.md、MEMORY.md、エージェント設定、スキル、その他すべてが含まれます。

ステップ4: ブラウザ自動化設定を確認

レガシーチローム拡張機能リレーは完全に削除されました。ブラウザ設定でdriver: "extension"やbrowser.relayBindHostを使用している場合、それらの設定は今では何も機能しません。設定を確認してください：

openclaw config get | grep -i browser

新しいアプローチでは、既存セッションのブラウザ接続を使用します。OpenClawは拡張機能を通じてブラウザを制御するのではなく、すでに実行中のブラウザに接続します。OpenClawは現在、独自のブラウザプロファイル（openclawプロファイル）を管理するか、CDPを介して既存のChromeセッションに接続します。

ステップ5: Clawhubの変更を理解

Clawhubは現在、デフォルトのプラグインおよびスキルストアです。openclaw plugins installやopenclaw skills installを実行すると、まずClawhubをチェックし、パッケージが見つからない場合のみnpmにフォールバックします。これは次のことを意味します：

• npm経由でインストールされた一部のスキルは、Clawhub経由で再インストールする必要があるかもしれません
• openclaw skills search、openclaw skills install、openclaw skills updateは、ClawHubをネイティブに使用する新しいコマンドです
• スキルがClawhubにない場合でも、npmからインストールできます（削除ではなくフォールバックです）

アップデート後、次を実行してください：

openclaw skills update

既存のスキルが新しいシステムと同期していることを確認します。