Bắt đầu

Mục tiêu: từ con số không đến cuộc trò chuyện đầu tiên với thiết lập tối thiểu.

Info: Cách chat nhanh nhất: mở Control UI (không cần thiết lập kênh). Chạy openclaw dashboard rồi chat trong trình duyệt, hoặc mở http://127.0.0.1:18789/ trên máy chủ gateway (máy đang chạy dịch vụ OpenClaw gateway). Tài liệu: Dashboard và Control UI.

Yêu cầu

Khuyến nghị Node 24 (Node 22 LTS, hiện tại 22.16+, vẫn được hỗ trợ để tương thích)

Mẹo: Kiểm tra phiên bản Node bằng node --version nếu bạn không chắc.

Thiết lập nhanh (CLI)

Bước 1: Cài đặt OpenClaw (khuyến nghị)

  #### macOS/Linux
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
    <img

src=“https://cdn.openclaws.io/public/docs/assets/install-script.svg” alt=“Install Script Process” class=“rounded-lg” />

  #### Windows (PowerShell)
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```



> **Lưu ý:** Các phương thức cài đặt khác và yêu cầu: [Cài đặt](/docs/install).

Bước 2: Chạy trình hướng dẫn onboarding

```bash
openclaw onboard --install-daemon
```

Trình hướng dẫn cấu hình xác thực, thiết lập gateway và các kênh tùy chọn.
Xem [Trình hướng dẫn Onboarding](/docs/start/wizard) để biết chi tiết.

Bước 3: Kiểm tra Gateway

Nếu bạn đã cài đặt dịch vụ, nó sẽ đang chạy rồi:

```bash
openclaw gateway status
```

Bước 4: Mở Control UI

```bash
openclaw dashboard
```

Check: Nếu Control UI tải được, Gateway của bạn đã sẵn sàng sử dụng.

Kiểm tra và tính năng bổ sung

Chạy Gateway ở foreground

Hữu ích cho test nhanh hoặc xử lý sự cố.

```bash
openclaw gateway --port 18789
```

Gửi tin nhắn thử

Yêu cầu kênh đã được cấu hình.

```bash
openclaw message send --target +15555550123 --message "Hello from OpenClaw"
```

Biến môi trường hữu ích

Nếu bạn chạy OpenClaw dưới tài khoản dịch vụ hoặc muốn thay đổi vị trí cấu hình/trạng thái:

OPENCLAW_HOME đặt thư mục gốc cho việc 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 file cấu hình.

Tham khảo đầy đủ biến môi trường: Biến môi trường.

Tìm hiểu sâu hơn

Trình hướng dẫn Onboarding (chi tiết) — Tham khảo đầy đủ trình hướng dẫn CLI và tùy chọn nâng cao.
Onboarding ứng dụng macOS — Quy trình chạy lần đầu cho ứng dụng macOS.

Bạn sẽ có

Gateway đang chạy
Xác thực đã được cấu hình
Truy cập Control UI hoặc kênh đã kết nối

Bước tiếp theo

Bảo mật DM và phê duyệt: Ghép nối
Kết nối thêm kênh: Kênh
Workflow nâng cao và cài từ source: Setup