openclaw update

OpenClaw を更新し、stable/extended-stable/beta/dev チャンネルを切り替えます。

npm/pnpm/bun 経由でインストールした場合（グローバルインストールで、git メタデータがない場合）、更新は 更新で説明されているパッケージマネージャーのフローを使用します。

使用方法

openclaw updateopenclaw update statusopenclaw update repairopenclaw update wizardopenclaw update --channel extended-stableopenclaw update --channel betaopenclaw update --channel devopenclaw update --tag betaopenclaw update --tag mainopenclaw update --dry-runopenclaw update --no-restartopenclaw update --yesopenclaw update --acknowledge-clawhub-riskopenclaw update --jsonopenclaw --update

openclaw --update は openclaw update に書き換えられます（シェルやランチャースクリプトで便利です）。

オプション

--verbose フラグはありません。予定されているアクションのプレビューには --dry-run、機械可読な結果には --json、チャンネルと利用可否のみの確認には openclaw update status --json を使用します。Gateway コンソールの詳細度（--verbose）とファイルのログレベル（logging.level: "debug"/"trace"）は独立した設定です。Gateway のログを参照してください。

update status

有効な更新チャンネル、git タグ/ブランチ/SHA（ソースチェックアウトのみ）、および更新の利用可否を表示します。

openclaw update statusopenclaw update status --jsonopenclaw update status --timeout 10

Extended-stable パッケージインストールの場合、ステータス確認ではフォアグラウンド更新と同じ公開セレクターおよび正確なパッケージの検証を実行します。インストールされているバージョンの方が新しい場合は、ahead of extended-stable と報告されることがあります。JSON の失敗には registry.reason（selector_missing、selector_query_failed、exact_package_mismatch、または unsupported_git_channel）が含まれます。

update repair

コアパッケージはすでに変更されたものの、その後の修復作業が正常に完了しなかった場合に、更新の最終処理を再実行します。openclaw update によって新しいコアパッケージがインストールされたものの、コア更新後の Plugin 同期、管理対象 npm Plugin のメタデータ、レジストリの更新、または Doctor による修復が収束しなかった場合にサポートされる復旧方法です。

openclaw update repairopenclaw update repair --channel betaopenclaw update repair --acknowledge-clawhub-riskopenclaw update repair --json

update repair は openclaw doctor --fix を実行し、修復された設定とインストールレコードを再読み込みし、有効な更新チャンネルに対して追跡対象の Plugin を同期し、管理対象の npm Plugin インストールを更新し、欠落している設定済み Plugin のペイロードを修復し、Plugin レジストリを更新して、収束したインストールレコードのメタデータを書き込みます。新しいコアパッケージのインストールも、Gateway の再起動も行いません。

update wizard

更新チャンネルを選択し、その後 Gateway を再起動するかどうかを確認する対話型フローです（デフォルトでは再起動します）。git チェックアウトがない状態で dev を選択すると、チェックアウトの作成を提案します。

動作内容

チャンネルを明示的に切り替えると（--channel ...）、インストール方法もそれに合わせて維持されます。

• dev -> git チェックアウト（デフォルトは ~/openclaw、OPENCLAW_HOME が設定されている場合は $OPENCLAW_HOME/openclaw、OPENCLAW_GIT_DIR で上書き可能）を確保して更新し、そのチェックアウトからグローバル CLI をインストールします。
• stable -> latest を使用して npm からインストールします。
• extended-stable -> 公開 npm extended-stable セレクターを解決し、選択された正確なパッケージを検証して、その正確なバージョンをインストールします。別のセレクターへのフォールバックは行わず、Git チェックアウトでは拒否されます。
• beta -> npm dist-tag beta を優先し、beta が存在しないか現在の安定版リリースより古い場合は latest にフォールバックします。

再起動の引き継ぎ

Gateway コアの自動更新機能（設定で有効な場合）は、稼働中の Gateway リクエストハンドラーの外部で CLI 更新パスを起動します。コントロールプレーンの update.run によるパッケージマネージャー更新と、監視下の git チェックアウト更新では、稼働中の Gateway プロセス内でパッケージツリーを置き換えたり dist/ を再ビルドしたりせず、同じ管理サービスへの引き継ぎを使用します。Gateway はデタッチされたヘルパーを起動して終了し、そのヘルパーが Gateway プロセスツリーの外部から openclaw update --yes --json を実行します。引き継ぎを利用できない場合、update.run は手動で実行するための安全なシェルコマンドを含む構造化レスポンスを返します。

保存された extended-stable の選択には、update.checkOnStart が有効な場合、読み取り専用の起動時および24時間ごとの更新ヒントが提供されます。これらのチェックが更新を適用したり、ハンドオフを開始したり、Gateway を再起動したり、stable の遅延／ジッターを使用したり、beta のポーリング間隔を使用したりすることはありません。明示的なフォアグラウンド更新、保存された update.channel: "extended-stable" を使用する引数なしのフォアグラウンド更新、オンデマンドのステータス確認、およびそれらの管理対象 Gateway ハンドオフは、引き続きサポートされます。

ローカルの管理対象 Gateway サービスがインストールされ、再起動が有効な場合、パッケージマネージャーおよび Git チェックアウトの更新では、パッケージツリーを置き換えたり、チェックアウト／ビルド出力を変更したりする前に、実行中のサービスを停止します。その後、アップデーターはサービスメタデータを更新し、サービスを再起動して、再起動後の Gateway を検証してから Gateway: restarted and verified. と報告します。パッケージマネージャーによる更新では、再起動後の Gateway が期待されるパッケージバージョンを報告することも検証します。Git チェックアウトの更新では、再ビルド後に Gateway の正常性とサービスの準備完了状態を検証します。

macOS では、更新後チェックにより、アクティブなプロファイルで LaunchAgent が読み込まれ、実行中であること、および設定されたループバックポートが正常であることも検証されます。plist がインストールされているにもかかわらず launchd が監視していない場合、OpenClaw は LaunchAgent を自動的に再ブートストラップし、正常性／バージョン／チャネルの準備完了チェックを再実行します（新規ブートストラップでは RunAtLoad ジョブが直接読み込まれるため、復旧処理が新しく起動された Gateway に対して直ちに kickstart -k を実行することはありません）。それでも Gateway が正常にならない場合、コマンドはゼロ以外の終了コードで終了し、再起動ログのパスに加えて、再起動、再インストール、およびパッケージのロールバック手順を出力します。

再起動を実行できない場合、コマンドは Gateway: restart skipped (...) または Gateway: restart failed: ... を、手動で実行する openclaw gateway restart のヒントとともに出力します。--no-restart を指定した場合も、パッケージの置き換えまたは Git の再ビルドは実行されますが、管理対象サービスは停止も再起動もされないため、実行中の Gateway は手動で再起動するまで古いコードを使用し続けます。

コントロールプレーンのレスポンス形式

パッケージマネージャーによるインストールまたは監視対象の Git チェックアウトで、update.run が Gateway のコントロールプレーン経由で実行される場合、ハンドラーは、Gateway の終了後も継続する CLI 更新とは別に、ハンドオフの開始を報告します。

• ok: true、result.status: "skipped"、 result.reason: "managed-service-handoff-started"、および handoff.status: "started"：Gateway は管理対象サービスのハンドオフを作成し、自身の再起動をスケジュールしました。これにより、切り離されたヘルパーは稼働中のサービスプロセス外で openclaw update --yes --json を実行できます。
• ok: false、result.reason: "managed-service-handoff-unavailable"、および handoff.status: "unavailable"：OpenClaw は、安全なハンドオフに必要な監視サービス境界と永続的なサービス ID を見つけられませんでした（たとえば、systemd のハンドオフには、単に周囲の systemd プロセスマーカーだけでなく、OPENCLAW_SYSTEMD_UNIT のユニット ID が必要です）。レスポンスには、Gateway の外部から実行するシェルコマンドである handoff.command が含まれます。
• ok: false、result.reason: "managed-service-handoff-failed"：Gateway はハンドオフの作成を試みましたが、切り離されたヘルパーを起動できませんでした。

sentinel ペイロードは Gateway の終了前に書き込まれ、CLI ハンドオフは、管理対象サービスの再起動後の正常性チェックが完了すると、同じ再起動 sentinel を更新します。ハンドオフ中、sentinel には成功時の継続処理なしで stats.reason: "restart-health-pending" が含まれる場合があります。再起動後の Gateway はこれをポーリングし、CLI がサービスの正常性を検証して最終的な ok の結果で sentinel を書き換えた後にのみ、継続処理を実行します。openclaw status と openclaw status --all は、その sentinel が保留中または失敗している間、Update restart 行を表示し、update.status は最新の sentinel を更新して返します。

Git チェックアウトのフロー

チャネルの選択

• stable：最新の非 beta タグをチェックアウトし、ビルドと doctor を実行します。
• beta：最新の -beta タグを優先し、beta が存在しないか stable より古い場合は、最新の stable タグにフォールバックします。
• dev：main をチェックアウトし、その後 fetch と rebase を実行します。
• extended-stable：Git チェックアウトではサポートされません。チェックアウトの変更は行われません。

更新手順

Plugin 同期の詳細

beta チャネルでは、default/latest 系列に従う追跡対象の npm および ClawHub plugin インストールについて、最初に plugin の @beta リリースを試します。plugin に beta リリースがない場合、OpenClaw は記録された default/latest の指定にフォールバックし、警告を報告します。npm plugins では、beta パッケージが存在していてもインストール検証に失敗した場合にもフォールバックします。これらのフォールバック警告によって、コアの更新が失敗することはありません。正確なバージョンと明示的なタグは書き換えられません。

extended-stable のコア更新が成功すると、コア更新後の plugin の整合性と収束は、インストール済みのコアとまったく同じバージョンの対象となる公式 npm plugins を対象にします。default/latest の意図の場合、OpenClaw は plugin の @extended-stable を照会せず、npm の latest にもフォールバックしません。インストール済みのコアからパッケージバージョンを導出します。明示的なバージョン固定、明示的な latest 以外のタグ、サードパーティ製パッケージ、および npm 以外のソースは、既存の意図を維持します。

パッケージマネージャーによるインストールでは、openclaw update はパッケージマネージャーを呼び出す前に、対象のパッケージバージョンを解決します。npm のグローバルインストールでは、段階的インストールを使用します。OpenClaw は新しいパッケージを一時的な npm prefix にインストールし、そこでパッケージ化された dist の内容一覧を検証してから、そのクリーンなパッケージツリーを実際のグローバル prefix に入れ替えます。検証に失敗した場合、疑わしいツリーから更新後の doctor、plugin 同期、および再起動処理が実行されることはありません。インストール済みバージョンがすでに対象と一致している場合でも、コマンドはグローバルパッケージのインストールを更新し、その後 plugin 同期、コアコマンドの補完情報の更新、および再起動処理を実行します。これにより、パッケージ化されたサイドカーとチャネル管理の plugin 記録がインストール済みの OpenClaw ビルドと整合した状態に保たれます。一方、plugin コマンドを含む完全な補完情報の再ビルドは、明示的な openclaw completion --write-state の実行時にのみ行われます。

関連項目

• openclaw doctor（Git チェックアウトでは、最初に更新を実行するよう提案します）
• 開発チャネル
• 更新
• CLI リファレンス