更新

OpenClaw を最新の状態に保つ。

推奨: openclaw update

更新する最速の方法です。インストール種別 (npm または git) を検出し、最新バージョンを取得し、openclaw doctor を実行して、gateway を再起動します。

openclaw update

チャネルを切り替える、または特定のバージョンを対象にするには:

openclaw update --channel betaopenclaw update --channel devopenclaw update --tag mainopenclaw update --dry-run   # 適用せずにプレビュー

openclaw update は --verbose を受け付けません。更新の診断には、 計画されたアクションをプレビューする --dry-run、構造化された結果を得る --json、または チャネルと利用可能状態を調べる openclaw update status --json を使用します。 インストーラーには独自の --verbose フラグがありますが、そのフラグは openclaw update の一部ではありません。

--channel beta は beta を優先しますが、beta タグが存在しない、または最新の安定版リリースより古い場合、 ランタイムは stable/latest にフォールバックします。一度きりのパッケージ更新で 生の npm beta dist-tag を使いたい場合は、--tag beta を使用してください。

管理対象 Plugin では、beta チャネルのフォールバックは警告です。Plugin beta が利用できないために Plugin が記録済みの default/latest リリースを使っていても、コアの更新は 成功する場合があります。

チャネルの意味については、開発チャネル を参照してください。

npm と git インストールを切り替える

インストール種別を変更したい場合はチャネルを使用します。アップデーターは ~/.openclaw 内の状態、設定、認証情報、ワークスペースを保持します。変更するのは CLI と gateway が使用する OpenClaw コードのインストール先だけです。

# npm パッケージインストール -> 編集可能な git チェックアウトopenclaw update --channel dev # git チェックアウト -> npm パッケージインストールopenclaw update --channel stable

正確なインストールモード切り替えをプレビューするには、まず --dry-run 付きで実行します:

openclaw update --channel dev --dry-runopenclaw update --channel stable --dry-run

dev チャネルは git チェックアウトを用意し、ビルドして、そのチェックアウトからグローバル CLI を インストールします。stable と beta チャネルはパッケージインストールを使用します。 gateway がすでにインストールされている場合、openclaw update はサービスメタデータを更新し、 --no-restart を渡さない限り再起動します。

代替: インストーラーを再実行する

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

オンボーディングをスキップするには --no-onboard を追加します。インストーラー経由で特定のインストール種別を 強制するには、--install-method git --no-onboard または --install-method npm --no-onboard を渡します。

npm パッケージのインストール段階の後で openclaw update が失敗した場合は、 インストーラーを再実行してください。インストーラーは古いアップデーターを呼び出しません。グローバル パッケージインストールを直接実行し、部分的に更新された npm インストールを復旧できます。

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

復旧を特定のバージョンまたは dist-tag に固定するには、--version を追加します:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm --version <version-or-dist-tag>

代替: 手動の npm、pnpm、または bun

npm i -g openclaw@latest

管理されたインストールでは openclaw update を推奨します。実行中の Gateway サービスと パッケージの入れ替えを連携できるためです。管理対象 Gateway が実行中の状態で手動更新する場合は、 パッケージマネージャーの完了直後に Gateway を再起動し、古いプロセスが置き換え済みのパッケージ ファイルから提供を続けないようにしてください。

openclaw update がグローバル npm インストールを管理する場合、まず対象を一時的な npm prefix に インストールし、パッケージ化された dist インベントリを検証してから、クリーンなパッケージツリーを 実際のグローバル prefix に入れ替えます。これにより、npm が古いパッケージ由来の古いファイルに 新しいパッケージを上書き配置することを避けられます。インストールコマンドが失敗した場合、 OpenClaw は --omit=optional 付きでもう一度試行します。この再試行は、ネイティブの任意依存関係を コンパイルできないホストで役立ち、フォールバックも失敗した場合は元の失敗を見える状態に保ちます。

pnpm add -g openclaw@latest

bun add -g openclaw@latest

高度な npm インストールトピック

ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp

自動アップデーター

自動アップデーターはデフォルトでオフです。~/.openclaw/openclaw.json で有効にします:

{  update: {    channel: "stable",    auto: {      enabled: true,      stableDelayHours: 6,      stableJitterHours: 12,      betaCheckIntervalHours: 1,    },  },}

gateway は起動時にも更新ヒントをログに記録します (update.checkOnStart: false で無効化)。 ダウングレードやインシデント復旧では、Gateway 環境で OPENCLAW_NO_AUTO_UPDATE=1 を設定すると、update.auto.enabled が構成されていても自動適用をブロックできます。起動時の更新ヒントは、update.checkOnStart も無効化されていない限り引き続き実行される場合があります。

ライブ Gateway コントロールプレーンハンドラー経由で要求されたパッケージマネージャー更新は、 パッケージ入れ替え後に、延期なし・クールダウンなしの更新再起動を強制します。これにより、 すでに置き換えられたパッケージツリーから古いメモリ内プロセスがチャンクを遅延ロードできるほど 長く残ることを避けられます。シェルの openclaw update は、更新の前後でサービスを停止および 再起動できるため、管理されたインストールでは引き続き推奨される方法です。

更新後

openclaw doctor

openclaw gateway restart

openclaw health

ロールバック

バージョンを固定する (npm)

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

コミットを固定する (ソース)

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

最新に戻すには: git checkout main && git pull。

行き詰まった場合

• openclaw doctor を再度実行し、出力を注意深く読んでください。
• ソースチェックアウトで openclaw update --channel dev を実行する場合、アップデーターは必要に応じて pnpm を自動ブートストラップします。pnpm/corepack のブートストラップエラーが表示された場合は、pnpm を手動でインストールする (または corepack を再度有効化する) して、更新を再実行してください。
• 確認: トラブルシューティング
• Discord で質問: https://discord.gg/clawd

関連

• インストール概要: すべてのインストール方法。
• Doctor: 更新後の健全性チェック。
• 移行: メジャーバージョン移行ガイド。