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

Documentation Index

Fetch the complete documentation index at: https://docs.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.14+ — script 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ị: script cài đặt

Cách cài đặt nhanh nhất. Script phát hiện hệ điều hành, cài Node nếu cần, cài OpenClaw và khởi chạy 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
Để xem tất cả cờ và tùy chọn CI/tự động hóa, xem Nội bộ trình cài đặt.

​
Các 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 trong một tiền tố cục bộ như ~/.openclaw, mà không phụ thuộc vào bản cài Node toàn hệ thống: 
curl -fsSL https://openclaw.ai/install-cli.sh | bash
Theo mặc định, script hỗ trợ cài đặt npm, cùng với cài đặt từ git-checkout trong cùng luồng tiền tố. Tham khảo đầy đủ: Nội bộ trình cài đặt. Đã cài đặt rồi? Chuyển 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 đủ 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 trong container hoặc không giao diện.

Podman

Phương án container không root thay cho 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 bản 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ụ người dùng systemd 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 tác vụ bị từ chối

​
Hosting và triển khai

Triển khai OpenClaw trên máy chủ cloud 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

Cập nhật

Giữ OpenClaw luôn được cập nhật.

Di chuyển

Chuyển sang máy mới.

Gỡ cài đặt

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.