# openclaw update

OpenClaw を安全に更新し、stable/beta/dev チャネルを切り替えます。

npm/pnpm/bun（グローバルインストール、git メタデータなし）でインストールした場合、 更新は 更新 のパッケージマネージャーフローで行われます。

# 使用方法

openclaw update
openclaw update status
openclaw update wizard
openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag beta
openclaw update --tag main
openclaw update --dry-run
openclaw update --no-restart
openclaw update --yes
openclaw update --json
openclaw --update

# オプション

• --no-restart: 更新に成功した後、Gateway サービスの再起動をスキップします。Gateway を再起動するパッケージマネージャー更新では、コマンドが成功する前に、再起動後のサービスが想定どおりの更新済みバージョンを報告することを確認します。
• --channel <stable|beta|dev>: 更新チャネルを設定します（git + npm。設定に永続化されます）。
• --tag <dist-tag|version|spec>: この更新だけで使用するパッケージターゲットを上書きします。パッケージインストールでは、main は github:openclaw/openclaw#main に対応します。
• --dry-run: 設定の書き込み、インストール、plugins の同期、再起動を行わずに、予定されている更新アクション（チャネル/タグ/ターゲット/再起動フロー）をプレビューします。
• --json: 機械可読な UpdateRunResult JSON を出力します。これには、コア更新が成功した後に破損または読み込み不能な管理対象 plugins の修復が必要な場合の postUpdate.plugins.warnings と、更新後の plugin 同期中に npm plugin アーティファクトのドリフトが検出された場合の postUpdate.plugins.integrityDrifts が含まれます。
• --timeout <seconds>: ステップごとのタイムアウト（デフォルトは 1800 秒）。
• --yes: 確認プロンプトをスキップします（例: ダウングレード確認）。

openclaw update には --verbose フラグはありません。予定されている チャネル/タグ/インストール/再起動アクションをプレビューするには --dry-run を、 機械可読な結果には --json を、チャネルと利用可能性の詳細だけが必要な場合は openclaw update status --json を使用します。更新前後の Gateway ログをデバッグしている場合、 コンソールの詳細度とファイルログレベルは別々です。Gateway の --verbose は ターミナル/WebSocket 出力に影響し、ファイルログには設定内の logging.level: "debug" または "trace" が必要です。Gateway ロギング を参照してください。

# update status

アクティブな更新チャネル + git タグ/ブランチ/SHA（ソースチェックアウトの場合）と、更新の利用可能性を表示します。

openclaw update status
openclaw update status --json
openclaw update status --timeout 10

オプション:

• --json: 機械可読なステータス JSON を出力します。
• --timeout <seconds>: チェックのタイムアウト（デフォルトは 3 秒）。

# update wizard

更新チャネルを選択し、更新後に Gateway を再起動するかどうかを確認する対話型フローです （デフォルトは再起動）。git チェックアウトなしで dev を選択した場合は、 作成するかどうかを提示します。

オプション:

• --timeout <seconds>: 各更新ステップのタイムアウト（デフォルト 1800）

# 実行内容

明示的にチャネルを切り替える場合（--channel ...）、OpenClaw は インストール方法も揃えます。

• dev → git チェックアウトを確保し（デフォルト: ~/openclaw、OPENCLAW_GIT_DIR で上書き可能）、 更新して、そのチェックアウトからグローバル CLI をインストールします。
• stable → latest を使用して npm からインストールします。
• beta → npm dist-tag beta を優先しますが、beta が存在しないか現在の stable リリースより古い場合は latest にフォールバックします。

OpenClaw にはまだ LTS や月次サポートチャネルはありません。月次サポートラインに向けて取り組んでいますが、 現在 --channel が受け付けるのは stable、beta、dev のみです。特定のパッケージアーティファクトが必要な一度限りの ターゲットには --tag <version-or-dist-tag> を使用してください。

Gateway コアの自動更新機能（設定で有効な場合）は、稼働中の Gateway リクエストハンドラーの外側で CLI 更新パスを起動します。コントロールプレーンの update.run パッケージマネージャー更新は、 パッケージの差し替え後に、遅延なし、クールダウンなしの更新再起動を強制します。 これは、古い Gateway プロセスが、新しいパッケージで削除されたファイルを指す メモリ内チャンクをまだ保持している可能性があるためです。

パッケージマネージャーインストールでは、openclaw update はパッケージマネージャーを呼び出す前に ターゲットパッケージバージョンを解決します。npm グローバルインストールではステージングされた インストールを使用します。OpenClaw は新しいパッケージを一時的な npm prefix にインストールし、 そこでパッケージ化された dist インベントリを検証した後、そのクリーンなパッケージツリーを 実際のグローバル prefix に差し替えます。検証に失敗した場合、更新後の doctor、plugin 同期、 再起動作業は疑わしいツリーから実行されません。インストール済みバージョンがすでにターゲットと 一致している場合でも、コマンドはグローバルパッケージインストールを更新し、その後 plugin 同期、 コアコマンド補完の更新、再起動作業を実行します。これにより、完全な plugin コマンド補完の再構築は 明示的な openclaw completion --write-state 実行に任せつつ、パッケージ化されたサイドカーと チャネル所有の plugin レコードをインストール済みの OpenClaw ビルドと揃えます。

ローカル管理の Gateway サービスがインストールされており、再起動が有効な場合、 パッケージマネージャー更新はパッケージツリーを置き換える前に実行中のサービスを停止し、 更新済みインストールからサービスメタデータを更新してからサービスを再起動し、 再起動後の Gateway が想定バージョンを報告することを確認してから成功を報告します。 macOS では、更新後チェックでアクティブなプロファイルの LaunchAgent が読み込まれて実行中であること、 および設定済みのループバックポートが正常であることも確認します。plist がインストールされているが launchd がそれを監視していない場合、OpenClaw は LaunchAgent を自動的に再ブートストラップし、 その後でヘルス/バージョン/チャネルの準備完了チェックを再実行します。新規ブートストラップでは RunAtLoad ジョブを直接読み込むため、更新リカバリーでは新しく生成された Gateway に対して すぐに kickstart -k を実行しません。Gateway がそれでも正常にならない場合、コマンドは 非ゼロで終了し、再起動ログのパスと、明示的な再起動、再インストール、パッケージのロールバック手順を 出力します。--no-restart を指定した場合、 パッケージ置き換えは引き続き実行されますが、管理対象サービスは停止または再起動されないため、 手動で再起動するまで実行中の Gateway は古いコードを使い続ける可能性があります。

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

# チャネル選択

• stable: 最新の非 beta タグをチェックアウトしてから、ビルドと doctor を実行します。
• beta: 最新の -beta タグを優先しますが、beta が存在しないか古い場合は最新の stable タグにフォールバックします。
• dev: main をチェックアウトしてから、fetch と rebase を行います。

# 更新ステップ

beta 更新チャネルでは、デフォルト/latest ラインに従う追跡対象の npm および ClawHub plugin インストールは、 まず plugin の @beta リリースを試します。plugin に beta リリースがない場合、OpenClaw は 記録済みのデフォルト/latest spec にフォールバックします。npm plugins では、beta パッケージが存在しても インストール検証に失敗した場合にも OpenClaw はフォールバックします。正確なバージョンと明示的なタグは書き換えられません。

# --update 省略形

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

# 関連

• openclaw doctor（git チェックアウトでは先に更新を実行することを提示します）
• 開発チャネル
• 更新
• CLI リファレンス