> ## Documentation Index
> Fetch the complete documentation index at: https://docs.4096bytes.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenClaw

> Cấu hình 4096bytes làm Provider mô hình tùy chỉnh trong OpenClaw

OpenClaw có thể kết nối với 4096bytes thông qua Provider mô hình tùy chỉnh. Ghi cấu hình tương thích OpenAI, đặt mô hình mặc định cho agent, khởi động lại gateway và kích hoạt mô hình mới.

## Điều kiện cần có

* Bạn đã hoàn tất [Tạo tài khoản](/vi/quickstart/create-account).
* Bạn đã hoàn tất [Lấy API Key](/vi/quickstart/get-api-key).
* OpenClaw đã được cài đặt và `openclaw --version` hoạt động.
* Bạn có API Key, Base URL và tên mô hình của 4096bytes.

<Warning>
  Các lệnh dưới đây ghi API Key vào cấu hình OpenClaw cục bộ. Không commit lệnh, tệp cấu hình, ảnh chụp màn hình hoặc đầu ra terminal có chứa API Key thật.
</Warning>

## Cấu hình Provider tùy chỉnh

Chạy lệnh này để thêm 4096bytes làm Provider mô hình tùy chỉnh.

```bash theme={null}
openclaw config set models.providers.4096bytes '{
  "api": "openai-completions",
  "baseUrl": "https://api.4096bytes.com/v1",
  "apiKey": "YOUR_4096BYTES_API_KEY",
  "auth": "api-key",
  "headers": {
    "User-Agent": "Mozilla/5.0"
  },
  "models": [
    {
      "id": "gpt-5.5",
      "name": "GPT-5.5",
      "contextWindow": 200000,
      "reasoning": true,
      "input": [
        "text"
      ]
    }
  ]
}' --strict-json --merge
```

Thay `YOUR_4096BYTES_API_KEY` bằng API Key bạn tạo trong bảng điều khiển. Dùng giá trị hiện tại trong bảng điều khiển cho `id`, `name`, `contextWindow` và `reasoning`.

<Tip>
  Lệnh dùng `--strict-json`. JSON không được có dấu phẩy cuối, nếu không OpenClaw sẽ từ chối cấu hình.
</Tip>

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

Đặt mô hình 4096bytes làm mô hình mặc định cho agent và gán bí danh ngắn.

```bash theme={null}
openclaw config set agents.defaults.models '{"4096bytes/gpt-5.5": {"alias": "G55"}}' --strict-json --merge
```

Nếu tên mô hình của bạn không phải `gpt-5.5`, hãy thay `4096bytes/gpt-5.5` trong lệnh.

## Khởi động lại gateway

Sau khi ghi cấu hình, khởi động lại OpenClaw gateway.

```bash theme={null}
openclaw gateway restart
```

## Kích hoạt mô hình mới

Đặt phiên hiện tại dùng mô hình 4096bytes.

```bash theme={null}
openclaw models set 4096bytes/gpt-5.5
```

Nếu bạn dùng tên mô hình khác, thay `gpt-5.5` bằng ID mô hình hiển thị trong bảng điều khiển.

## Kiểm tra lệnh gọi mô hình

Gửi một tin nhắn ngắn để xác minh kết nối.

```bash theme={null}
openclaw chat --message "hi"
```

Nếu OpenClaw phản hồi mà không có lỗi xác thực hoặc không tìm thấy mô hình, cấu hình đã có hiệu lực.

## Sự cố thường gặp

<AccordionGroup>
  <Accordion title="OpenClaw báo JSON không hợp lệ">
    Kiểm tra dấu phẩy cuối, dấu ngoặc kép chưa escape hoặc thiếu ngoặc. Với `--strict-json`, giá trị phải là JSON hợp lệ.
  </Accordion>

  <Accordion title="Xác thực thất bại">
    Kiểm tra `apiKey` đã đầy đủ và được sao chép không có khoảng trắng thừa hoặc xuống dòng. Xác nhận API Key chưa bị xóa, hết hạn hoặc vượt hạn mức.
  </Accordion>

  <Accordion title="Không tìm thấy mô hình">
    Xác nhận `id` trong `models` khớp với ID dùng trong `openclaw models set`. Sao chép tên mô hình từ bảng điều khiển, không dùng ảnh chụp cũ hoặc cấu hình của người khác.
  </Accordion>

  <Accordion title="Cấu hình không có hiệu lực">
    Trước tiên chạy `openclaw gateway restart`. Nếu vẫn lỗi, kiểm tra cả `models.providers.4096bytes` và `agents.defaults.models` đã được ghi thành công.
  </Accordion>
</AccordionGroup>