Cài đặt

# Yêu cầu hệ thống

• Node 24 (khuyến nghị) hoặc Node 22.14+ - script 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.
• Chỉ cần pnpm nếu bạn build từ source

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

Cách cài đặt nhanh nhất. Script 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 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

Để biết tất cả flag và tùy chọn CI/tự động hóa, xem Thông tin 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 prefix cục bộ (install-cli.sh)

Dùng cách này khi bạn muốn giữ OpenClaw và Node trong một prefix cục bộ như ~/.openclaw, 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

Theo mặc định, script hỗ trợ cài đặt qua npm, cùng với cài đặt từ git-checkout trong cùng luồng prefix. Tham khảo đầy đủ: Thông tin nội bộ của 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@latest
openclaw onboard --install-daemon

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

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

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

# Từ source

Dành cho cộng tác viên hoặc bất kỳ ai muốn chạy từ checkout cục bộ:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw 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ừ 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 available
openclaw doctor         # check for config issues
openclaw 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 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 Startup-folder theo từng người dùng làm 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 server đá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"