Cài đặt
Already followed Getting Started? You’re all set — this page is for alternative install methods, platform-specific instructions, and maintenance.Yêu cầu hệ thống
- Node 22+ (script cài đặt sẽ tự cài nếu thiếu)
- macOS, Linux hoặc Windows
pnpmchỉ khi bạn build từ mã nguồn
Trên Windows, chúng tôi đặc biệt khuyến nghị chạy OpenClaw dưới WSL2.
Phương thức cài đặt
Installer script
Installer script
Tải CLI, cài đặt toàn cục qua npm và khởi chạy trình hướng dẫn onboarding.
npm / pnpm
npm / pnpm
Nếu bạn đã có Node 22+ và muốn tự quản lý việc cài đặt:
From source
From source
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ộ.
Các phương thức cài đặt khác
Docker
Triển khai dạng container hoặc headless.
Podman
Cài đặt khai báo qua Nix.
Nix
Cấp phát đội máy tự động.
Ansible
Chỉ dùng CLI qua runtime Bun.
Bun
Chỉ dùng CLI qua runtime Bun.
Sau khi cài đặt
Xác minh mọi thứ hoạt động bình thường:OPENCLAW_HOMEfor home-directory based internal pathsOPENCLAW_STATE_DIRfor mutable state locationOPENCLAW_CONFIG_PATHfor config file location
Xử lý sự cố: không tìm thấy openclaw
PATH diagnosis and fix
PATH diagnosis and fix
Chẩn đoán nhanh:Nếu Trên Windows, thêm đầu ra của
$(npm prefix -g)/bin (macOS/Linux) hoặc $(npm prefix -g) (Windows) không nằm trong $PATH của bạn, shell của bạn không thể tìm thấy các binary npm toàn cục (bao gồm openclaw).Cách khắc phục — thêm nó vào file khởi động shell của bạn (~/.zshrc hoặc ~/.bashrc):npm prefix -g vào PATH của bạn.Then open a new terminal (or rehash in zsh / hash -r in bash).Cập nhật / gỡ cài đặt
Updating
Giữ OpenClaw luôn được cập nhật.
Migrating
Chuyển sang máy mới.
Uninstall
Gỡ OpenClaw hoàn toàn.