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

# Qwen

Qwen Cloud là plugin nhà cung cấp OpenClaw bên ngoài chính thức có id chuẩn `qwen`. Plugin này hướng đến các endpoint Standard và Coding Plan của Qwen Cloud / Alibaba DashScope, cung cấp Token Plan dưới dạng `qwen-token-plan`, giữ `modelstudio` làm bí danh tương thích và sở hữu độc lập id nhà cung cấp tùy chỉnh `bailian-token-plan` được Alibaba ghi nhận trong tài liệu.

| Thuộc tính                        | Giá trị                                    |
| --------------------------------- | ------------------------------------------ |
| Nhà cung cấp                      | `qwen`                                     |
| Nhà cung cấp Token Plan           | `qwen-token-plan`                          |
| Biến môi trường ưu tiên           | `QWEN_API_KEY`                             |
| Biến môi trường Token Plan        | `QWEN_TOKEN_PLAN_API_KEY`                  |
| Cũng được chấp nhận (tương thích) | `MODELSTUDIO_API_KEY`, `DASHSCOPE_API_KEY` |
| Kiểu API                          | Tương thích với OpenAI                     |

<Tip>
  `qwen3.7-plus` và `qwen3.6-plus` hoạt động với các endpoint Coding Plan và Standard.
  Đối với `qwen3.7-max` hoặc `qwen3.6-flash`, hãy sử dụng endpoint **Standard (trả phí theo mức sử dụng)**.
</Tip>

## Cài đặt plugin

`qwen` được phân phối dưới dạng plugin bên ngoài chính thức, không đi kèm với phần lõi. Hãy cài đặt plugin và khởi động lại Gateway:

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

## Bắt đầu

Chọn loại gói và làm theo các bước thiết lập.

<Tabs>
  <Tab title="Coding Plan (gói thuê bao)">
    **Phù hợp nhất cho:** quyền truy cập dựa trên gói thuê bao thông qua Qwen Coding Plan.

    <Steps>
      <Step title="Lấy khóa API">
        Tạo hoặc sao chép khóa API từ [home.qwencloud.com/api-keys](https://home.qwencloud.com/api-keys).
      </Step>

      <Step title="Chạy quy trình thiết lập ban đầu">
        Đối với endpoint **Toàn cầu**:

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice qwen-api-key
        ```

        Đối với endpoint **Trung Quốc**:

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice qwen-api-key-cn
        ```
      </Step>

      <Step title="Đặt mô hình mặc định">
        ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
        {
          agents: {
            defaults: {
              model: { primary: "qwen/qwen3.5-plus" },
            },
          },
        }
        ```
      </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 qwen
        ```
      </Step>
    </Steps>

    <Note>
      Các id lựa chọn xác thực `modelstudio-*` cũ và tham chiếu mô hình `modelstudio/...` vẫn
      hoạt động dưới dạng bí danh tương thích, nhưng các luồng thiết lập mới nên ưu tiên các id
      lựa chọn xác thực `qwen-*` chuẩn và tham chiếu mô hình `qwen/...`. Nếu bạn định nghĩa chính xác
      một mục `models.providers.modelstudio` tùy chỉnh với giá trị `api` khác, nhà cung cấp
      tùy chỉnh đó sẽ sở hữu các tham chiếu `modelstudio/...` thay vì bí danh tương thích
      Qwen.
    </Note>
  </Tab>

  <Tab title="Standard (trả phí theo mức sử dụng)">
    **Phù hợp nhất cho:** quyền truy cập trả phí theo mức sử dụng thông qua endpoint Standard Model Studio, bao gồm `qwen3.7-max` và `qwen3.6-flash`, vốn không khả dụng trên Coding Plan.

    <Steps>
      <Step title="Lấy khóa API">
        Tạo hoặc sao chép khóa API từ [home.qwencloud.com/api-keys](https://home.qwencloud.com/api-keys).
      </Step>

      <Step title="Chạy quy trình thiết lập ban đầu">
        Đối với endpoint **Toàn cầu**:

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice qwen-standard-api-key
        ```

        Đối với endpoint **Trung Quốc**:

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice qwen-standard-api-key-cn
        ```
      </Step>

      <Step title="Đặt mô hình mặc định">
        ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
        {
          agents: {
            defaults: {
              model: { primary: "qwen/qwen3.5-plus" },
            },
          },
        }
        ```
      </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 qwen
        ```
      </Step>
    </Steps>

    <Note>
      Các id lựa chọn xác thực `modelstudio-*` cũ và tham chiếu mô hình `modelstudio/...` vẫn
      hoạt động dưới dạng bí danh tương thích, nhưng các luồng thiết lập mới nên ưu tiên các id
      lựa chọn xác thực `qwen-*` chuẩn và tham chiếu mô hình `qwen/...`. Nếu bạn định nghĩa chính xác
      một mục `models.providers.modelstudio` tùy chỉnh với giá trị `api` khác, nhà cung cấp
      tùy chỉnh đó sẽ sở hữu các tham chiếu `modelstudio/...` thay vì bí danh tương thích
      Qwen.
    </Note>
  </Tab>

  <Tab title="Token Plan (Phiên bản dành cho nhóm)">
    **Phù hợp nhất cho:** quyền truy cập gói thuê bao nhóm dựa trên tín dụng vào Qwen và các mô hình bên thứ ba được hỗ trợ thông qua Alibaba Cloud Model Studio.

    <Steps>
      <Step title="Lấy khóa chuyên dụng">
        Chỉ định một suất Token Plan và tạo khóa `sk-sp-...` chuyên dụng cho suất đó. Không thể dùng thay thế lẫn nhau các khóa của Token Plan, Coding Plan và gói trả phí theo mức sử dụng. Xem [tổng quan Token Plan toàn cầu](https://www.alibabacloud.com/help/en/model-studio/token-plan-overview) hoặc [tổng quan Token Plan Trung Quốc](https://help.aliyun.com/zh/model-studio/token-plan-overview).
      </Step>

      <Step title="Chạy quy trình thiết lập ban đầu">
        Đối với endpoint **Toàn cầu / Quốc tế** tại Singapore:

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice qwen-token-plan
        ```

        Đối với endpoint **Trung Quốc** tại Bắc Kinh:

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice qwen-token-plan-cn
        ```
      </Step>

      <Step title="Xác minh nhà cung cấp">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw models list --provider qwen-token-plan
        openclaw agent --model qwen-token-plan/qwen3.7-plus --message "Phản hồi bằng: token plan đã sẵn sàng"
        ```
      </Step>
    </Steps>

    <Note>
      Hướng dẫn OpenClaw của Alibaba sử dụng `bailian-token-plan` cho nhà cung cấp
      tùy chỉnh thủ công. Plugin đăng ký id đó với tư cách chủ sở hữu tương thích, nhưng các
      cấu hình mới nên sử dụng `qwen-token-plan`. Một mục
      `models.providers.bailian-token-plan` tùy chỉnh khớp chính xác vẫn giữ quyền sở hữu phương thức truyền tải
      và danh mục đã cấu hình; mục này không bao giờ được hợp nhất vào danh mục OpenAI chuẩn.
    </Note>

    <Warning>
      Chỉ sử dụng Token Plan cho các phiên OpenClaw tương tác. Không chọn gói này cho
      các tác vụ cron, tập lệnh không có người giám sát hoặc backend ứng dụng. Alibaba nêu rõ rằng
      việc sử dụng không tương tác có thể khiến gói thuê bao bị đình chỉ hoặc khóa API bị thu hồi.
    </Warning>
  </Tab>
</Tabs>

## Các loại gói và endpoint

| Gói                                  | Khu vực    | Lựa chọn xác thực          | Endpoint                                                         |
| ------------------------------------ | ---------- | -------------------------- | ---------------------------------------------------------------- |
| Coding Plan (gói thuê bao)           | Trung Quốc | `qwen-api-key-cn`          | `coding.dashscope.aliyuncs.com/v1`                               |
| Coding Plan (gói thuê bao)           | Toàn cầu   | `qwen-api-key`             | `coding-intl.dashscope.aliyuncs.com/v1`                          |
| Standard (trả phí theo mức sử dụng)  | Trung Quốc | `qwen-standard-api-key-cn` | `dashscope.aliyuncs.com/compatible-mode/v1`                      |
| Standard (trả phí theo mức sử dụng)  | Toàn cầu   | `qwen-standard-api-key`    | `dashscope-intl.aliyuncs.com/compatible-mode/v1`                 |
| Token Plan (Phiên bản dành cho nhóm) | Trung Quốc | `qwen-token-plan-cn`       | `token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1`     |
| Token Plan (Phiên bản dành cho nhóm) | Toàn cầu   | `qwen-token-plan`          | `token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1` |

Nhà cung cấp tự động chọn endpoint dựa trên lựa chọn xác thực của bạn. Các lựa chọn
chuẩn sử dụng họ `qwen-*`; `modelstudio-*` chỉ còn phục vụ mục đích tương thích.
Ghi đè bằng `baseUrl` tùy chỉnh trong cấu hình.

<Tip>
  **Quản lý khóa:** [home.qwencloud.com/api-keys](https://home.qwencloud.com/api-keys) |
  **Tài liệu:** [docs.qwencloud.com](https://docs.qwencloud.com/developer-guides/getting-started/introduction)
</Tip>

## Danh mục tích hợp sẵn

OpenClaw phân phối danh mục Qwen tĩnh này. Danh mục nhận biết endpoint: các cấu hình Coding
Plan bỏ qua những mô hình chỉ hoạt động trên endpoint Standard.

| Tham chiếu mô hình          | Đầu vào           | Ngữ cảnh  | Ghi chú                   |
| --------------------------- | ----------------- | --------- | ------------------------- |
| `qwen/qwen3.5-plus`         | văn bản, hình ảnh | 1,000,000 | Mô hình mặc định          |
| `qwen/qwen3.6-flash`        | văn bản, hình ảnh | 1,000,000 | Chỉ các endpoint Standard |
| `qwen/qwen3.6-plus`         | văn bản, hình ảnh | 1,000,000 | Coding Plan + Standard    |
| `qwen/qwen3.7-max`          | văn bản           | 1,000,000 | Chỉ các endpoint Standard |
| `qwen/qwen3.7-plus`         | văn bản, hình ảnh | 1,000,000 | Coding Plan + Standard    |
| `qwen/qwen3-max-2026-01-23` | văn bản           | 262,144   | Dòng Qwen Max             |
| `qwen/qwen3-coder-next`     | văn bản           | 262,144   | Lập trình                 |
| `qwen/qwen3-coder-plus`     | văn bản           | 1,000,000 | Lập trình                 |
| `qwen/MiniMax-M2.5`         | văn bản           | 1,000,000 | Đã bật suy luận           |
| `qwen/glm-5`                | văn bản           | 202,752   | GLM                       |
| `qwen/glm-4.7`              | văn bản           | 202,752   | GLM                       |
| `qwen/kimi-k2.5`            | văn bản, hình ảnh | 262,144   | Moonshot AI qua Alibaba   |

<Note>
  Mức độ khả dụng vẫn có thể thay đổi tùy theo endpoint và gói thanh toán, ngay cả khi mô hình
  có trong danh mục tĩnh.
</Note>

### Danh mục Token Plan

Token Plan sử dụng danh sách cho phép riêng dựa trên chuỗi khớp chính xác. Các mô hình thuộc gói
chỉ dành cho việc tạo hình ảnh không được đưa vào đây vì chúng sử dụng các API khác.

| Tham chiếu mô hình                  | Đầu vào           | Ngữ cảnh  |
| ----------------------------------- | ----------------- | --------- |
| `qwen-token-plan/qwen3.7-max`       | văn bản           | 1,000,000 |
| `qwen-token-plan/qwen3.7-plus`      | văn bản, hình ảnh | 1,000,000 |
| `qwen-token-plan/qwen3.6-plus`      | văn bản, hình ảnh | 1,000,000 |
| `qwen-token-plan/qwen3.6-flash`     | văn bản, hình ảnh | 1,000,000 |
| `qwen-token-plan/deepseek-v4-pro`   | văn bản           | 1,000,000 |
| `qwen-token-plan/deepseek-v4-flash` | văn bản           | 1,000,000 |
| `qwen-token-plan/deepseek-v3.2`     | văn bản           | 131,072   |
| `qwen-token-plan/kimi-k2.7-code`    | văn bản, hình ảnh | 262,144   |
| `qwen-token-plan/kimi-k2.6`         | văn bản, hình ảnh | 262,144   |
| `qwen-token-plan/kimi-k2.5`         | văn bản, hình ảnh | 262,144   |
| `qwen-token-plan/glm-5.2`           | văn bản           | 1,000,000 |
| `qwen-token-plan/glm-5.1`           | văn bản           | 202,752   |
| `qwen-token-plan/glm-5`             | văn bản           | 202,752   |
| `qwen-token-plan/MiniMax-M2.5`      | văn bản           | 196,608   |

## Điều khiển chế độ suy luận

`qwen3.7-max`, `qwen3.7-plus`, `qwen3.6-flash` và `qwen3.6-plus` được
bật khả năng suy luận trong danh mục tích hợp sẵn. Đối với các mô hình suy luận thuộc họ `qwen`,
nhà cung cấp ánh xạ các cấp độ suy luận của OpenClaw sang cờ yêu cầu cấp cao nhất
`enable_thinking` của DashScope: khi tắt suy luận, hệ thống gửi `enable_thinking: false`,
còn mọi cấp độ khác sẽ gửi `enable_thinking: true`. Các mô hình tùy chỉnh có thể chọn sử dụng
payload suy luận theo mẫu trò chuyện thay thế bằng cách đặt
`compat.thinkingFormat: "qwen-chat-template"` trên mục mô hình.

Các mô hình Token Plan cũng được đánh dấu là có khả năng suy luận. `kimi-k2.7-code` và
`MiniMax-M2.5` chỉ hoạt động ở chế độ suy luận, vì vậy OpenClaw vẫn bật suy luận ngay cả khi
phiên yêu cầu `/think off`. DeepSeek V4 ánh xạ từ `minimal` đến `high` sang
mức nỗ lực `high` của dịch vụ và ánh xạ `xhigh` hoặc `max` sang `max`. GLM 5.2 chấp nhận
toàn bộ phạm vi từ `minimal` đến `max`; GLM 5.1 và GLM 5 chấp nhận đến
`xhigh`, và cả ba mặc định là `high`. Các mô hình lai khác tuân theo
trạng thái bật/tắt được yêu cầu.

## Tiện ích bổ sung đa phương thức

Plugin `qwen` cung cấp các khả năng đa phương thức chỉ trên các endpoint DashScope **Standard**,
không cung cấp trên các endpoint Coding Plan:

* **Hiểu hình ảnh và video** qua `qwen3.6-plus`
* **Tạo video bằng Wan** qua `wan2.6-t2v` (mặc định), `wan2.6-i2v`, `wan2.6-r2v`, `wan2.6-r2v-flash`, `wan2.7-r2v`

Khả năng hiểu nội dung đa phương tiện được tự động phân giải từ thông tin xác thực Qwen đã cấu hình; không cần
cấu hình bổ sung. Hãy đảm bảo bạn đang sử dụng endpoint Standard (trả phí theo mức sử dụng) để
khả năng hiểu nội dung đa phương tiện hoạt động.

Để đặt Qwen làm nhà cung cấp video mặc định:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },
    },
  },
}
```

Giới hạn tạo video: 1 video đầu ra cho mỗi yêu cầu, tối đa 1 hình ảnh đầu vào
(chuyển hình ảnh thành video), tối đa 4 video đầu vào (chuyển video thành video), thời lượng
tối đa 10 giây. Hỗ trợ `size`, `aspectRatio`, `resolution`, `audio` và
`watermark`. Hình ảnh/video tham chiếu đầu vào yêu cầu URL http(s) từ xa; đường dẫn
tệp cục bộ bị từ chối ngay từ đầu vì điểm cuối video DashScope không
chấp nhận bộ đệm cục bộ đã tải lên cho các tham chiếu đó.

<Note>
  Xem [Tạo video](/vi/tools/video-generation) để biết các tham số công cụ dùng chung, cách chọn nhà cung cấp và hành vi chuyển đổi dự phòng.
</Note>

## Cấu hình nâng cao

<AccordionGroup>
  <Accordion title="Khả dụng của Qwen 3.6 và 3.7">
    `qwen3.7-plus` và `qwen3.6-plus` khả dụng trên các điểm cuối Coding Plan và Standard. `qwen3.7-max` và `qwen3.6-flash` chỉ khả dụng trên Standard. Các điểm cuối Standard (trả phí theo mức sử dụng) là:

    * Trung Quốc: `dashscope.aliyuncs.com/compatible-mode/v1`
    * Toàn cầu: `dashscope-intl.aliyuncs.com/compatible-mode/v1`

    OpenClaw loại bỏ `qwen3.7-max` và `qwen3.6-flash` khỏi danh mục Coding Plan.
    Nếu một điểm cuối Coding Plan trả về lỗi "mô hình không được hỗ trợ" đối với một trong hai,
    hãy chuyển sang điểm cuối Standard tương ứng và khóa tương ứng.
  </Accordion>

  <Accordion title="Định tuyến khu vực cho tác vụ tạo video">
    OpenClaw ánh xạ khu vực Qwen đã cấu hình đến máy chủ AIGC DashScope tương ứng
    trước khi gửi tác vụ video:

    * Toàn cầu/Quốc tế: `https://dashscope-intl.aliyuncs.com`
    * Trung Quốc: `https://dashscope.aliyuncs.com`

    Một `models.providers.qwen.baseUrl` thông thường trỏ đến máy chủ Qwen Coding Plan
    hoặc Standard vẫn định tuyến tác vụ tạo video đến điểm cuối video DashScope
    theo khu vực tương ứng.
  </Accordion>

  <Accordion title="Khả năng tương thích sử dụng chế độ truyền trực tuyến">
    Các điểm cuối Qwen gốc công bố khả năng tương thích sử dụng chế độ truyền trực tuyến trên phương thức truyền tải
    `openai-completions` dùng chung, vì vậy các mã định danh nhà cung cấp tùy chỉnh tương thích với DashScope
    nhắm đến cùng các máy chủ gốc sẽ kế thừa cùng hành vi mà không yêu cầu riêng
    mã định danh nhà cung cấp tích hợp sẵn `qwen`. Điều này áp dụng cho các điểm cuối Coding Plan,
    Standard và Token Plan:

    * `https://coding.dashscope.aliyuncs.com/v1`
    * `https://coding-intl.dashscope.aliyuncs.com/v1`
    * `https://dashscope.aliyuncs.com/compatible-mode/v1`
    * `https://dashscope-intl.aliyuncs.com/compatible-mode/v1`
    * `https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`
    * `https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1`
  </Accordion>

  <Accordion title="Kế hoạch về khả năng">
    Plugin `qwen` đang được định vị là nơi tập trung phía nhà cung cấp cho toàn bộ bề mặt Qwen
    Cloud, không chỉ các mô hình lập trình/văn bản.

    * **Mô hình văn bản/trò chuyện:** khả dụng thông qua Plugin
    * **Gọi công cụ, đầu ra có cấu trúc, suy luận:** được kế thừa từ phương thức truyền tải tương thích với OpenAI
    * **Tạo hình ảnh:** được lên kế hoạch ở lớp Plugin nhà cung cấp
    * **Hiểu hình ảnh/video:** khả dụng thông qua Plugin trên điểm cuối Standard
    * **Giọng nói/âm thanh:** được lên kế hoạch ở lớp Plugin nhà cung cấp
    * **Nhúng/xếp hạng lại bộ nhớ:** được lên kế hoạch thông qua bề mặt bộ điều hợp nhúng
    * **Tạo video:** khả dụng thông qua Plugin nhờ khả năng tạo video dùng chung
  </Accordion>

  <Accordion title="Thiết lập môi trường và daemon">
    Nếu Gateway chạy dưới dạng daemon (launchd/systemd), hãy đảm bảo `QWEN_API_KEY`
    hoặc `QWEN_TOKEN_PLAN_API_KEY` khả dụng cho tiến trình đó (ví dụ: trong
    `~/.openclaw/.env` hoặc thông qua `env.shellEnv`).
  </Accordion>
</AccordionGroup>

## Liên quan

<CardGroup cols={2}>
  <Card title="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="Tạo video" href="/vi/tools/video-generation" icon="video">
    Các tham số công cụ video dùng chung và cách chọn nhà cung cấp.
  </Card>

  <Card title="Alibaba Model Studio" href="/vi/providers/alibaba" icon="cloud">
    Nhà cung cấp tạo video Wan đi kèm trên cùng nền tảng DashScope.
  </Card>

  <Card title="Khắc phục sự cố" href="/vi/help/troubleshooting" icon="wrench">
    Hướng dẫn khắc phục sự cố chung và câu hỏi thường gặp.
  </Card>
</CardGroup>