> ## 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.

# Cài đặt

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

* **Node 22.22.3+, 24.15+ hoặc 25.9+** - Node 24 là phiên bản đích mặc định; tập lệnh cài đặt tự động xử lý việc này.
* **macOS, Linux hoặc Windows** - Người dùng Windows có thể bắt đầu với ứng dụng Windows Hub gốc, trình cài đặt CLI bằng PowerShell hoặc Gateway trên WSL2. Xem [Windows](/vi/platforms/windows).
* `pnpm` chỉ cần thiết nếu bạn biên dịch từ mã nguồn.

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

Cách cài đặt nhanh nhất. Tập lệnh 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 quy trình thiết lập ban đầu.

<Note>
  Người dùng máy tính Windows cũng có thể cài đặt ứng dụng đồng hành [Windows Hub](/vi/platforms/windows#recommended-windows-hub) gốc, bao gồm thiết lập, trạng thái khay hệ thống, trò chuyện, chế độ node và chế độ MCP cục bộ.
</Note>

<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
  </Tab>

  <Tab title="Windows (PowerShell)">
    ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```
  </Tab>
</Tabs>

Để cài đặt mà không chạy quy trình thiết lập ban đầu:

<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
    ```
  </Tab>

  <Tab title="Windows (PowerShell)">
    ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
    ```
  </Tab>
</Tabs>

Để xem tất cả cờ và tùy chọn CI/tự động hóa, hãy xem [Chi tiết nội bộ của trình cài đặt](/vi/install/installer).

## 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`)

Sử 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 đặt Node trên toàn hệ thống:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
curl -fsSL https://openclaw.ai/install-cli.sh | bash
```

Theo mặc định, trình cài đặt hỗ trợ cài đặt bằng npm, cùng với cài đặt từ bản checkout git trong cùng
quy trình tiền tố. Tài liệu tham khảo đầy đủ: [Chi tiết nội bộ của trình cài đặt](/vi/install/installer#install-clish).

Đã cài đặt? Chuyển đổi giữa bản cài đặt từ gói và git bằng
`openclaw update --channel dev` và `openclaw update --channel stable`. Xem
[Cập nhật](/vi/install/updating#switch-between-npm-and-git-installs).

### npm, pnpm hoặc bun

Nếu bạn đã tự quản lý Node:

<Tabs>
  <Tab title="npm">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <Note>
      Trình cài đặt được lưu trữ sẽ xóa các bộ lọc độ mới của npm như `min-release-age`
      khi cài đặt gói OpenClaw. Nếu bạn cài đặt thủ công bằng npm, chính sách npm của riêng bạn
      vẫn được áp dụng.
    </Note>
  </Tab>

  <Tab title="pnpm">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    pnpm add -g openclaw@latest
    pnpm approve-builds -g
    openclaw onboard --install-daemon
    ```

    <Note>
      pnpm yêu cầu phê duyệt rõ ràng đối với các gói có tập lệnh biên dịch. Chạy `pnpm approve-builds -g` sau lần cài đặt đầu tiên.
    </Note>
  </Tab>

  <Tab title="bun">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    bun add -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <Note>
      Bun có thể cài đặt gói toàn cục, nhưng tệp thực thi `openclaw` tạo ra yêu cầu một môi trường chạy Node được hỗ trợ vì trạng thái OpenClaw sử dụng `node:sqlite`.
    </Note>
  </Tab>
</Tabs>

### Từ mã nguồn

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ộ:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 liên kết và sử dụng `pnpm openclaw ...` từ bên trong kho lưu trữ. Xem [Thiết lập](/vi/start/setup) để biết đầy đủ các quy trình phát triển.

### Cài đặt từ bản checkout nhánh main trên GitHub

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main
```

### Container và trình quản lý gói

<CardGroup cols={2}>
  <Card title="Docker" href="/vi/install/docker" icon="container">
    Triển khai trong container hoặc không giao diện.
  </Card>

  <Card title="Podman" href="/vi/install/podman" icon="container">
    Giải pháp container không cần quyền root thay thế Docker.
  </Card>

  <Card title="Nix" href="/vi/install/nix" icon="snowflake">
    Cài đặt khai báo thông qua Nix flake.
  </Card>

  <Card title="Ansible" href="/vi/install/ansible" icon="server">
    Cấp phát tự động cho đội máy.
  </Card>

  <Card title="Bun" href="/vi/install/bun" icon="zap">
    Trình cài đặt phần phụ thuộc và trình chạy tập lệnh gói tùy chọn.
  </Card>
</CardGroup>

## Xác minh bản cài đặt

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw --version      # xác nhận CLI khả dụng
openclaw doctor         # kiểm tra sự cố cấu hình
openclaw gateway status # xác minh Gateway đang chạy
```

Nếu bạn muốn khởi động được quản lý sau khi cài đặt:

* macOS: LaunchAgent thông qua `openclaw onboard --install-daemon` hoặc `openclaw gateway install`
* Linux/WSL2: dịch vụ người dùng systemd thông qua các lệnh tương tự
* Windows gốc: ưu tiên Scheduled Task, 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

## Lưu trữ và triển khai

Triển khai OpenClaw trên máy chủ đám mây hoặc VPS. Xem [Máy chủ Linux](/vi/vps) để biết đầy đủ
công cụ chọn nhà cung cấp (DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway,
Northflank, Oracle Cloud, Raspberry Pi và nhiều nhà cung cấp khác), hoặc triển khai theo cách khai báo trên
[Render](/vi/install/render).

<CardGroup cols={3}>
  <Card title="VPS" href="/vi/vps">
    Chọn một nhà cung cấp.
  </Card>

  <Card title="Máy ảo Docker" href="/vi/install/docker-vm-runtime">
    Các bước Docker dùng chung.
  </Card>

  <Card title="Kubernetes" href="/vi/install/kubernetes">
    Triển khai K8s.
  </Card>
</CardGroup>

## Cập nhật, di chuyển hoặc gỡ cài đặt

<CardGroup cols={3}>
  <Card title="Cập nhật" href="/vi/install/updating" icon="refresh-cw">
    Luôn cập nhật OpenClaw lên phiên bản mới nhất.
  </Card>

  <Card title="Di chuyển" href="/vi/install/migrating" icon="arrow-right">
    Chuyển sang một máy mới.
  </Card>

  <Card title="Gỡ cài đặt" href="/vi/install/uninstall" icon="trash-2">
    Xóa hoàn toàn OpenClaw.
  </Card>
</CardGroup>

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

Hầu như luôn là sự cố PATH: thư mục tệp nhị phân toàn cục của npm không có trong `PATH` của shell. Xem [Khắc phục sự cố Node.js](/vi/install/node#troubleshooting) để biết cách khắc phục đầy đủ, bao gồm cả đường dẫn Windows.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
node -v           # Node đã được cài đặt?
npm prefix -g     # Các gói toàn cục nằm ở đâu?
echo "$PATH"      # Thư mục tệp nhị phân toàn cục có trong PATH không?
```