開発チャンネル

最終更新：2026-01-21

OpenClaw には 3 つのアップデートチャンネルがあります：

  • stable：npm dist-tag latest。
  • beta：npm dist-tag beta（テスト中のビルド）。
  • dev：main の最新状態（git）。npm dist-tag：dev（公開時）。

ビルドをまず beta にリリースし、テスト後、検証済みのビルドを latest に昇格します。バージョン番号は変更しません — npm インストールにおいては dist-tag が正となります。

チャンネルの切り替え

Git チェックアウトの場合：

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
  • stable/beta は最新の一致するタグをチェックアウトします（同じタグの場合もあります）。
  • dev は main に切り替え、upstream にリベースします。

npm/pnpm グローバルインストールの場合：

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

対応する npm dist-tag（latest、beta、dev）を使ってアップデートします。

--channel で明示的にチャンネルを切り替えると、OpenClaw はインストール方法も自動で調整します：

  • dev は Git チェックアウト（デフォルト ~/openclaw、OPENCLAW_GIT_DIR で変更可能）を確保し、更新後、そのチェックアウトからグローバル CLI をインストールします。
  • stable/beta は対応する dist-tag を使って npm からインストールします。

stable と dev を並行して使いたい場合は、2 つのクローンを用意し、Gateway を stable 側に向けてください。

プラグインとチャンネル

openclaw update でチャンネルを切り替えると、OpenClaw はプラグインのソースも同期します：

  • dev は Git チェックアウト内のバンドルプラグインを優先します。
  • stable と beta は npm でインストールされたプラグインパッケージに復元します。

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

  • Git チェックアウトが使用するリリースにはタグを付けてください（stable は vYYYY.M.D、beta は vYYYY.M.D-beta.N）。
  • vYYYY.M.D.beta.N も互換性のため認識されますが、-beta.N を推奨します。
  • レガシーの vYYYY.M.D-<patch> タグは引き続き stable（非 beta）として認識されます。
  • タグは不変にしてください。移動や再利用はしないでください。
  • npm dist-tag が npm インストールの正となります：
    • latest → stable
    • beta → 候補ビルド
    • dev → main のスナップショット（任意）

macOS アプリの提供状況

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

  • Git タグと npm dist-tag は引き続き公開可能です。
  • リリースノートやチェンジログに「この beta には macOS ビルドはありません」と記載してください。
arrow_back
前へ
Northflank
次へ
Channels
arrow_forward