Yêu cầu Hệ thống OpenClaw

Đảm bảo môi trường của bạn đáp ứng các yêu cầu cơ bản trước khi cài đặt.

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

OpenClaw yêu cầu Node.js 22 trở lên và hỗ trợ macOS, Linux và Windows qua WSL2. Đối với hầu hết người dùng, một chiếc laptop hiện đại là đủ trừ khi bạn chạy các mô hình cục bộ hoặc tự động hóa nặng.

Tại sao cần Node.js 22+

Thời gian chạy phụ thuộc vào các tính năng hiện đại của Node và các dependency được cập nhật. Sử dụng phiên bản Node cũ hơn thường dẫn đến lỗi cài đặt hoặc quy trình gateway bị treo khi quá tải.

Hệ điều hành được hỗ trợ

macOS và Linux được hỗ trợ nguyên bản. Người dùng Windows nên chạy OpenClaw qua WSL2 để có môi trường giống Unix ổn định. Nếu bạn lưu trữ trên máy chủ, Linux là tùy chọn dự đoán được nhất.

Hướng dẫn phần cứng theo trường hợp sử dụng

Nếu bạn chỉ sử dụng các mô hình đám mây, yêu cầu về CPU và bộ nhớ vẫn ở mức khiêm tốn. Nếu bạn dự định chạy các mô hình cục bộ hoặc nhiều kênh cùng lúc, nhiều RAM và dung lượng lưu trữ hơn sẽ hữu ích. Giữ đủ dung lượng đĩa cho các tệp nhật ký, bộ nhớ cache và dữ liệu kỹ năng.

Tối thiểu so với khuyến nghị

Một chiếc laptop hiện đại với 8 GB RAM thường là đủ cho các mô hình đám mây và tự động hóa nhẹ. Đối với các tác vụ nặng hơn, 16 GB trở lên là một ngưỡng an toàn hơn. Nên sử dụng ổ SSD để truy cập nhật ký, bộ nhớ cache và tải xuống mô hình nhanh hơn.

Cân nhắc về mạng

OpenClaw có thể chạy hoàn toàn cục bộ, nhưng nhiều người dùng kết nối với các API mô hình bên ngoài. Đảm bảo quyền truy cập HTTPS đi ra ngoài được cho phép và ổn định. Nếu mạng của bạn bị khóa, hãy lên kế hoạch cho cài đặt proxy và xác nhận rằng các cổng gateway không bị lộ công khai.

Quyền người dùng và chế độ daemon

Cài đặt và chạy OpenClaw dưới một tài khoản người dùng thông thường, không phải tài khoản hệ thống có quyền cao. Nếu bạn sử dụng chế độ daemon, hãy xác minh rằng dịch vụ khởi động khi khởi động và thư mục làm việc của nó có thể đọc và ghi. Quyền không chính xác là nguyên nhân phổ biến gây ra lỗi thầm lặng.

Kiểm tra môi trường nhanh

Check your Node version first, then run openclaw doctor after install. Fixing missing dependencies early saves hours of debugging later.

Tham khảo chính thức

Use the official install requirements as the authoritative source: Install requirements .