openclaw update

Cập nhật OpenClaw một cách an toàn và chuyển đổi giữa các channel stable/beta/dev.

Nếu các bạn cài đặt qua npm/pnpm (cài global, không có git metadata), việc cập nhật sẽ thông qua package manager theo hướng dẫn trong Updating.

Cách dùng

openclaw update
openclaw update status
openclaw update wizard
openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag beta
openclaw update --no-restart
openclaw update --json
openclaw --update

Tùy chọn

  • --no-restart: bỏ qua việc khởi động lại Gateway service sau khi cập nhật thành công.
  • --channel <stable|beta|dev>: đặt update channel (git + npm; được lưu trong config).
  • --tag <dist-tag|version>: ghi đè npm dist-tag hoặc version chỉ cho lần cập nhật này.
  • --json: in ra UpdateRunResult JSON dạng machine-readable.
  • --timeout <seconds>: timeout cho mỗi bước (mặc định là 1200s).

Lưu ý: downgrade cần xác nhận vì các phiên bản cũ có thể làm hỏng cấu hình.

update status

Hiển thị update channel đang hoạt động + git tag/branch/SHA (cho source checkouts), cùng với thông tin cập nhật có sẵn.

openclaw update status
openclaw update status --json
openclaw update status --timeout 10

Tùy chọn:

  • --json: in ra status JSON dạng machine-readable.
  • --timeout <seconds>: timeout cho việc kiểm tra (mặc định là 3s).

update wizard

Quy trình tương tác để chọn update channel và xác nhận có khởi động lại Gateway sau khi cập nhật hay không (mặc định là khởi động lại). Nếu các bạn chọn dev mà chưa có git checkout, nó sẽ đề nghị tạo một cái.

Nó làm gì

Khi các bạn chuyển channel một cách rõ ràng (--channel ...), OpenClaw cũng giữ cho phương thức cài đặt được đồng bộ:

  • 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 global CLI từ checkout đó.
  • stable/beta → cài đặt từ npm sử dụng dist-tag tương ứng.

Git checkout flow

Các channel:

  • stable: checkout tag mới nhất không phải beta, sau đó build + doctor.
  • beta: checkout tag -beta mới nhất, sau đó build + doctor.
  • dev: checkout main, sau đó fetch + rebase.

Tổng quan:

  1. Yêu cầu worktree sạch (không có thay đổi chưa commit).
  2. Chuyển sang channel đã chọn (tag hoặc branch).
  3. Fetch upstream (chỉ dev).
  4. Chỉ dev: preflight lint + TypeScript build trong temp worktree; nếu tip fails, quay lại tối đa 10 commits để tìm bản build sạch mới nhất.
  5. Rebase lên commit đã chọn (chỉ dev).
  6. Cài đặt deps (ưu tiên pnpm; fallback npm).
  7. Build + build Control UI.
  8. Chạy openclaw doctor như bước kiểm tra cuối cùng cho “safe update”.
  9. Đồng bộ plugins với active channel (dev dùng bundled extensions; stable/beta dùng npm) và cập nhật các plugins đã cài từ npm.

--update shorthand

openclaw --update được viết lại thành openclaw update (hữu ích cho shells và launcher scripts).

Xem thêm