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

# Kilo Gateway

Kilo Gateway định tuyến các yêu cầu đến nhiều mô hình thông qua một endpoint tương thích với OpenAI và một khóa API duy nhất.

| Thuộc tính   | Giá trị                            |
| ------------ | ---------------------------------- |
| Nhà cung cấp | `kilocode`                         |
| Xác thực     | `KILOCODE_API_KEY`                 |
| API          | Tương thích với OpenAI             |
| URL cơ sở    | `https://api.kilo.ai/api/gateway/` |

## Cài đặt plugin

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/kilocode-provider
openclaw gateway restart
```

## Thiết lập

<Steps>
  <Step title="Tạo tài khoản">
    Truy cập [app.kilo.ai](https://app.kilo.ai), đăng nhập hoặc tạo tài khoản, sau đó tạo khóa API.
  </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 --auth-choice kilocode-api-key
    ```

    Hoặc đặt trực tiếp biến môi trường:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    export KILOCODE_API_KEY="<your-kilocode-api-key>" # pragma: allowlist secret
    ```
  </Step>

  <Step title="Xác minh mô hình khả dụng">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --provider kilocode
    ```
  </Step>
</Steps>

## Mô hình mặc định và danh mục

Mô hình mặc định là `kilocode/kilo-auto/balanced`, tầng định tuyến thông minh cân bằng của Kilo Gateway.
OpenClaw không công bố ánh xạ từ tác vụ đến mô hình thượng nguồn cho tầng này; việc định tuyến phía sau
`kilo-auto/balanced` do Kilo Gateway quản lý.

Khi khởi động, OpenClaw truy vấn `GET https://api.kilo.ai/api/gateway/models` và hợp nhất các mô hình được phát hiện
trước danh mục dự phòng tĩnh. Danh mục dự phòng tĩnh chỉ chứa
`kilocode/kilo-auto/balanced` (`Auto Balanced`, `input: ["text", "image"]`, `reasoning: true`,
`contextWindow: 1000000`, `maxTokens: 65536`).

Có thể truy cập mọi mô hình trên gateway dưới dạng `kilocode/<upstream-id>` (ví dụ:
`kilocode/anthropic/claude-sonnet-4`, `kilocode/openai/gpt-5.5`). Chạy `/models kilocode` hoặc
`openclaw models list --provider kilocode` để xem toàn bộ danh sách được phát hiện.

## Ví dụ cấu hình

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  env: { KILOCODE_API_KEY: "<your-kilocode-api-key>" }, // pragma: allowlist secret
  agents: {
    defaults: {
      model: { primary: "kilocode/kilo-auto/balanced" },
    },
  },
}
```

## Ghi chú về hành vi

<AccordionGroup>
  <Accordion title="Phương thức truyền tải và khả năng tương thích">
    Kilo Gateway tương thích với OpenRouter, vì vậy nó sử dụng đường dẫn yêu cầu tương thích với OpenAI theo kiểu proxy
    thay vì định hình yêu cầu OpenAI gốc (không có `store`, không có payload mức độ suy luận của OpenAI).

    * Các tham chiếu Kilo dựa trên Gemini vẫn sử dụng đường dẫn proxy-Gemini: OpenClaw làm sạch các chữ ký suy nghĩ
      của Gemini tại đó nhưng không bật tính năng xác thực phát lại Gemini gốc hoặc viết lại khởi tạo.
    * Các yêu cầu sử dụng token Bearer được tạo từ khóa API của bạn.
  </Accordion>

  <Accordion title="Trình bao luồng và suy luận">
    Trình bao luồng Kilo thêm header yêu cầu `X-KILOCODE-FEATURE` (mặc định là `openclaw`,
    ghi đè bằng biến môi trường `KILOCODE_FEATURE`) và chuẩn hóa các payload mức độ suy luận cho
    các mô hình hỗ trợ tính năng này.

    <Warning>
      Các tham chiếu `kilocode/kilo-auto/balanced` và `x-ai/*` bỏ qua việc chèn mức độ suy luận. Hãy sử dụng một
      tham chiếu mô hình cụ thể như `kilocode/anthropic/claude-sonnet-4` nếu bạn cần hỗ trợ suy luận.
    </Warning>
  </Accordion>

  <Accordion title="Khắc phục sự cố">
    * Nếu việc phát hiện mô hình thất bại khi khởi động, OpenClaw sẽ chuyển sang danh mục tĩnh chứa `kilocode/kilo-auto/balanced`.
    * Xác nhận khóa API của bạn hợp lệ và tài khoản Kilo đã bật các mô hình mong muốn.
    * Khi Gateway chạy dưới dạng daemon, hãy đảm bảo tiến trình đó có thể truy cập `KILOCODE_API_KEY` (ví dụ trong `~/.openclaw/.env` hoặc thông qua `env.shellEnv`).
  </Accordion>
</AccordionGroup>

## Nội dung liên quan

<CardGroup cols={2}>
  <Card title="Lựa chọn mô hình" href="/vi/concepts/model-providers" icon="layers">
    Chọn nhà cung cấp, tham chiếu mô hình và hành vi chuyển đổi dự phòng.
  </Card>

  <Card title="Tham chiếu cấu hình" href="/vi/gateway/configuration-reference" icon="gear">
    Tham chiếu cấu hình OpenClaw đầy đủ.
  </Card>

  <Card title="Kilo Gateway" href="https://app.kilo.ai" icon="arrow-up-right-from-square">
    Bảng điều khiển Kilo Gateway, khóa API và quản lý tài khoản.
  </Card>
</CardGroup>