Chuyển đến nội dung chính

​
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.
Người dùng desktop Windows cũng có thể cài ứng dụng đồng hành Windows Hub gốc, bao gồm thiết lập, trạng thái khay hệ thống, chat, chế độ node và chế độ MCP cục bộ.
curl -fsSL https://openclaw.ai/install.sh | bash
Để cài đặt mà không chạy onboarding: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Để 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@latest
openclaw onboard --install-daemon
Trình cài đặt được host sẽ bỏ qua các bộ lọc độ mới npm như min-release-age cho việc cài package OpenClaw. Nếu bạn cài thủ công bằng npm, chính sách npm của bạn vẫn được áp dụng.

​
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.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ừ 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

Docker

Triển khai dạng container hoặc headless.

Podman

Giải pháp container không cần root thay thế Docker.

Nix

Cài đặt khai báo qua Nix flake.

Ansible

Cấp phát fleet tự động.

Bun

Chỉ dùng CLI qua runtime Bun.

​
Xác minh bản 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 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:

VPS

Bất kỳ Linux VPS nào.

Docker VM

Các bước Docker dùng chung.

Kubernetes

Triển khai K8s.

Fly.io

Triển khai trên Fly.io.

Hetzner

Triển khai Hetzner.

GCP

Triển khai Google Cloud.

Azure

Triển khai Azure.

Railway

Triển khai Railway.

Render

Triển khai Render.

Northflank

Triển khai Northflank.

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

Updating

Luôn cập nhật OpenClaw.

Migrating

Chuyển sang máy mới.

Uninstall

Gỡ bỏ OpenClaw hoàn toàn.

​
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.