> 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/troubleshooting/missing-permissions

# Clanzy báo thiếu quyền: Missing Permissions

Lệnh /setup báo Không làm được bước này: Missing Permissions, hoặc nút trên bảng điều khiển phòng báo có lỗi? Cấp lại đủ quyền cho Clanzy ở server và ở kênh.

Thông báo bạn thấy: "Không làm được bước này: Missing Permissions"

## Triệu chứng

- Chạy `/setup all` (hoặc `/setup welcome`, `/setup onboarding`, `/setup voice`), bảng kết quả có dòng ⚠️ **Không làm được bước này: Missing Permissions** hoặc **Missing Access**.
- Bấm nút trên bảng điều khiển phòng voice hay gõ lệnh `/voice`, Clanzy trả lời **Có lỗi xảy ra. Bạn thử lại sau nhé.**
- Lời chào không được gửi, phòng tạm không được tạo dù bot đang online.

## Nguyên nhân

1. **Role Clanzy bị gỡ bớt quyền** sau khi thêm bot, hoặc bot được thêm bằng link mời khác thiếu quyền.
2. **Kênh hoặc danh mục chặn riêng Clanzy** (hoặc chặn @everyone mà không cho Clanzy ngoại lệ). Quyền ở kênh đè lên quyền ở server.
3. **Role cần gán nằm trên role Clanzy.** Lỗi này có trang riêng: [role của Clanzy nằm thấp](https://clanzy.app/docs/troubleshooting/role-too-low).

## Cách sửa

1. Cấp lại quyền ở cấp server. Cách nhanh nhất: mở [/invite](https://clanzy.app/invite), chọn đúng server và xác nhận. Hoặc làm tay: **Cài đặt máy chủ** → **Vai trò** → **Clanzy** → **Quyền**, bật đủ các quyền sau:

| Quyền | Dùng để |
| --- | --- |
| **Quản lý kênh** (Manage Channels) | Tạo kênh chào mừng, danh mục, kênh tạo phòng, phòng tạm và xoá phòng trống |
| **Quản lý vai trò** (Manage Roles) | Tạo role game, gán và gỡ role, khoá, ẩn, đá người trong phòng tạm |
| **Di chuyển thành viên** (Move Members) | Chuyển bạn vào phòng mới, đá người khỏi phòng |
| **Xem kênh**, **Kết nối** | Thấy kênh tạo phòng và các phòng tạm |
| **Gửi tin nhắn**, **Nhúng liên kết**, **Đọc lịch sử tin nhắn** | Gửi thẻ chào mừng và bảng điều khiển phòng |
| **Hạn chế thành viên**, **Đuổi thành viên**, **Cấm thành viên**, **Quản lý tin nhắn** | [Quản lý thành viên](https://clanzy.app/docs/moderation) và [chống spam](https://clanzy.app/docs/automod) |
| **Xem nhật ký kiểm tra** (View Audit Log) | Ghi ai xoá tin, đổi role trong [nhật ký server](https://clanzy.app/docs/logs) |

2. Kiểm tra quyền ở kênh và danh mục liên quan: chuột phải (điện thoại: nhấn giữ) vào kênh chào mừng, danh mục **🔊 Phòng tạm** và kênh **➕ Tạo phòng** → **Chỉnh sửa kênh** → **Quyền**. Nếu Clanzy hoặc @everyone bị gạch đỏ ở quyền nào trong bảng trên, thêm role **Clanzy** và bật dấu tích xanh cho quyền đó.
3. Chạy lại `/setup all`. Lệnh dùng lại những gì đã có nên chạy lại không tạo trùng ([chi tiết](https://clanzy.app/docs/getting-started/setup-all)).

> [!TIP]
> Chỉ cấp đúng các quyền trên là đủ, không cần **Quản trị viên**. Giải thích từng quyền ở trang [quyền của Clanzy](https://clanzy.app/docs/getting-started/permissions).

> [!NOTE]
> Server thêm Clanzy trước ngày 20/11/2026 thiếu các quyền cho mod. Mở mục **Quản lý thành viên** trên bảng điều khiển và bấm **Cấp lại quyền**, cài đặt giữ nguyên.

## Vẫn chưa được?

Liên hệ qua [trang hỗ trợ](https://clanzy.app/docs/support), gửi kèm ảnh chụp bảng kết quả `/setup`. Xem tình trạng bot ở [/status](https://clanzy.app/status).

## Câu hỏi thường gặp

### Clanzy có cần quyền Quản trị viên không?

Không. Clanzy chỉ cần Quản lý kênh, Quản lý vai trò, Di chuyển thành viên, Xem kênh, Gửi tin nhắn, Nhúng liên kết, Đọc lịch sử tin nhắn và Kết nối.

### Cách nhanh nhất để cấp lại đủ quyền là gì?

Mở trang /invite và thêm Clanzy vào đúng server một lần nữa. Discord cập nhật lại quyền cho role Clanzy mà không xoá cài đặt của bạn. Sau đó kiểm tra các kênh hoặc danh mục có chặn riêng role Clanzy không.

### Missing Access khác Missing Permissions thế nào?

Missing Access thường nghĩa là Clanzy không xem được kênh đó. Missing Permissions nghĩa là bot thấy kênh nhưng thiếu một quyền cụ thể, ví dụ Quản lý kênh hay Quản lý vai trò.

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