Development channels

Cập nhật lần cuối: 21/01/2026

OpenClaw cung cấp ba channel cập nhật:

  • stable: npm dist-tag latest.
  • beta: npm dist-tag beta (bản build đang được test).
  • dev: moving head của main (git). npm dist-tag: dev (khi được publish).

Mình sẽ ship các build lên beta, test chúng, rồi promote build đã được kiểm tra lên latest mà không thay đổi số version — dist-tags là nguồn chính xác cho việc cài đặt npm.

Chuyển đổi channel

Git checkout:

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
  • stable/beta check out tag mới nhất khớp với channel (thường là cùng một tag).
  • dev chuyển sang main và rebase trên upstream.

npm/pnpm global install:

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

Lệnh này cập nhật thông qua npm dist-tag tương ứng (latest, beta, dev).

Khi các bạn chủ động chuyển channel bằng --channel, OpenClaw cũng sẽ điều chỉnh phương thức cài đặt:

  • dev đảm bảo có git checkout (mặc định ~/openclaw, ghi đè bằng OPENCLAW_GIT_DIR), cập nhật nó, và cài đặt CLI global từ checkout đó.
  • stable/beta cài đặt từ npm sử dụng dist-tag tương ứng.

Mẹo: nếu muốn dùng song song stable + dev, giữ hai clone riêng và trỏ gateway của bạn vào bản stable.

Plugin và channel

Khi các bạn chuyển channel bằng openclaw update, OpenClaw cũng đồng bộ nguồn plugin:

  • dev ưu tiên các plugin đi kèm từ git checkout.
  • stable và beta khôi phục các package plugin đã cài từ npm.

Best practices cho tagging

  • Tag các release mà bạn muốn git checkout sẽ dùng (vYYYY.M.D hoặc vYYYY.M.D-<patch>).
  • Giữ các tag bất biến: không bao giờ di chuyển hoặc tái sử dụng một tag.
  • npm dist-tags vẫn là nguồn chính xác cho việc cài đặt npm:
    • latest → stable
    • beta → candidate build
    • dev → main snapshot (tùy chọn)

Tính khả dụng của macOS app

Các build beta và dev có thể không bao gồm bản release macOS app. Điều đó không sao:

  • Git tag và npm dist-tag vẫn có thể được publish.
  • Ghi chú “không có macOS build cho beta này” trong release notes hoặc changelog.