> Chỉ mục toàn bộ tài liệu Clanzy (cho AI agent): https://clanzy.app/llms.txt · Trang HTML: https://clanzy.app/docs/getting-started/role-order

# Xếp role cho Clanzy

Vì sao role Clanzy phải nằm trên role game, giới tính và Thành viên, cách kéo role trên máy tính và điện thoại, cách kiểm tra và các cảnh báo bot gửi.

Discord có một luật cứng: bot chỉ gán và gỡ được những role **nằm dưới** role cao nhất của nó. Khi thêm Clanzy, Discord tạo role **Clanzy** và thường đặt nó gần cuối danh sách. Nếu role game, role giới tính hay role **Thành viên** nằm trên role đó, Clanzy không gán được, dù đã có quyền **Quản lý vai trò**.

## Khi nào cần kéo role

- Role do `/setup` tạo mới đã nằm dưới role Clanzy, thường không cần làm gì.
- Role **có sẵn từ trước** mà trùng tên game (ví dụ role **Valorant** bạn tạo hồi xưa) được Clanzy dùng lại. Role này có thể đang nằm trên role Clanzy.
- Role bạn chọn tay trên [bảng điều khiển](https://app.clanzy.app/?open=onboarding).
- Bạn hoặc mod kéo role Clanzy xuống sau này.

Thứ tự nên có, từ trên xuống: role Admin và Mod, rồi **Clanzy**, rồi các role game, **Nam**, **Nữ**, **Thành viên**. Không cần và không nên đặt Clanzy trên role Admin.

## Kéo role trên máy tính

1. Bấm tên server ở góc trên bên trái, chọn **Cài đặt máy chủ**.
2. Chọn **Vai trò**.
3. Nắm role **Clanzy** và kéo lên trên các role game, giới tính và Thành viên.
4. Bấm **Lưu thay đổi** ở thanh hiện ra phía dưới.

## Kéo role trên điện thoại

1. Mở server, chạm vào tên server ở trên cùng, chọn **Cài đặt**.
2. Chọn **Vai trò**.
3. Nhấn giữ role **Clanzy** rồi kéo lên trên các role cần gán, sau đó lưu.

Nếu app trên máy bạn không kéo được, làm trên máy tính hoặc mở Discord bằng trình duyệt.

> [!NOTE]
> Bạn chỉ kéo được những role nằm dưới role cao nhất của chính bạn. Chủ server thì kéo được tất cả. Không kéo được role Clanzy lên thì nhờ chủ server làm.

## Kiểm tra đã đúng chưa

- Chạy lại [`/setup onboarding`](https://clanzy.app/docs/commands/setup-onboarding). Nếu không còn dòng ⚠️ về role là ổn.
- Trên [bảng điều khiển](https://app.clanzy.app/?open=onboarding), mục Làm quen hết thông báo **Clanzy chưa gán được ... role**, và ô chọn role không còn ghi **Clanzy chưa gán được role này**. Nhớ bấm làm mới danh sách role sau khi kéo.
- Gõ [`/setup welcome-test`](https://clanzy.app/docs/commands/setup-welcome-test), bấm **Bắt đầu** trên thẻ chào, chọn game và xem role về đủ không. Muốn thử lại thì dùng [`/roles`](https://clanzy.app/docs/commands/roles).

## Cảnh báo Clanzy gửi

Khi chạy `/setup all` hoặc `/setup onboarding`, nếu có role nằm trên role Clanzy, bảng tóm tắt có dòng:

> Lưu ý: kéo role **Clanzy** lên trên các role này trong Cài đặt máy chủ → Vai trò để bot gán được: ...

Khi thành viên trả lời câu hỏi làm quen mà có role không gán được, họ thấy:

> Không gán được: ... Role của Clanzy cần nằm **trên** các role này (Cài đặt máy chủ → Vai trò).

Clanzy vẫn gán các role còn lại, chỉ bỏ qua role bị kẹt. Kéo role xong, thành viên gõ `/roles` và gửi lại là nhận đủ.

Vẫn không được? Xem [Role của Clanzy quá thấp](https://clanzy.app/docs/troubleshooting/role-too-low) và [Thành viên không nhận được role](https://clanzy.app/docs/troubleshooting/onboarding-roles-not-given).

Cập nhật: 2026-11-19
