> 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

# Xử lý sự cố

Clanzy không trả lời, không gán role hay không tạo phòng voice? Tìm đúng tin lỗi bạn thấy và cách sửa, đa số chỉ mất một phút.

Mỗi trang dưới đây đặt tên theo đúng điều bạn thấy: tin lỗi của Clanzy, của Discord, hoặc chuyện "bấm mà không có gì xảy ra". Phần lớn lỗi đến từ hai nguyên nhân: role của Clanzy nằm thấp hơn role nó cần gán, hoặc bot bị gỡ một quyền ở kênh hay danh mục nào đó.

## Kiểm tra mấy điều này trước

1. **Bot có đang chạy không?** Xem [trang trạng thái](https://clanzy.app/status). Nếu đang có sự cố, bạn không cần làm gì, Clanzy sẽ chạy lại.
2. **Thứ tự role**: trong **Cài đặt máy chủ → Vai trò**, kéo role **Clanzy** lên trên các role game, role giới tính và role thành viên. Xem [thứ tự role](https://clanzy.app/docs/getting-started/role-order).
3. **Quyền của bot**: Clanzy 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ả ở kênh và danh mục nó dùng. Xem [quyền của Clanzy](https://clanzy.app/docs/getting-started/permissions).
4. **Quyền của bạn**: lệnh `/setup` và bảng điều khiển cần quyền **Quản lý máy chủ**.

Vẫn chưa được? Gửi thư tới team@clanzy.app, xem [hỗ trợ](https://clanzy.app/docs/support).

## Các lỗi thường gặp

- [Clanzy offline hoặc không phản hồi](https://clanzy.app/docs/troubleshooting/bot-offline): Clanzy hiện offline, lệnh báo ứng dụng không phản hồi hoặc bot im lặng trong một kênh? Kiểm tra trang trạng thái, bot còn trong server và quyền Xem kênh.
- [Không thấy lệnh / của Clanzy](https://clanzy.app/docs/troubleshooting/slash-commands-not-showing): Gõ / mà không thấy /setup hay lệnh nào của Clanzy? Thường do thiếu quyền Quản lý máy chủ, cài đặt Tích hợp của server hoặc Discord chưa tải lại danh sách lệnh.
- [Clanzy báo thiếu quyền: Missing Permissions](https://clanzy.app/docs/troubleshooting/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.
- [Không gán được role: role của Clanzy nằm thấp](https://clanzy.app/docs/troubleshooting/role-too-low): Clanzy báo Không gán được: @Valorant? Discord chỉ cho bot gán role nằm dưới role của bot. Kéo role Clanzy lên trên trong Cài đặt máy chủ → Vai trò là xong.
- [Vào kênh Tạo phòng mà không có phòng voice](https://clanzy.app/docs/troubleshooting/voice-room-not-created): Vào kênh ➕ Tạo phòng mà Clanzy không tạo phòng riêng, hoặc bị đá ra kèm lời nhắc đợi vài giây? Kiểm tra thời gian chờ, kênh tạo phòng và quyền của bot.
- [Phòng voice tạm không tự xoá khi hết người](https://clanzy.app/docs/troubleshooting/voice-room-not-deleted): Phòng voice tạm vẫn còn sau khi mọi người rời đi? Xem ai còn trong phòng, bot có đang chạy, có quyền Quản lý kênh và phòng có phải do Clanzy tạo không.
- [Chỉ chủ phòng mới làm được việc này](https://clanzy.app/docs/troubleshooting/cannot-control-room): Bấm Khoá, Đổi tên hay Đá khỏi phòng mà Clanzy báo chỉ chủ phòng mới làm được, hoặc bạn cần ở trong phòng tạm? Đây là lý do và cách nhận hay chuyển chủ phòng.
- [Discord chỉ cho đổi tên 2 lần mỗi 10 phút](https://clanzy.app/docs/troubleshooting/rename-limit): Đổi tên phòng voice tạm mà Clanzy báo Discord chỉ cho đổi tên 2 lần mỗi 10 phút? Đây là giới hạn của Discord cho mỗi kênh. Đợi vài phút là đổi được.
- [Thành viên trả lời xong mà không nhận được role](https://clanzy.app/docs/troubleshooting/onboarding-roles-not-given): Thành viên chọn game mà không có role, hoặc Clanzy báo máy chủ chưa bật câu hỏi làm quen? Kiểm tra phần Làm quen, role của từng game và vị trí role Clanzy.
- [Clanzy không gửi lời chào thành viên mới](https://clanzy.app/docs/troubleshooting/welcome-not-sent): Có người mới vào server mà Clanzy không chào? Kiểm tra lời chào có bật, kênh chào mừng, quyền gửi tin của bot và quy tắc mỗi thành viên chỉ được chào một lần.
- [Không thấy server trên bảng điều khiển](https://clanzy.app/docs/troubleshooting/dashboard-server-missing): Đăng nhập bảng điều khiển mà không thấy server của mình? Bạn cần là chủ server hoặc có quyền Quản lý máy chủ, đúng tài khoản Discord, rồi làm mới danh sách.
- [Bot riêng gặp sự cố](https://clanzy.app/docs/troubleshooting/branded-bot): Bot riêng báo token không hợp lệ, thiếu quyền đặc biệt, không trả lời, lệnh hiện hai lần hoặc đã gỡ Clanzy chính? Nguyên nhân và cách sửa từng trường hợp.
- [Lá chắn chặn nhầm hoặc không chặn](https://clanzy.app/docs/troubleshooting/shield): Lá chắn timeout nhầm thành viên, không chặn được tin lừa đảo, hoặc báo thiếu quyền? Cách gỡ, cách giảm chặn nhầm và cách cấp quyền cho Lá chắn.

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