リリースチャンネル

OpenClaw は 4 つの更新チャンネルを提供します。

• stable: npm dist-tag latest。ほとんどのユーザーに推奨されます。
• extended-stable: npm dist-tag extended-stable。新規に追加された、サポート対象月を追従する パッケージチャンネルです。パッケージ専用で、インストールは フォアグラウンドでのみ実行されます。保存された選択では、 update.checkOnStart が有効な場合に読み取り専用の更新通知を受け取りますが、 自動的に適用されることはありません。
• beta: npm dist-tag beta。beta が存在しない場合、または 現在の stable リリースより古い場合は、latest にフォールバックします。
• dev: main（git）の移動する先端です。公開されている場合は npm dist-tag dev。main は実験および活発な開発向けであり、未完成の 機能や破壊的変更が含まれる場合があります。本番環境の Gateway では実行しないでください。

stable ビルドは通常、最初に beta としてリリースされ、そこで検証された後、 バージョンを上げずに latest に昇格されます。メンテナーは latest に直接公開することもできます。npm インストールでは dist-tag が信頼できる唯一の情報源です。

チャンネルの切り替え

openclaw update --channel stableopenclaw update --channel extended-stableopenclaw update --channel betaopenclaw update --channel dev

--channel は選択を設定の update.channel に永続化し、両方の インストール方法を制御します。

dev の git インストールでは、デフォルトのチェックアウトは ~/openclaw です （OPENCLAW_HOME が設定されている場合は $OPENCLAW_HOME/openclaw）。上書きするには OPENCLAW_GIT_DIR を使用します。

1 回限りのバージョンまたはタグ指定

永続化されたチャンネルを変更せずに、1 回の更新で特定の dist-tag、バージョン、 またはパッケージ指定を対象にするには、--tag を使用します。

# 特定のバージョンをインストールopenclaw update --tag 2026.4.1-beta.1 # beta dist-tag からインストール（1 回限り、永続化しない）openclaw update --tag beta # 移動する GitHub main チェックアウトに切り替え（永続化）openclaw update --channel dev # 特定の npm パッケージ指定をインストールopenclaw update --tag openclaw@2026.4.1-beta.1 # チャンネルを永続化せずに GitHub main から 1 回だけインストールopenclaw update --tag main

注：

• --tag はパッケージ（npm）インストールにのみ適用されます。git インストールでは無視されます。
• タグは永続化されません。次回の openclaw update では、設定済みの チャンネルが使用されます。
• --tag main は、その 1 回の実行に対して npm 互換の指定 github:openclaw/openclaw#main にマッピングされます。移動する main インストールを永続化するには、 openclaw update --channel dev を使用するか（パッケージインストールは git チェックアウトに切り替わります）、 インストーラーの git 方式で再インストールします： curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --version main。 npm インストール方法では GitHub／git ソースターゲットが完全に拒否され、 代わりに git 方式を使用するよう案内されます。
• ダウングレード保護：対象バージョンが現在の バージョンより古い場合、OpenClaw は確認を求めます（--yes でスキップできます）。
• extended-stable は常に、検証済みの正確なパッケージターゲットを使用します。これは --tag extended-stable の 1 回限りの別名ではなく、--tag を 有効な extended-stable チャンネルと組み合わせることはできません。
• --channel beta は --tag beta とは異なります。チャンネルフローでは beta が 存在しないか古い場合に stable／latest にフォールバックできますが、--tag beta は 常にその 1 回の実行で未加工の beta dist-tag を対象にします。

ドライラン

変更を加えずに、openclaw update が実行する内容をプレビューします。

openclaw update --dry-runopenclaw update --channel beta --dry-runopenclaw update --tag 2026.4.1-beta.1 --dry-runopenclaw update --dry-run --json

ドライランでは、有効なチャンネル、対象バージョン、予定されているアクション、 およびダウングレードの確認が必要かどうかが報告されます。

Plugin とチャンネル

openclaw update でチャンネルを切り替えると、Plugin のソースも同期されます。

• dev は、バンドル版に対応するインストール済み Plugin を、 バンドル版（git チェックアウト）のソースに戻します。
• stable と beta は、npm または ClawHub からインストールされた Plugin パッケージを復元します。
• extended-stable は、bare／default または latest の指定を持つ対象の公式 npm Plugin を、インストール済みの core とまったく同じバージョンに解決します。実行時に Plugin の @extended-stable タグを照会することはありません。
• npm でインストールされた Plugin は、core の更新完了後に更新されます。

現在の状態の確認

openclaw update status

アクティブなチャンネル（それを決定したソース：設定、git タグ、 git ブランチ、インストール済みバージョン、またはデフォルト）、インストール種別（git またはパッケージ）、 現在のバージョン、および更新の有無を表示します。

タグ付けのベストプラクティス

• git チェックアウトの到達先にするリリースにはタグを付けます。stable には vYYYY.M.PATCH、 beta には vYYYY.M.PATCH-beta.N を使用します。 -alpha.N、-rc.N、-next.N などの名前付きプレリリースサフィックスは、stable または beta のターゲットではありません。
• vYYYY.M.PATCH-1 や v1.0.1-1 などの従来の数値形式の stable タグも、 互換性のため stable git タグとして引き続き認識されます。
• vYYYY.M.PATCH.beta.N（ドット区切り）も互換性のため認識されます。 -beta.N を推奨します。
• タグを不変に保ってください。タグの移動や再利用は絶対に行わないでください。
• npm インストールでは、npm dist-tag が引き続き信頼できる唯一の情報源です：
  • latest -> stable
  • extended-stable -> サポート対象月を追従するパッケージリリース
  • beta -> 候補ビルドまたは beta を先行させる stable ビルド
  • dev -> main スナップショット（任意）

macOS アプリの提供状況

beta および dev ビルドには、macOS アプリのリリースが含まれない場合があります。これは問題ありません。

• git タグと npm dist-tag は、それぞれ単独でも公開できます。
• リリースノートまたは変更履歴に「この beta には macOS ビルドがありません」と明記してください。

関連項目

• 更新
• インストーラーの内部構造