Cài đặt

Yêu cầu hệ thống

• Node 24 (khuyến nghị) hoặc Node 22.19+ - script 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 với ứng dụng Windows Hub gốc, trình cài đặt CLI PowerShell, hoặc WSL2 Gateway. Xem Windows.
• pnpm chỉ cần thiết nếu bạn build từ mã nguồn

Khuyến nghị: script cài đặt

Cách cài đặt nhanh nhất. Script phát hiện hệ điều hành của bạn, cài Node nếu cần, cài OpenClaw và khởi chạy onboarding.

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

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

Để cài đặt mà không chạy onboarding:

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

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

Để xem tất cả flag và tùy chọn CI/tự động hóa, xem nội bộ trình cài đặt.

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

Trình cài đặt prefix 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 prefix cục bộ như ~/.openclaw, không phụ thuộc vào bản cài Node toàn hệ thống:

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

Theo mặc định, script hỗ trợ cài đặt npm, cùng với cài đặt git-checkout trong cùng luồng prefix. 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 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

Từ mã nguồn

Dành cho contributor 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 đủ workflow phát triển.

Cài đặt từ checkout main trên GitHub

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

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

Xác minh bản 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 startup đượ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ụ người dùng systemd qua các lệnh tương tự
• Windows gốc: ưu tiên Scheduled Task, với mục đăng nhập theo người dùng trong thư mục Startup làm phương án dự phòng nếu việc tạo task bị từ chối

Hosting và triển khai

Triển khai OpenClaw trên cloud server hoặc VPS:

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

Nếu cài đặt thành công nhưng không tìm thấy openclaw trong terminal của bạn:

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

Nếu $(npm prefix -g)/bin không có trong $PATH của bạn, hãy thêm nó vào file startup của shell (~/.zshrc hoặc ~/.bashrc):

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

Sau đó mở terminal mới. Xem thiết lập Node để biết thêm chi tiết.