# OpenClaw

Nguồn: https://docs.aicentos.com/vi/clients/openclaw

Language: vi

> Dùng aicentos trong OpenClaw —— kết nối qua Provider tùy chỉnh

OpenClaw là công cụ dòng lệnh trợ lý lập trình AI, hỗ trợ kết nối đến các dịch vụ API tương thích OpenAI qua Provider tùy chỉnh. Trang chính thức khuyến nghị dùng trình hướng dẫn `openclaw onboard` để hoàn tất cấu hình, cũng có thể tự viết file cấu hình thủ công.

## Chuẩn bị

Đảm bảo hệ thống đáp ứng các yêu cầu sau:

* Node.js phiên bản 22+
* Hệ điều hành macOS / Linux / Windows
* Nếu build từ mã nguồn, cần cài thêm pnpm

### Cài Node.js

**macOS (dùng Homebrew):**

```bash
brew install node
```

**Hệ điều hành khác:**

Truy cập trang chủ Node.js để tải bản LTS: [https://nodejs.org/en/download](https://nodejs.org/en/download)

### Kiểm tra cài đặt

```bash
node -v
npm -v
```

**Lưu ý:** Người dùng Windows nên chạy OpenClaw trong môi trường WSL2.

## Cài đặt OpenClaw

Dùng script cài đặt chính thức (khuyến nghị):

### macOS / Linux

```bash
curl -fsSL https://openclaw.ai/install.sh | bash
```

### Windows PowerShell

```powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
```

Script cài đặt sẽ tự động phát hiện và cài bổ sung các phụ thuộc còn thiếu. Nếu bạn đã tự quản lý môi trường Node, cũng có thể cài bằng `npm` hoặc `pnpm` (xem tài liệu chính thức).

## Chạy trình hướng dẫn cấu hình

Chạy lệnh hướng dẫn:

```bash
openclaw onboard
```

Trong trình hướng dẫn, lần lượt điền các thông tin sau:

* **Loại Provider**: chọn `Custom Provider`
* **Compatibility**: chọn `OpenAI-compatible`
* **Base URL**: `https://aicentos.com/v1`
* **API Key**: điền API Key của bạn
* **Model ID**: tham khảo tên mô hình trong "Model Square" của Console
* **Endpoint ID**: khuyến nghị điền `aicentos`

**Lưu ý:** API Key điền trực tiếp dạng văn bản thuần là được, không cần đổi thêm sang biến môi trường `OPENAI_API_KEY`.

## Đặt mô hình mặc định

Sau khi hoàn tất trình hướng dẫn, đặt mô hình mặc định thành:

```text
aicentos/gpt-4o
```

Như vậy khi dùng về sau sẽ tự động dùng mô hình đã cấu hình.

## Cấu hình thủ công (tùy chọn)

Nếu không dùng trình hướng dẫn, có thể trực tiếp viết file cấu hình provider của OpenClaw:

```json
{
  "models": {
    "providers": {
      "aicentos": {
        "baseUrl": "https://aicentos.com/v1",
        "apiKey": "your_api_key_here",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-4o", "name": "gpt-4o" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "aicentos/gpt-4o" }
    }
  }
}
```

Trong cấu hình có thể ghi trực tiếp API Key dạng văn bản thuần, hoặc dùng tham chiếu biến môi trường (nếu bạn thích cách SecretRef hơn).

## Kiểm tra cấu hình

Kiểm tra trạng thái mô hình để xác nhận kết nối thành công:

```bash
openclaw models list
openclaw models status
```

Nếu thấy `aicentos/gpt-4o` và trạng thái hiển thị bình thường, nghĩa là cấu hình kết nối thành công.

## Lưu ý

* OpenClaw chính thức hỗ trợ tính năng Provider tùy chỉnh, có thể chọn chế độ OpenAI-compatible hoặc Anthropic-compatible
* Với dịch vụ hiện tại, khuyến nghị ưu tiên dùng chế độ OpenAI-compatible
* Điền trực tiếp API Key là cách làm mặc định; tham chiếu biến môi trường chỉ là phương án tùy chọn
* Nếu muốn dùng công cụ tự ghi cấu hình, có thể cân nhắc công cụ `cc-switch`
* Tài liệu chính thức còn cung cấp các cách cài đặt và cấu hình khác, có thể chọn theo nhu cầu thực tế

## Liên kết liên quan

* Tài liệu chính thức: [https://docs.openclaw.ai/install/index](https://docs.openclaw.ai/install/index)