Cài đặt

Yêu cầu hệ thống

• Node 22.22.3+, 24.15+ hoặc 25.9+ - 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 với ứng dụng Windows Hub gốc, trình cài đặt CLI bằng PowerShell hoặc Gateway trên WSL2. Xem Windows.
• pnpm chỉ cần thiết nếu bạn biên dịch từ mã nguồn.

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

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

Để xem tất 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 tiền tố cục bộ (install-cli.sh)

Sử dụng cách 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 checkout 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ừ bản 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 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 checkout nhánh 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ý gói

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

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

Nếu bạn muốn khởi động được quản lý 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 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 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 để biết đầy đủ công cụ chọn nhà cung cấp (DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway, Northflank, Oracle Cloud, Raspberry Pi và nhiều nhà cung cấp 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à sự cố 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 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?