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

​
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.
Người dùng máy tính Windows cũng có thể cài đặt ứ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, trò chuyện, chế độ node và chế độ MCP cục bộ.
Để cài đặt mà không chạy quy trình thiết lập ban đầu:
Để 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:
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:
Trình cài đặt được lưu trữ sẽ xóa các bộ lọc độ mới của npm như min-release-age khi cài đặt gói OpenClaw. Nếu bạn cài đặt thủ công bằng npm, chính sách npm của riêng bạn vẫn được áp dụng.

​
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ộ:
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

​
Container và trình quản lý gói

Docker

Triển khai trong container hoặc không giao diện.

Podman

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

Nix

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

Ansible

Cấp phát tự động cho đội máy.

Bun

Trình cài đặt phần phụ thuộc và trình chạy tập lệnh gói tùy chọn.

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

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.

VPS

Chọn một nhà cung cấp.

Máy ảo Docker

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

Kubernetes

Triển khai K8s.

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

Cập nhật

Luôn cập nhật OpenClaw lên phiên bản mới nhất.

Di chuyển

Chuyển sang một máy mới.

Gỡ cài đặt

Xóa hoàn toàn OpenClaw.

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