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

​
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. 
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
Để biết tất cả các cờ và tùy chọn CI/tự động hóa, xem Installer internals.

​
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.
  • pnpm chỉ 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 install -g openclaw@latest
openclaw onboard --install-daemon
Nếu sharp gặp lỗi do libvips được cài đặt toàn cục:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

​
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ộ: 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon
Hoặc bỏ qua bước link và sử dụng pnpm openclaw ... từ trong repo. Xem Setup để biết quy trình phát triển đầy đủ.

​
Cài đặt từ GitHub main

npm install -g github:openclaw/openclaw#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

openclaw --version      # xác nhận CLI có sẵn
openclaw doctor         # kiểm tra các vấn đề cấu hình
openclaw gateway status # xác minh Gateway đang chạy

​
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: 
node -v           # Node đã cài đặt chưa?
npm prefix -g     # Các package toàn cục nằm ở đâu?
echo "$PATH"      # Thư mục bin toàn cục có trong PATH không?
Nếu $(npm prefix -g)/bin không có trong $PATH, thêm nó vào file khởi động shell (~/.zshrc hoặc ~/.bashrc): 
export PATH="$(npm prefix -g)/bin:$PATH"
Sau đó mở một terminal mới. Xem Node setup để biết thêm chi tiết.
Last modified on March 22, 2026