Cài đặt
Khuyến nghị: script cài đặt
Cách nhanh nhất để cài đặt. Script này tự động 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 quá trình onboarding.- macOS / Linux / WSL2
- Windows (PowerShell)
- macOS / Linux / WSL2
- Windows (PowerShell)
Yêu cầu hệ thống
- Node 24 (khuyến nghị) hoặc Node 22.16+ — script cài đặt sẽ tự động xử lý điều này
- macOS, Linux, hoặc Windows — hỗ trợ cả Windows gốc và WSL2; WSL2 ổn định hơn. Xem Windows.
pnpmchỉ cần thiết nếu bạn build từ source
Phương pháp cài đặt thay thế
npm hoặc pnpm
Nếu bạn đã tự quản lý Node:- npm
- pnpm
Khắc phục sự cố: lỗi build sharp (npm)
Khắc phục sự cố: lỗi build sharp (npm)
Nếu
sharp gặp lỗi do libvips được cài đặt toàn cục:Từ source
Dành cho những người đóng góp hoặc ai muốn chạy từ bản checkout cục bộ:pnpm openclaw ... từ trong repo. Xem Setup để biết quy trình phát triển đầy đủ.
Cài đặt từ GitHub main
Containers và trình quản lý package
Docker
Triển khai container hoặc không có giao diện.
Podman
Giải pháp container không root thay thế Docker.
Nix
Cài đặt khai báo qua Nix flake.
Ansible
Cung cấp tự động cho hệ thống.
Bun
Sử dụng chỉ CLI qua runtime Bun.
Xác minh cài đặt
Lưu trữ và triển khai
Triển khai OpenClaw trên máy chủ đám mây hoặc VPS:VPS
Bất kỳ Linux VPS nào
Docker VM
Các bước Docker chia sẻ
Kubernetes
K8s
Fly.io
Fly.io
Hetzner
Hetzner
GCP
Google Cloud
Azure
Azure
Railway
Railway
Render
Render
Northflank
Northflank
Cập nhật, di chuyển, hoặc gỡ cài đặt
Cập nhật
Giữ OpenClaw luôn cập nhật.
Di chuyển
Chuyển sang máy mới.
Gỡ cài đặt
Gỡ bỏ hoàn toàn OpenClaw.
Khắc phục sự cố: openclaw không tìm thấy
Nếu cài đặt thành công nhưng openclaw không tìm thấy trong terminal:
$(npm prefix -g)/bin không có trong $PATH, thêm nó vào file khởi động shell (~/.zshrc hoặc ~/.bashrc):