Cài đặt OpenClaw
Cài đặt CLI openclaw bằng script chính thức, trình cài đặt PowerShell hoặc npm, sau đó để trình hướng dẫn thiết lập tạo config, gateway token và dịch vụ chạy nền.
Cài đặt qua npm cần Node.js 24.16+ hoặc 26.1+; các script cài đặt sẽ tự cài Node cho bạn. Hãy chuẩn bị ít nhất 1 vCPU, 1 GB RAM và 500 MB dung lượng đĩa.
Chạy trình cài đặt trên macOS, Linux hoặc WSL2
Script sẽ cài Node nếu cần (Node 26 trên macOS, Node 24 LTS trên Linux) và CLI openclaw, rồi khởi chạy trình hướng dẫn thiết lập. Để cài đặt mà không chạy trình hướng dẫn, hãy pipe vào bash -s -- --no-onboard thay vì chỉ dùng bash.
shell curl -fsSL https://openclaw.ai/install.sh | bashHoặc dùng PowerShell trên Windows
Trên Windows nguyên bản, hãy chạy trình cài đặt PowerShell trong cửa sổ PowerShell. Ứng dụng Hub nguyên bản cho Windows cũng là một lựa chọn; nếu dùng WSL2, bạn có thể dùng script shell ở bước 1.
PowerShell iwr -useb https://openclaw.ai/install.ps1 | iexHoặc cài đặt bằng npm
Nếu tự quản lý Node, hãy cài gói ở phạm vi toàn cục. npm 12 và 11.16+ cần --allow-scripts=openclaw; không dùng cờ này với npm 11.15 trở xuống. Sau đó, onboard --install-daemon sẽ chạy trình hướng dẫn và cài dịch vụ: LaunchAgent trên macOS, dịch vụ systemd dành cho người dùng trên Linux và WSL2, hoặc Scheduled Task trên Windows.
shell npm install -g openclaw@latest --allow-scripts=openclaw openclaw onboard --install-daemonKiểm tra cài đặt
openclaw --version hiển thị bản phát hành đã cài đặt, openclaw doctor chạy các bước kiểm tra tình trạng và openclaw gateway status cho biết dịch vụ gateway có đang chạy hay không. Số phiên bản dựa trên ngày, theo định dạng YYYY.M.N.
shell openclaw --version openclaw doctor openclaw gateway statusLuôn cập nhật
openclaw update cài đặt bản phát hành mới nhất. Dùng --channel để chuyển đổi giữa stable, extended-stable, beta và dev, hoặc --dry-run để xem trước bản cập nhật mà không áp dụng. Bạn cũng có thể dùng openclaw update status và openclaw update repair.
shell openclaw update openclaw update --channel beta openclaw update --dry-run
Trình hướng dẫn thiết lập tạo gateway token và giữ gateway tại 127.0.0.1:18789. Hãy đọc hướng dẫn tăng cường bảo mật trước khi kết nối kênh chat.