Kanały rozwojowe

Ostatnia aktualizacja: 2026-01-21

OpenClaw udostępnia trzy kanały aktualizacji:

• stable: npm dist-tag latest.
• beta: npm dist-tag beta (buildy w trakcie testowania).
• dev: bieżący HEAD gałęzi main (git). npm dist-tag: dev (jeśli opublikowany).

Publikujemy buildy do beta, testujemy je, a następnie promujemy sprawdzony build do latest bez zmiany numeru wersji — dist-tagi są źródłem prawdy dla instalacji przez npm.

Przełączanie kanałów

Git checkout:

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

• stable/beta przełączają na najnowszy pasujący tag (często ten sam tag).
• dev przełącza na main i rebasuje na upstream.

Globalna instalacja npm/pnpm:

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

Aktualizacja odbywa się przez odpowiedni npm dist-tag (latest, beta, dev).

Kiedy jawnie przełączysz kanał z --channel, OpenClaw wyrównuje też metodę instalacji:

• dev zapewnia git checkout (domyślnie ~/openclaw, nadpisz przez OPENCLAW_GIT_DIR), aktualizuje go i instaluje globalne CLI z tego checkout.
• stable/beta instalują z npm, używając odpowiedniego dist-taga.

Wskazówka: jeśli chcesz mieć stable + dev równolegle, utrzymuj dwa klony i wskaż bramę na stabilny.

Pluginy a kanały

Gdy przełączasz kanały przez openclaw update, OpenClaw synchronizuje też źródła pluginów:

• dev preferuje wbudowane pluginy z git checkout.
• stable i beta przywracają pakiety pluginów zainstalowane przez npm.

Dobre praktyki tagowania

• Taguj wydania, na których mają lądować git checkout (vYYYY.M.D dla stable, vYYYY.M.D-beta.N dla beta).
• vYYYY.M.D.beta.N jest też rozpoznawany ze względu na kompatybilność, ale preferuj -beta.N.
• Starsze tagi vYYYY.M.D-<patch> są nadal rozpoznawane jako stable (nie-beta).
• Tagi powinny być niezmienne: nigdy nie przenoś ani nie używaj ponownie taga.
• npm dist-tagi pozostają źródłem prawdy dla instalacji npm:
  • latest → stable
  • beta → build kandydujący
  • dev → snapshot gałęzi main (opcjonalny)

Dostępność aplikacji macOS

Buildy beta i dev mogą nie zawierać wydania aplikacji macOS. To normalne:

• Git tag i npm dist-tag mogą być nadal opublikowane.
• Zaznacz „brak buildu macOS dla tego beta” w notatkach wydania lub changelogu.