OpenClawのアップデートガイド

開発が活発なツールを使っていると、頻繁なアップデートは嬉しい反面、少し緊張する作業でもあります。「環境が壊れないか」「また一から設定し直しにならないか」といった不安は、開発者なら誰もが経験することです。

OpenClawは現在「1.0」未満のフェーズにあり、非常に速いスピードで進化しています。アップデートはインフラのデプロイと同じように、「アップデート → チェック実行 → 再起動（または openclaw update を使用） → 確認」という流れで行うのが確実です。

必要なもの

アップデートを始める前に、現在の環境について以下の4点を確認し、準備しておいてください。

インストール方法の特定: Global install（npm/pnpm）か、Source install（git clone）か。
Gatewayの実行状態: ターミナルで直接動かしているか、サービス（launchd/systemd）として管理しているか。
設定のバックアップ: ~/.openclaw/openclaw.json をコピーしておきます。
データと認証情報の保護: ~/.openclaw/credentials/ と ~/.openclaw/workspace を確認してください。

最も推奨されるアップデート方法は、公式サイトのインストーラーを再度実行することです。既存のインストールを自動で検出し、適切な場所へ上書きアップデートを行います。必要に応じて openclaw doctor も実行されます。

curl -fsSL https://openclaw.ai/install.sh | bash

ヒント:

オンボーディングウィザードをスキップしたい場合は、--no-onboard を追加してください。
Source install の場合は、以下のコマンドを使用します（リポジトリがクリーンな場合のみ git pull --rebase が実行されます）。

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard

npm または pnpm を使用している場合は、以下のいずれかのコマンドを実行してください。なお、Gatewayの実行環境として Bun は推奨されていません（WhatsApp/Telegramでバグが発生するためです）。

npm i -g openclaw@latest
# または
pnpm add -g openclaw@latest

特定のチャンネルに切り替えたい場合は、以下のコマンドが使えます。

openclaw update --channel beta
openclaw update --channel dev
openclaw update --channel stable

アップデート後は、必ず以下の手順で状態を確認してください。

openclaw doctor
openclaw gateway restart
openclaw health

Source install（git checkout）を利用している場合は、openclaw update コマンドが便利です。このコマンドは、以下の安全なフローを自動で実行します。

openclaw doctor は、アップデートを安全に完了させるための重要なコマンドです。このコマンドは、以下のような修正や移行を退屈なほど着実に行います。

もしアップデート後に問題が発生した場合は、以下の手順を試してください。

特定のバージョンを指定してインストールし、再起動します。

npm i -g openclaw@<version>
openclaw doctor
openclaw gateway restart

git を使用して、特定の日付時点のコミットまで戻すことができます。

git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
pnpm install
pnpm build
openclaw gateway restart

解決しない場合は、AI Setup Assistant に相談してみてください。

OpenClaw Expert

このページで解決しない場合は、OpenClaw Expertに直接質問してください。