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

# Chutes

[Chutes](https://chutes.ai) cung cấp các danh mục mô hình mã nguồn mở thông qua một
API tương thích với OpenAI. OpenClaw hỗ trợ cả OAuth trên trình duyệt và xác thực bằng khóa API.

| Thuộc tính              | Giá trị                                                |
| ----------------------- | ------------------------------------------------------ |
| Nhà cung cấp            | `chutes`                                               |
| Plugin                  | gói bên ngoài chính thức (`@openclaw/chutes-provider`) |
| API                     | tương thích với OpenAI                                 |
| URL cơ sở               | `https://llm.chutes.ai/v1`                             |
| Xác thực                | OAuth hoặc khóa API (xem bên dưới)                     |
| Biến môi trường runtime | `CHUTES_API_KEY`, `CHUTES_OAUTH_TOKEN`                 |

`CHUTES_OAUTH_TOKEN` cung cấp trực tiếp một access token OAuth đã lấy được
(ví dụ trong CI), bỏ qua luồng trình duyệt tương tác bên dưới.

## Cài đặt Plugin

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

## Bắt đầu

Cả hai cách đều đặt mô hình mặc định thành `chutes/zai-org/GLM-5-TEE` và đăng ký
danh mục Chutes.

<Tabs>
  <Tab title="OAuth">
    <Steps>
      <Step title="Chạy luồng thiết lập ban đầu OAuth">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice chutes
        ```

        OpenClaw khởi chạy luồng trình duyệt cục bộ hoặc hiển thị URL + luồng dán
        chuyển hướng trên máy chủ từ xa/không giao diện. Token OAuth tự động làm mới thông qua
        hồ sơ xác thực OpenClaw.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Khóa API">
    <Steps>
      <Step title="Lấy khóa API">
        Tạo khóa tại
        [chutes.ai/settings/api-keys](https://chutes.ai/settings/api-keys).
      </Step>

      <Step title="Chạy luồng thiết lập ban đầu bằng khóa API">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice chutes-api-key
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Hành vi khám phá

Khi có thông tin xác thực Chutes, OpenClaw truy vấn `GET /v1/models` bằng
thông tin xác thực đó và sử dụng các mô hình đã khám phá, được lưu vào bộ nhớ đệm trong 5 phút cho mỗi
thông tin xác thực. Khi khóa hết hạn/không được ủy quyền (HTTP 401), OpenClaw thử lại một lần
mà không có thông tin xác thực. Nếu quá trình khám phá vẫn không trả về hàng nào, thất bại hoặc trả về
bất kỳ trạng thái không phải 2xx nào khác, hệ thống quay về danh mục tĩnh đi kèm (cả khám phá bằng khóa API
và OAuth đều sử dụng cùng đường dẫn này). Nếu quá trình khám phá thất bại khi khởi động,
danh mục tĩnh sẽ tự động được sử dụng.

## Bí danh mặc định

OpenClaw đăng ký hai bí danh tiện dụng cho danh mục Chutes:

| Bí danh         | Mô hình đích                           |
| --------------- | -------------------------------------- |
| `chutes-pro`    | `chutes/deepseek-ai/DeepSeek-V3.2-TEE` |
| `chutes-vision` | `chutes/moonshotai/Kimi-K2.5-TEE`      |

## Danh mục khởi đầu tích hợp sẵn

Danh mục dự phòng đi kèm chứa năm mô hình hiện đang được cung cấp sau:

| Tham chiếu mô hình                     |
| -------------------------------------- |
| `chutes/zai-org/GLM-5-TEE`             |
| `chutes/deepseek-ai/DeepSeek-V3.2-TEE` |
| `chutes/moonshotai/Kimi-K2.5-TEE`      |
| `chutes/MiniMaxAI/MiniMax-M2.5-TEE`    |
| `chutes/Qwen/Qwen3.5-397B-A17B-TEE`    |

Chạy `openclaw models list --all --provider chutes` để xem danh sách đầy đủ.

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

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      model: { primary: "chutes/zai-org/GLM-5-TEE" },
      models: {
        "chutes/zai-org/GLM-5-TEE": { alias: "Chutes GLM 5" },
        "chutes/deepseek-ai/DeepSeek-V3.2-TEE": { alias: "Chutes DeepSeek V3.2" },
      },
    },
  },
}
```

<AccordionGroup>
  <Accordion title="Ghi đè OAuth">
    Tùy chỉnh luồng OAuth bằng các biến môi trường tùy chọn:

    | Biến                        | Mục đích                                                                      |
    | --------------------------- | ----------------------------------------------------------------------------- |
    | `CHUTES_CLIENT_ID`          | ID máy khách OAuth (sẽ được nhắc nhập nếu chưa đặt)                           |
    | `CHUTES_CLIENT_SECRET`      | Bí mật máy khách OAuth                                                        |
    | `CHUTES_OAUTH_REDIRECT_URI` | URI chuyển hướng (mặc định `http://127.0.0.1:1456/oauth-callback`)            |
    | `CHUTES_OAUTH_SCOPES`       | Các phạm vi phân tách bằng dấu cách (mặc định `openid profile chutes:invoke`) |

    Xem [tài liệu OAuth của Chutes](https://chutes.ai/docs/sign-in-with-chutes/overview)
    để biết các yêu cầu đối với ứng dụng chuyển hướng và nhận trợ giúp.
  </Accordion>

  <Accordion title="Ghi chú">
    * Các mô hình Chutes được đăng ký dưới dạng `chutes/<model-id>`.
    * Chutes không báo cáo mức sử dụng token trong khi truyền phát trực tuyến (`supportsUsageInStreaming: false`); tổng mức sử dụng vẫn hiển thị sau khi luồng hoàn tất.
  </Accordion>
</AccordionGroup>

## Liên quan

<CardGroup cols={2}>
  <Card title="Chọn mô hình" href="/vi/concepts/model-providers" icon="layers">
    Quy tắc 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">
    Lược đồ cấu hình đầy đủ, bao gồm các thiết lập nhà cung cấp.
  </Card>

  <Card title="Chutes" href="https://chutes.ai" icon="arrow-up-right-from-square">
    Bảng điều khiển Chutes và tài liệu API.
  </Card>

  <Card title="Khóa API Chutes" href="https://chutes.ai/settings/api-keys" icon="key">
    Tạo và quản lý khóa API Chutes.
  </Card>
</CardGroup>