Cách cài đặt OpenClaw

Sử dụng trình cài đặt chính thức và hoàn thành trình hướng dẫn onboarding để có thiết lập nhanh nhất và an toàn nhất.

Câu trả lời ngắn gọn

Confirm system requirements (Node.js 22+, macOS or Linux or Windows via WSL2), run the official install script, then complete openclaw onboard to connect channels and models.

Bước 1: Kiểm tra yêu cầu trước

OpenClaw phụ thuộc vào các tính năng Node hiện đại, vì vậy yêu cầu Node.js 22 trở lên. Trên Windows, đường dẫn được hỗ trợ là WSL2. Cài đặt trên các phiên bản Node cũ hơn là nguyên nhân phổ biến nhất gây ra lỗi.

Bước 2: Sử dụng script cài đặt chính thức

Phương pháp được khuyến nghị cài đặt CLI và chuẩn bị môi trường runtime:

curl -fsSL https://openclaw.bot/install.sh | bash
openclaw onboard --install-daemon

Bước 3: Hoàn tất onboarding

Trình hướng dẫn sẽ hướng dẫn bạn ghép nối kênh nhắn tin, chọn nhà cung cấp mô hình và bật các kỹ năng. Đây là nơi bạn đặt quyền ban đầu và xác nhận những gì OpenClaw có thể truy cập.

Các lệnh hữu ích sau khi cài đặt

Use openclaw doctor to validate dependencies, openclaw status or openclaw health to check the gateway, and openclaw update to stay current.

Xác minh cài đặt trước khi sử dụng trong môi trường sản xuất

Sau khi onboarding, hãy chạy một tác vụ thử nghiệm nhỏ sử dụng một kỹ năng có rủi ro thấp, chẳng hạn như tạo tệp trong thư mục tạm thời hoặc tóm tắt tệp văn bản cục bộ. Điều này xác nhận rằng kênh, mô hình và kỹ năng của bạn được kết nối chính xác. Nếu bạn đang triển khai trên máy chủ, hãy xác minh rằng chỉ các cổng cần thiết mới được mở và việc ghép nối quản trị được thực thi.

Các vấn đề cài đặt phổ biến

Most failures come from an outdated Node version, missing build tools, or running the script under the wrong user account. Another frequent issue is partial installs caused by network errors during package download. If the CLI behaves inconsistently, re-run the install script and check logs with openclaw doctor .

Nhắc nhở về bảo mật

Không phơi bày các điểm cuối quản trị ra internet công cộng và tránh cài đặt các kỹ năng không đáng tin cậy. Nếu bạn chạy OpenClaw trên máy chủ, hãy khóa các cổng và sử dụng quyền truy cập tối thiểu.

Tài liệu tham khảo chính thức

For exact instructions, see the official install and wizard pages: Install and Onboard .