Skip to main content

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
  • pnpm chỉ 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

The installer script is the recommended way to install OpenClaw. It handles Node detection, installation, and onboarding in one step.

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.
Nếu bạn đã có Node 22+ và muốn tự quản lý việc cài đặt:
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:
If you need custom runtime paths, use:
  • OPENCLAW_HOME for home-directory based internal paths
  • OPENCLAW_STATE_DIR for mutable state location
  • OPENCLAW_CONFIG_PATH for config file location
See Environment vars for precedence and full details.

Xử lý sự cố: không tìm thấy openclaw

Chẩn đoán nhanh:
Nếu $(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):
Trên Windows, thêm đầu ra của 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.