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

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Yêu cầu hệ thống

  • Node 24 (khuyến nghị) hoặc Node 22.16+ - tập lệnh cài đặt tự động xử lý việc 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ừ mã nguồn

​
Khuyến nghị: tập lệnh cài đặt

Cách cài đặt nhanh nhất. Nó phát hiện OS của bạn, 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. 
curl -fsSL https://openclaw.ai/install.sh | bash
Để cài đặt mà không chạy quy trình thiết lập ban đầu: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Để biết tất cả cờ và tùy chọn CI/tự động hóa, xem nội bộ trình cài đặt.

​
Phương thức cài đặt thay thế

​
Trình cài đặt tiền tố cục bộ (install-cli.sh)

Dùng cách này khi bạn muốn giữ OpenClaw và Node dưới một tiền tố cục bộ như ~/.openclaw, mà không phụ thuộc vào bản cài đặt Node toàn hệ thống: 
curl -fsSL https://openclaw.ai/install-cli.sh | bash
Mặc định nó hỗ trợ cài đặt npm, cùng với cài đặt từ git-checkout theo cùng luồng tiền tố. Tài liệu tham khảo đầy đủ: nội bộ trình cài đặt. Đã cài đặt rồi? Chuyển đổi giữa bản cài đặt package 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: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
Nếu sharp lỗi do libvips được cài đặt toàn cục:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

​
Từ mã nguồn

Dành cho người đóng góp hoặc bất kỳ ai muốn chạy từ một checkout cục bộ: 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
Hoặc bỏ qua bước link và dùng pnpm openclaw ... từ bên trong repo. Xem Thiết lập để biết đầy đủ các quy trình phát triển.

​
Cài đặt từ GitHub main

npm install -g github:openclaw/openclaw#main

​
Container và trình quản lý package

Docker

Triển khai dạng container hoặc headless.

Podman

Giải pháp container không root thay thế Docker.

Nix

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

Ansible

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

Bun

Chỉ dùng CLI qua runtime Bun.

​
Xác minh cài đặt

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw gateway status # verify the Gateway is running
Nếu bạn muốn khởi động được quản lý sau khi cài đặt:
  • macOS: LaunchAgent qua openclaw onboard --install-daemon hoặc openclaw gateway install
  • Linux/WSL2: dịch vụ systemd của người dùng qua cùng các lệnh
  • Windows gốc: Scheduled Task trước, 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 task 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:

VPS

Bất kỳ VPS Linux nào

Docker VM

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

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

Updating

Luôn cập nhật OpenClaw.

Migrating

Chuyển sang máy mới.

Uninstall

Gỡ bỏ OpenClaw hoàn toàn.

​
Khắc phục sự cố: không tìm thấy openclaw

Nếu cài đặt thành công nhưng terminal của bạn không tìm thấy openclaw: 
node -v           # Node installed?
npm prefix -g     # Where are global packages?
echo "$PATH"      # Is the global bin dir in PATH?
Nếu $(npm prefix -g)/bin không nằm trong $PATH, hãy thêm nó vào tệp khởi động shell của bạn (~/.zshrc hoặc ~/.bashrc): 
export PATH="$(npm prefix -g)/bin:$PATH"
Sau đó mở terminal mới. Xem thiết lập Node để biết thêm chi tiết.