OpenClawSkills
GitHub
CLI リファレンス • 5分で読める

Update

openclaw update の CLI リファレンス（安全な更新源 + Gateway の自動再起動）。

OpenClaw を安全に更新し、安定版/ベータ版/開発版チャンネル間で切り替えます。

''npm/pnpm'' 経由でインストールした場合（グローバルインストール、git メタデータなし）、''Updating'' のパッケージマネージャーフローを通じて更新が行われます。

Tutorial.step

Usage

Bash
openclaw update
openclaw update status
openclaw update wizard
openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag beta
openclaw update --no-restart
openclaw update --json
openclaw --update
Tutorial.step

オプション

- ''--no-restart''：正常な更新後にゲートウェイサービスの再起動をスキップします。

- ''--channel <stable|beta|dev>'': Set update channel (git + npm; persisted in config).

- ''--tag <dist-tag|version>'': Override npm dist-tag or version for this update only.

- ''--json''：機械可読な ''UpdateRunResult'' JSON を出力します。

- ''--timeout <seconds>'': Timeout per step (default 1200s).

注意：ダウングレードは確認が必要です。古いバージョンは設定を破損する可能性があるためです。

Tutorial.step

`update status`

アクティブな更新チャンネル + git tag/branch/SHA（ソースチェックアウト用）および更新の利用可能性を表示します。

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

オプション：

- ''--json''：機械可読なステータス JSON を出力します。

- ''--timeout <seconds>'': Check timeout (default 3s).

Tutorial.step

`update wizard`

更新チャンネルを選択し、更新後にゲートウェイを再起動するかどうかを確認する対話型フロー

（デフォルトは再起動）。git チェックアウトなしで ''dev'' を選択した場合、

作成を提案します。

Tutorial.step

What it does

チャンネルを明示的に切り替えると（''--channel ...''）、OpenClaw は

インストール方法も調整します：

- ''dev'' → git チェックアウトを確保します（デフォルト：''~/openclaw''、''OPENCLAW_GIT_DIR'' で上書き）、

更新し、そのチェックアウトからグローバル CLI をインストールします。

- ''stable''/''beta'' → 一致する dist-tag を使用して npm からインストールします。

Tutorial.step

Git チェックアウトフロー

チャンネル：

- ''stable''：最新の非ベータタグをチェックアウトし、ビルド + doctor を実行します。

- ''beta''：最新の ''-beta'' タグをチェックアウトし、ビルド + doctor を実行します。

- ''dev''：''main'' をチェックアウトし、fetch + rebase を実行します。

高レベル：

1. クリーンな作業ツリーが必要です（未コミットの変更なし）。

2. 選択したチャンネル（タグまたはブランチ）に切り替えます。

3. アップストリームを取得します（dev のみ）。

4. dev のみ：一時作業ツリーで事前チェック lint + TypeScript ビルドを実行；プロンプトが失敗した場合、最新のクリーンビルドを見つけるために最大 10 コミットまで戻ります。

5. 選択したコミットにリベースします（dev のみ）。

6. deps をインストールします（pnpm 推奨；npm フォールバック）。

7. ビルド + コントロール UI をビルドします。

8. 最終的な「安全な更新」チェックとして ''openclaw doctor'' を実行します。

9. プラグインをアクティブチャンネルに同期します（dev はバンドル拡張機能を使用；安定版/ベータ版は npm を使用）し、npm インストール済みプラグインを更新します。

Tutorial.step

`--update` shorthand

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

Tutorial.step

See also

- ''openclaw doctor'' （git チェックアウトで最初に実行することが提案されます）

- ''開発チャンネル''

- ''Updating''

- ''CLI リファレンス''