Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw update
Cập nhật OpenClaw một cách an toàn và chuyển đổi giữa các kênh stable/beta/dev.
Nếu bạn cài đặt qua npm/pnpm/bun (cài đặt global, không có siêu dữ liệu git),
các bản cập nhật sẽ diễn ra qua luồng trình quản lý gói trong Cập nhật.
Cách sử dụng
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 bằng trình quản lý gói có khởi động lại Gateway sẽ xác minh rằng 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 gói,mainánh xạ tớigithub:openclaw/openclaw#main.--dry-run: xem trước các hành động cập nhật dự kiến (kênh/thẻ/mục tiêu/luồng khởi động lại) mà không ghi cấu hình, cài đặt, đồng bộ Plugin, hoặc khởi động lại.--json: in JSONUpdateRunResultmà máy có thể đọc, bao gồmpostUpdate.plugins.integrityDriftskhi phát hiện sai lệch artifact 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 lời nhắc xác nhận (ví dụ xác nhận hạ cấp).
update status
Hiển thị kênh cập nhật đang hoạt động + thẻ/nhánh/SHA git (đối với checkout từ mã nguồn), cùng với trạng thái có bản cập nhật hay không.
--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 một 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, luồng này
sẽ đề xuất 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 định1800)
Chức nă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 căn chỉnh:
dev→ đảm bảo có checkout git (mặc định:~/openclaw, ghi đè bằngOPENCLAW_GIT_DIR), cập nhật checkout đó, rồi cài đặt CLI global từ checkout đó.stable→ cài đặt từ npm bằnglatest.beta→ ưu tiên dist-tag npmbeta, nhưng quay vềlatestkhi beta bị thiếu hoặc cũ hơn bản phát hành stable hiện tạ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 global sử dụng cài đặt theo giai đoạn:
OpenClaw cài đặt gói mới vào một tiền tố npm tạm thời, xác minh
inventory dist đã đóng gói ở đó, rồi hoán đổi cây gói sạch đó vào
tiền tố global thật. Nếu xác minh thất bại, doctor sau cập nhật, đồng bộ Plugin và
việc khởi động lại sẽ không chạy từ cây đáng nghi đó. Ngay cả khi phiên bản đã cài đặt
đã khớp với mục tiêu, lệnh vẫn làm mới bản cài đặt gói global,
sau đó chạy đồng bộ Plugin, làm mới hoàn tất lệnh lõi, và 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 được căn chỉnh với
bản dựng OpenClaw đã cài đặt, đồng thời để 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 dịch vụ Gateway được quản lý cục bộ đã được cài đặt và khởi động lại được bật,
các bản cập nhật bằng trình quản lý gói sẽ dừng dịch vụ đang chạy trước khi thay thế cây gói,
sau đó 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 mong đợi. 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 dùng 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 phải beta mới nhất, rồi build và doctor.beta: ưu tiên thẻ-betamới nhất, nhưng quay về thẻ stable mới nhất khi beta bị thiếu hoặc cũ hơn.dev: checkoutmain, rồi fetch và rebase.
Các bước cập nhật
Preflight build (dev only)
Chạy lint và bản dựng TypeScript trong một worktree tạm. Nếu tip thất bại, lùi lại tối đa 10 commit để tìm bản dựng sạch mới nhất.
Install dependencies
Sử dụng trình quản lý gói của repo. Với các checkout pnpm, trình cập nhật bootstrap
pnpm theo nhu cầu (qua corepack trước, rồi dự phòng bằng npm install pnpm@10 tạm thời) thay vì chạy npm run build bên trong workspace pnpm.Lỗi đồng bộ Plugin sau cập nhật làm kết quả cập nhật thất bại và dừng công việc khởi động lại tiếp theo. Hãy sửa lỗi cài đặt hoặc cập nhật Plugin, rồi chạy lại
openclaw update.Khi Gateway đã cập nhật khởi động, các phụ thuộc runtime của Plugin đi kèm đã bật sẽ được staged trước khi kích hoạt Plugin. Các lần khởi động lại do cập nhật kích hoạt sẽ hoàn tất mọi staging phụ thuộc runtime đang hoạt động trước khi đóng Gateway, nên các lần khởi động lại của trình quản lý dịch vụ không làm gián đoạn một lượt cài đặt npm đang chạy.Nếu bootstrap pnpm vẫn thất bại, trình cập nhật sẽ dừng sớm với lỗi dành riêng cho trình quản lý gói thay vì thử npm run build bên trong checkout.Cách viết tắt --update
openclaw --update được viết lại thành openclaw update (hữu ích cho shell và script launcher).
Liên quan
openclaw doctor(đề xuất chạy cập nhật trước trên các checkout git)- Kênh phát triển
- Cập nhật
- Tham chiếu CLI