# openclaw update

Cập nhật OpenClaw an toàn và chuyển đổi giữa các kênh ổn định/beta/dev.

Nếu bạn đã cài đặt qua npm/pnpm/bun (cài đặt toàn cục, không có siêu dữ liệu git), việc cập nhật diễn ra qua luồng trình quản lý gói trong Cập nhật.

# Cách sử dụng

openclaw update
openclaw update status
openclaw update wizard
openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag beta
openclaw update --tag main
openclaw update --dry-run
openclaw update --no-restart
openclaw update --yes
openclaw update --json
openclaw --update

# Tùy chọn

• --no-restart: bỏ qua việc khởi động lại dịch vụ Gateway sau khi cập nhật thành công. Các bản cập nhật qua trình quản lý gói có khởi động lại Gateway sẽ xác minh dịch vụ đã khởi động lại báo cáo phiên bản đã cập nhật như mong đợi trước khi lệnh thành công.
• --channel <stable|beta|dev>: đặt kênh cập nhật (git + npm; được lưu trong cấu hình).
• --tag <dist-tag|version|spec>: ghi đè mục tiêu gói chỉ cho lần cập nhật này. Với các bản cài đặt qua gói, main ánh xạ tới github:openclaw/openclaw#main.
• --dry-run: xem trước các hành động cập nhật dự kiến (luồng channel/tag/target/restart) mà không ghi cấu hình, cài đặt, đồng bộ Plugin hoặc khởi động lại.
• --json: in JSON UpdateRunResult mà máy có thể đọc, bao gồm postUpdate.plugins.warnings khi các Plugin được quản lý bị hỏng hoặc không thể tải cần sửa chữa sau khi cập nhật lõi thành công, và postUpdate.plugins.integrityDrifts khi phát hiện sai lệch hiện vật Plugin npm trong quá trình đồng bộ Plugin sau cập nhật.
• --timeout <seconds>: thời gian chờ cho mỗi bước (mặc định là 1800 giây).
• --yes: bỏ qua các lời nhắc xác nhận (ví dụ xác nhận hạ cấp).

openclaw update không có cờ --verbose. Dùng --dry-run để xem trước các hành động channel/tag/install/restart dự kiến, --json để nhận kết quả máy có thể đọc, và openclaw update status --json khi bạn chỉ cần thông tin về kênh và khả dụng. Nếu bạn đang gỡ lỗi nhật ký Gateway quanh một lần cập nhật, độ chi tiết trên console và cấp nhật ký tệp là riêng biệt: Gateway --verbose ảnh hưởng đến đầu ra terminal/WebSocket, còn nhật ký tệp yêu cầu logging.level: "debug" hoặc "trace" trong cấu hình. Xem nhật ký Gateway.

# update status

Hiển thị kênh cập nhật đang hoạt động + thẻ/nhánh/SHA git (đối với checkout mã nguồn), cùng với tình trạng có bản cập nhật.

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

Tùy chọn:

• --json: in JSON trạng thái mà máy có thể đọc.
• --timeout <seconds>: thời gian chờ cho các bước kiểm tra (mặc định là 3 giây).

# update wizard

Luồng tương tác để chọn kênh cập nhật 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 bạn chọn dev mà không có checkout git, nó sẽ đề nghị tạo một checkout.

Tùy chọn:

• --timeout <seconds>: thời gian chờ cho mỗi bước cập nhật (mặc định 1800)

# Cách hoạt động

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

• dev → bảo đảm có một checkout git (mặc định: ~/openclaw, ghi đè bằng OPENCLAW_GIT_DIR), cập nhật nó, và cài đặt CLI toàn cục từ checkout đó.
• stable → cài đặt từ npm bằng latest.
• beta → ưu tiên dist-tag npm beta, nhưng quay về latest khi beta bị thiếu hoặc cũ hơn bản phát hành ổn định hiện tại.

OpenClaw chưa có kênh hỗ trợ LTS hoặc hằng tháng. Chúng tôi đang hướng tới các dòng hỗ trợ hằng tháng, nhưng --channel hiện chỉ chấp nhận stable, beta, và dev. Dùng --tag <version-or-dist-tag> cho một mục tiêu một lần khi bạn cần một hiện vật gói cụ thể.

Trình tự động cập nhật lõi Gateway (khi được bật qua cấu hình) khởi chạy đường dẫn cập nhật CLI bên ngoài trình xử lý yêu cầu Gateway đang chạy. Các bản cập nhật trình quản lý gói update.run của mặt phẳng điều khiển buộc khởi động lại cập nhật không trì hoãn, không cooldown sau khi hoán đổi gói, vì tiến trình Gateway cũ vẫn có thể còn các đoạn trong bộ nhớ trỏ tới những tệp đã bị gói mới xóa.

Với các bản cài đặt qua trình quản lý gói, openclaw update phân giải phiên bản gói mục tiêu trước khi gọi trình quản lý gói. Các bản cài đặt npm toàn cục dùng một lần cài đặt theo giai đoạn: OpenClaw cài gói mới vào một tiền tố npm tạm thời, xác minh bảng kê dist đã đóng gói ở đó, rồi hoán đổi cây gói sạch đó vào tiền tố toàn cục thực. Nếu xác minh thất bại, doctor sau cập nhật, đồng bộ Plugin, và công việc khởi động lại sẽ không chạy từ cây đáng ngờ. Ngay cả khi phiên bản đã cài đã khớp với mục tiêu, lệnh vẫn làm mới bản cài đặt gói toàn cục, rồi chạy đồng bộ Plugin, làm mới hoàn tất lệnh lõi, và công việc khởi động lại. Điều này giữ cho các sidecar đã đóng gói và bản ghi Plugin do kênh sở hữu đồng bộ với bản dựng OpenClaw đã cài đặt, trong khi để các lần dựng lại hoàn tất lệnh Plugin đầy đủ cho các lần chạy openclaw completion --write-state rõ ràng.

Khi một dịch vụ Gateway được quản lý cục bộ đã được cài đặt và bật khởi động lại, các bản cập nhật qua trình quản lý gói dừng dịch vụ đang chạy trước khi thay thế cây gói, rồi làm mới siêu dữ liệu dịch vụ từ bản cài đặt đã cập nhật, khởi động lại dịch vụ, và xác minh Gateway đã khởi động lại báo cáo phiên bản như mong đợi trước khi báo thành công. Trên macOS, kiểm tra sau cập nhật cũng xác minh LaunchAgent đã được tải/đang chạy cho hồ sơ đang hoạt động và cổng loopback đã cấu hình đang khỏe. Nếu plist đã được cài đặt nhưng launchd không giám sát nó, OpenClaw tự động bootstrap lại LaunchAgent, rồi chạy lại các kiểm tra sẵn sàng về sức khỏe/phiên bản/kênh. Một bootstrap mới tải tác vụ RunAtLoad trực tiếp, nên quá trình khôi phục cập nhật không ngay lập tức kickstart -k Gateway vừa được sinh ra. Nếu Gateway vẫn không trở nên khỏe, lệnh thoát khác 0 và in đường dẫn nhật ký khởi động lại cùng các hướng dẫn khởi động lại, cài đặt lại, và rollback gói rõ ràng. Với --no-restart, việc thay thế gói vẫn chạy nhưng dịch vụ được quản lý không bị dừng hoặc khởi động lại, nên Gateway đang chạy có thể tiếp tục giữ mã cũ cho đến khi bạn khởi động lại thủ công.

# Luồng checkout git

# Chọn kênh

• stable: checkout thẻ không beta mới nhất, rồi build và doctor.
• beta: ưu tiên thẻ -beta mới nhất, nhưng quay về thẻ ổn định mới nhất khi beta bị thiếu hoặc cũ hơn.
• dev: checkout main, rồi fetch và rebase.

# Các bước cập nhật

Trên kênh cập nhật beta, các bản cài Plugin npm và ClawHub được theo dõi đi theo dòng mặc định/latest sẽ thử bản phát hành Plugin @beta trước. Nếu Plugin không có bản phát hành beta, OpenClaw quay về spec mặc định/latest đã ghi. Với Plugin npm, OpenClaw cũng quay về khi gói beta tồn tại nhưng không vượt qua xác thực cài đặt. Các phiên bản chính xác và thẻ rõ ràng không bị viết lại.

# Cú pháp rút gọn --update

openclaw --update được viết lại thành openclaw update (hữu ích cho shell và script khởi chạy).

# Liên quan

• openclaw doctor (đề nghị chạy cập nhật trước trên checkout git)
• Kênh phát triển
• Cập nhật
• Tham chiếu CLI