リリースチャネル

• stable: npm dist-tag latest。ほとんどのユーザーに推奨されます。
• extended-stable: npm dist-tag extended-stable。新規の、サポート対象月を後追いする パッケージチャネルです。このリリースではパッケージ専用かつフォアグラウンド専用です。
• beta: npm dist-tag beta。beta がない場合、または現在の stable リリースより古い場合は latest にフォールバックします。
• dev: main (git) の移動ヘッド。公開されている場合は npm dist-tag dev。main は実験とアクティブな開発向けです。不完全な機能や破壊的変更が含まれる場合があります。 本番 Gateway では実行しないでください。

​

チャネルの切り替え

openclaw update --channel stable
openclaw update --channel extended-stable
openclaw update --channel beta
openclaw update --channel dev

​

単発のバージョンまたはタグ指定

# Install a specific version
openclaw update --tag 2026.4.1-beta.1

# Install from the beta dist-tag (one-off, does not persist)
openclaw update --tag beta

# Switch to the moving GitHub main checkout (persistent)
openclaw update --channel dev

# Install a specific npm package spec
openclaw update --tag openclaw@2026.4.1-beta.1

# Install from GitHub main once without persisting the channel
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 の単発エイリアスではなく、--tag を有効な extended-stable チャネルと組み合わせることはできません。
• --channel beta は --tag beta と異なります。チャネルフローは beta がない場合や古い場合に stable/latest へフォールバックできますが、--tag beta は常にその1回の実行で生の beta dist-tag を対象にします。

​

ドライラン

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

​

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 チェックアウトを着地させたいリリースにタグを付けます。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 dist-tag は npm インストールの信頼できる情報源のままです:
  • latest -> stable
  • extended-stable -> サポート対象月を後追いするパッケージリリース
  • beta -> 候補ビルドまたは beta-first stable ビルド
  • dev -> main スナップショット (任意)

​

macOS アプリの提供状況

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

​

関連

• 更新
• インストーラー内部