Cài đặt

Yêu cầu hệ thống

• Node 22.19+, 23.11+ hoặc 24+ - Node 24 là phiên bản đích mặc định; tập lệnh cài đặt tự động xử lý việc này.
• macOS, Linux hoặc Windows - Người dùng Windows có thể bắt đầu bằng ứng dụng Windows Hub gốc, trình cài đặt CLI PowerShell hoặc Gateway trên WSL2. Xem Windows.
• Chỉ cần pnpm nếu bạn biên dịch từ mã nguồn.

Khuyến nghị: tập lệnh cài đặt

Đây là cách cài đặt nhanh nhất. Tập lệnh phát hiện hệ điều hành, cài đặt Node nếu cần, cài đặt OpenClaw và khởi chạy quy trình thiết lập ban đầu.

curl -fsSL https://openclaw.ai/install.sh | bash

iwr -useb https://openclaw.ai/install.ps1 | iex

Để cài đặt mà không chạy quy trình thiết lập ban đầu:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Để biết tất cả các cờ và tùy chọn CI/tự động hóa, hãy xem Chi tiết nội bộ của trình cài đặt.

Các phương thức cài đặt thay thế

Trình cài đặt với tiền tố cục bộ (install-cli.sh)

Sử dụng phương thức này khi bạn muốn giữ OpenClaw và Node trong một tiền tố cục bộ như ~/.openclaw mà không phụ thuộc vào bản cài đặt Node trên toàn hệ thống:

curl -fsSL https://openclaw.ai/install-cli.sh | bash

Theo mặc định, trình cài đặt hỗ trợ cài đặt bằng npm, cùng với cài đặt từ bản sao làm việc git trong cùng quy trình tiền tố. Tài liệu tham khảo đầy đủ: Chi tiết nội bộ của trình cài đặt.

Đã cài đặt? Chuyển đổi giữa bản cài đặt từ gói và git bằng openclaw update --channel dev và openclaw update --channel stable. Xem Cập nhật.

npm, pnpm hoặc bun

Nếu bạn đã tự quản lý Node:

npm install -g openclaw@latestopenclaw onboard --install-daemon

pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

bun add -g openclaw@latestopenclaw onboard --install-daemon

Từ mã nguồn

Dành cho người đóng góp hoặc bất kỳ ai muốn chạy từ một bản sao làm việc cục bộ:

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemon

Hoặc bỏ qua bước liên kết và sử dụng pnpm openclaw ... từ bên trong kho lưu trữ. Xem Thiết lập để biết đầy đủ các quy trình phát triển.

Cài đặt từ bản sao làm việc nhánh main trên GitHub

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

Bộ chứa và trình quản lý gói

Xác minh bản cài đặt

openclaw --version      # xác nhận CLI khả dụngopenclaw doctor         # kiểm tra các vấn đề về cấu hìnhopenclaw gateway status # xác minh Gateway đang chạy

Nếu bạn muốn hệ thống tự quản lý việc khởi động sau khi cài đặt:

• macOS: LaunchAgent thông qua openclaw onboard --install-daemon hoặc openclaw gateway install
• Linux/WSL2: dịch vụ người dùng systemd thông qua các lệnh tương tự
• Windows gốc: ưu tiên Scheduled Task, với phương án dự phòng là mục đăng nhập trong thư mục Startup của từng người dùng nếu việc tạo tác vụ bị từ chối

Lưu trữ và triển khai

Triển khai OpenClaw trên máy chủ đám mây hoặc VPS. Xem Máy chủ Linux để dùng công cụ chọn nhà cung cấp đầy đủ (DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway, Northflank, Oracle Cloud, Raspberry Pi và nhiều lựa chọn khác), hoặc triển khai theo cách khai báo trên Render.

Cập nhật, di chuyển hoặc gỡ cài đặt

Khắc phục sự cố: không tìm thấy openclaw

Hầu như luôn là vấn đề về PATH: thư mục tệp nhị phân toàn cục của npm không có trong PATH của shell. Xem Khắc phục sự cố Node.js để biết cách khắc phục đầy đủ, bao gồm cả đường dẫn trên Windows.

node -v           # Node đã được cài đặt?npm prefix -g     # Các gói toàn cục nằm ở đâu?echo "$PATH"      # Thư mục tệp nhị phân toàn cục có trong PATH không?