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

# Bắt đầu sử dụng

Cài đặt OpenClaw, chạy quy trình thiết lập ban đầu và trò chuyện với trợ lý AI của bạn trong khoảng 5
phút. Khi hoàn tất, bạn sẽ có một Gateway đang chạy, phương thức xác thực đã được cấu hình và một
phiên trò chuyện hoạt động.

## Những gì bạn cần

* **Node.js 22.22.3+, 24.15+ hoặc 25.9+** (24 là phiên bản mặc định được khuyến nghị)
* **Khóa API** từ một nhà cung cấp mô hình (Anthropic, OpenAI, Google, v.v.) — quy trình thiết lập ban đầu sẽ yêu cầu bạn nhập khóa

<Tip>
  Kiểm tra phiên bản Node bằng `node --version`.
  **Người dùng Windows:** ứng dụng Windows Hub gốc là cách dễ nhất để sử dụng trên máy tính. Trình cài đặt
  PowerShell và các phương thức chạy Gateway trên WSL2 cũng được hỗ trợ. Xem [Windows](/vi/platforms/windows).
  Cần cài đặt Node? Xem [Thiết lập Node](/vi/install/node).
</Tip>

## Thiết lập nhanh

<Steps>
  <Step title="Cài đặt OpenClaw">
    <Tabs>
      <Tab title="macOS / Linux">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        curl -fsSL https://openclaw.ai/install.sh | bash
        ```

        <img src="https://mintcdn.com/clawdhub/U8jr7qEbUc9OU9YR/assets/install-script.svg?fit=max&auto=format&n=U8jr7qEbUc9OU9YR&q=85&s=50706f81e3210a610262f14facb11f65" alt="Quy trình của tập lệnh cài đặt" className="rounded-lg" width="1370" height="581" data-path="assets/install-script.svg" />
      </Tab>

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

    <Note>
      Các phương thức cài đặt khác (Docker, Nix, npm): [Cài đặt](/vi/install).
    </Note>
  </Step>

  <Step title="Chạy quy trình thiết lập ban đầu">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --install-daemon
    ```

    Trình hướng dẫn sẽ giúp bạn chọn nhà cung cấp mô hình, đặt khóa API
    và cấu hình Gateway. QuickStart thường chỉ mất vài phút, nhưng
    việc đăng nhập vào nhà cung cấp, ghép nối kênh, cài đặt daemon, tải xuống qua mạng, thiết lập skills
    hoặc các plugin tùy chọn có thể khiến toàn bộ quy trình thiết lập ban đầu mất nhiều thời gian hơn. Hãy bỏ qua các
    bước tùy chọn và quay lại sau bằng `openclaw configure`.

    Xem [Thiết lập ban đầu (CLI)](/vi/start/wizard) để tham khảo đầy đủ.
  </Step>

  <Step title="Xác minh Gateway đang chạy">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw gateway status
    ```

    Bạn sẽ thấy Gateway đang lắng nghe trên cổng 18789.
  </Step>

  <Step title="Mở bảng điều khiển">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw dashboard
    ```

    Thao tác này mở giao diện điều khiển trong trình duyệt. Nếu giao diện tải được thì mọi thứ đang hoạt động.
  </Step>

  <Step title="Gửi tin nhắn đầu tiên">
    Nhập một tin nhắn trong phần trò chuyện của giao diện điều khiển và bạn sẽ nhận được phản hồi từ AI.

    Thay vào đó, bạn muốn trò chuyện từ điện thoại? Kênh thiết lập nhanh nhất là
    [Telegram](/vi/channels/telegram) (chỉ cần mã thông báo bot). Xem [Các kênh](/vi/channels)
    để biết tất cả tùy chọn.
  </Step>
</Steps>

<Accordion title="Nâng cao: gắn bản dựng giao diện điều khiển tùy chỉnh">
  Nếu bạn duy trì một bản dựng bảng điều khiển đã được bản địa hóa hoặc tùy chỉnh, hãy trỏ
  `gateway.controlUi.root` đến thư mục chứa các tài nguyên tĩnh đã dựng
  và `index.html`.

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  mkdir -p "$HOME/.openclaw/control-ui-custom"
  # Sao chép các tệp tĩnh đã dựng của bạn vào thư mục đó.
  ```

  Sau đó đặt:

  ```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
  {
    "gateway": {
      "controlUi": {
        "enabled": true,
        "root": "$HOME/.openclaw/control-ui-custom"
      }
    }
  }
  ```

  Khởi động lại Gateway và mở lại bảng điều khiển:

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  openclaw gateway restart
  openclaw dashboard
  ```
</Accordion>

## Việc cần làm tiếp theo

<Columns>
  <Card title="Kết nối một kênh" href="/vi/channels" icon="message-square">
    Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo và nhiều nền tảng khác.
  </Card>

  <Card title="Ghép nối và an toàn" href="/vi/channels/pairing" icon="shield">
    Kiểm soát những ai có thể gửi tin nhắn cho tác tử của bạn.
  </Card>

  <Card title="Cấu hình Gateway" href="/vi/gateway/configuration" icon="settings">
    Mô hình, công cụ, hộp cát và các cài đặt nâng cao.
  </Card>

  <Card title="Duyệt công cụ" href="/vi/tools" icon="wrench">
    Trình duyệt, thực thi lệnh, tìm kiếm web, skills và plugin.
  </Card>
</Columns>

<Accordion title="Nâng cao: biến môi trường">
  Nếu bạn chạy OpenClaw bằng tài khoản dịch vụ hoặc muốn sử dụng các đường dẫn tùy chỉnh:

  * `OPENCLAW_HOME` — thư mục chính dùng để phân giải đường dẫn nội bộ
  * `OPENCLAW_STATE_DIR` — ghi đè thư mục trạng thái
  * `OPENCLAW_CONFIG_PATH` — ghi đè đường dẫn tệp cấu hình

  Tài liệu tham khảo đầy đủ: [Biến môi trường](/vi/help/environment).
</Accordion>

## Liên quan

* [Tổng quan về cài đặt](/vi/install)
* [Tổng quan về các kênh](/vi/channels)
* [Thiết lập](/vi/start/setup)