OpenClaw を最新の状態に保つ。Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
推奨: openclaw update
更新する最速の方法です。インストール種別 (npm または git) を検出し、最新バージョンを取得し、openclaw doctor を実行して、gateway を再起動します。
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 コードのインストール先だけです。
--dry-run 付きで実行します:
dev チャネルは git チェックアウトを用意し、ビルドして、そのチェックアウトからグローバル CLI を
インストールします。stable と beta チャネルはパッケージインストールを使用します。
gateway がすでにインストールされている場合、openclaw update はサービスメタデータを更新し、
--no-restart を渡さない限り再起動します。
代替: インストーラーを再実行する
--no-onboard を追加します。インストーラー経由で特定のインストール種別を
強制するには、--install-method git --no-onboard または
--install-method npm --no-onboard を渡します。
npm パッケージのインストール段階の後で openclaw update が失敗した場合は、
インストーラーを再実行してください。インストーラーは古いアップデーターを呼び出しません。グローバル
パッケージインストールを直接実行し、部分的に更新された npm インストールを復旧できます。
--version を追加します:
代替: 手動の npm、pnpm、または bun
openclaw update を推奨します。実行中の Gateway サービスと
パッケージの入れ替えを連携できるためです。管理対象 Gateway が実行中の状態で手動更新する場合は、
パッケージマネージャーの完了直後に Gateway を再起動し、古いプロセスが置き換え済みのパッケージ
ファイルから提供を続けないようにしてください。
openclaw update がグローバル npm インストールを管理する場合、まず対象を一時的な npm prefix に
インストールし、パッケージ化された dist インベントリを検証してから、クリーンなパッケージツリーを
実際のグローバル prefix に入れ替えます。これにより、npm が古いパッケージ由来の古いファイルに
新しいパッケージを上書き配置することを避けられます。インストールコマンドが失敗した場合、
OpenClaw は --omit=optional 付きでもう一度試行します。この再試行は、ネイティブの任意依存関係を
コンパイルできないホストで役立ち、フォールバックも失敗した場合は元の失敗を見える状態に保ちます。
高度な npm インストールトピック
読み取り専用のパッケージツリー
読み取り専用のパッケージツリー
OpenClaw は、グローバルパッケージディレクトリが現在のユーザーにより書き込み可能な場合でも、パッケージ化されたグローバルインストールをランタイムでは読み取り専用として扱います。Plugin パッケージのインストール先は、ユーザー設定ディレクトリ配下の OpenClaw 所有の npm/git ルートであり、Gateway 起動時に OpenClaw パッケージツリーを変更することはありません。一部の Linux npm セットアップでは、
/usr/lib/node_modules/openclaw など root 所有のディレクトリ配下にグローバルパッケージをインストールします。OpenClaw はそのレイアウトをサポートします。Plugin のインストール/更新コマンドは、そのグローバルパッケージディレクトリの外部に書き込むためです。強化された systemd ユニット
強化された systemd ユニット
明示的な Plugin インストール、Plugin 更新、doctor クリーンアップが変更を永続化できるように、OpenClaw に設定/状態ルートへの書き込み権限を付与します:
ディスク容量の事前チェック
ディスク容量の事前チェック
パッケージ更新と明示的な Plugin インストールの前に、OpenClaw は対象ボリュームに対してベストエフォートのディスク容量チェックを試みます。容量不足の場合はチェックしたパスを含む警告が表示されますが、更新はブロックされません。ファイルシステムのクォータ、スナップショット、ネットワークボリュームはチェック後に変わる可能性があるためです。実際のパッケージマネージャーによるインストールとインストール後の検証が、引き続き権威ある結果となります。
自動アップデーター
自動アップデーターはデフォルトでオフです。~/.openclaw/openclaw.json で有効にします:
| チャネル | 動作 |
|---|---|
stable | stableDelayHours 待機してから、stableJitterHours 全体に決定的なジッターをかけて適用します (段階的ロールアウト)。 |
beta | betaCheckIntervalHours ごとにチェックし (デフォルト: 1 時間ごと)、ただちに適用します。 |
dev | 自動適用はありません。openclaw update を手動で使用してください。 |
update.checkOnStart: false で無効化)。
ダウングレードやインシデント復旧では、Gateway 環境で OPENCLAW_NO_AUTO_UPDATE=1 を設定すると、update.auto.enabled が構成されていても自動適用をブロックできます。起動時の更新ヒントは、update.checkOnStart も無効化されていない限り引き続き実行される場合があります。
ライブ Gateway コントロールプレーンハンドラー経由で要求されたパッケージマネージャー更新は、
パッケージ入れ替え後に、延期なし・クールダウンなしの更新再起動を強制します。これにより、
すでに置き換えられたパッケージツリーから古いメモリ内プロセスがチャンクを遅延ロードできるほど
長く残ることを避けられます。シェルの openclaw update は、更新の前後でサービスを停止および
再起動できるため、管理されたインストールでは引き続き推奨される方法です。
更新後
設定を移行し、DM ポリシーを監査し、gateway の健全性を確認します。詳細: Doctor
ロールバック
バージョンを固定する (npm)
コミットを固定する (ソース)
git checkout main && git pull。
行き詰まった場合
openclaw doctorを再度実行し、出力を注意深く読んでください。- ソースチェックアウトで
openclaw update --channel devを実行する場合、アップデーターは必要に応じてpnpmを自動ブートストラップします。pnpm/corepack のブートストラップエラーが表示された場合は、pnpmを手動でインストールする (またはcorepackを再度有効化する) して、更新を再実行してください。 - 確認: トラブルシューティング
- Discord で質問: https://discord.gg/clawd