Cài đặt

Yêu cầu hệ thống

• Node 24 (khuyến nghị) hoặc Node 22.16+ - tập lệnh cài đặt tự động xử lý việc này
• macOS, Linux, hoặc Windows - hỗ trợ cả Windows gốc và WSL2; WSL2 ổn định hơn. Xem Windows.
• pnpm chỉ cần thiết nếu bạn build từ mã nguồn

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

Cách cài đặt nhanh nhất. Nó phát hiện OS của bạn, 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ờ và tùy chọn CI/tự động hóa, xem nội bộ trình cài đặt.

Phương thức cài đặt thay thế

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

Dùng cách này khi bạn muốn giữ OpenClaw và Node dưới một tiền tố cục bộ như ~/.openclaw, mà không phụ thuộc vào bản cài đặt Node toàn hệ thống:

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

Mặc định nó hỗ trợ cài đặt npm, cùng với cài đặt từ git-checkout theo cùng luồng tiền tố. Tài liệu tham khảo đầy đủ: nội bộ trình cài đặt.

Đã cài đặt rồi? Chuyển đổi giữa bản cài đặt package 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

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

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 checkout 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 link và dùng pnpm openclaw ... từ bên trong repo. Xem Thiết lập để biết đầy đủ các quy trình phát triển.

Cài đặt từ GitHub main

npm install -g github:openclaw/openclaw#main

Container và trình quản lý package

Xác minh cài đặt

openclaw --version      # confirm the CLI is availableopenclaw doctor         # check for config issuesopenclaw gateway status # verify the Gateway is running

Nếu bạn muốn khởi động được quản lý sau khi cài đặt:

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

node -v           # Node installed?npm prefix -g     # Where are global packages?echo "$PATH"      # Is the global bin dir in PATH?

export PATH="$(npm prefix -g)/bin:$PATH"