Các kênh phát triển¶

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

OpenClaw cung cấp ba kênh cập nhật:

• stable: nhãn npm dist-tag latest.
• beta: npm dist-tag beta (các bản build đang được thử nghiệm).
• Tùy chọn này chấp nhận một dan sách phân tách bằng dấu phẩy các Docker bind mount và áp dụng chúng cho cả openclaw-gateway và openclaw-cli bằng cách tạo docker-compose.extra.yml. npm dist-tag: dev (khi phát hành).

Chúng tôi phát hành các bản build lên beta, kiểm thử chúng, sau đó thăng cấp một bản build đã được thẩm định lên latest mà không thay đổi số phiên bản — dist-tag là nguồn chân lý cho các cài đặt npm.

Chuyển đổi kênh¶

Git checkout:

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

• stable/beta checkout thẻ phù hợp mới nhất (thường là cùng một thẻ).
• dev chuyển sang main và rebase theo upstream.

Cài đặt toàn cục bằng npm/pnpm:

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

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

Khi bạn chủ động chuyển kênh bằng --channel, OpenClaw cũng căn chỉnh phương thức cài đặt:

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

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

Plugin và kênh¶

Khi bạn chuyển kênh 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 gói plugin đã cài từ npm.

Thực hành tốt nhất khi gắn thẻ¶

• Gắn thẻ các bản phát hành mà bạn muốn git checkout trỏ tới (vYYYY.M.D hoặc vYYYY.M.D-<patch>).
• Giữ thẻ bất biến: không bao giờ di chuyển hoặc tái sử dụng một thẻ.
• npm dist-tag vẫn là nguồn chân lý cho các cài đặt npm:
• latest → stable
• beta → bản build ứng viên
• dev → ảnh chụp main (tùy chọn)

Khả dụng của ứng dụng macOS¶

Beta and dev builds may not include a macOS app release. That’s OK:

• Git tag và npm dist-tag vẫn có thể được phát hành.
• Nêu rõ “không có bản build macOS cho bản beta này” trong ghi chú phát hành hoặc changelog.