> 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/commands/ban

# /ban

Lệnh Clanzy /ban: Cấm khỏi server. Cú pháp, ai dùng được, quyền bot cần, ví dụ và các lỗi thường gặp.

Cấm một người khỏi server. Clanzy không bao giờ xử admin hay chủ server, và chỉ xử người có role thấp hơn bạn và thấp hơn role của Clanzy. Thành viên nhận DM kèm lý do (tắt được trên bảng điều khiển). Mỗi lần xử được ghi vào hồ sơ.

## Cú pháp

```
/ban user:<user> reason:<reason> days:<days>
```

Gõ `/` trong ô chat của máy chủ, chọn lệnh trong danh sách rồi điền các ô Discord hiện ra.

## Tham số

| Tên | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `user` | thành viên | Có | Người bị cấm (hoặc ID) |
| `reason` | chữ | Không | Lý do (gửi cho thành viên và ghi vào hồ sơ) (tối đa 500 ký tự) |
| `days` | số nguyên | Không | Xoá tin nhắn của họ trong bao nhiêu ngày gần nhất (0-7) (0–7) |

## Ai dùng được

- **Người dùng:** Mod có quyền Cấm thành viên. Discord ẩn lệnh này với người không có quyền đó.
- **Clanzy cần quyền:** Cấm thành viên.
- **Tính năng:** [Quản lý thành viên](https://clanzy.app/docs/moderation)

Xem [quyền và ai dùng lệnh nào](https://clanzy.app/docs/getting-started/permissions) để đổi ai thấy lệnh trong Discord.

## Ví dụ

| Bạn gõ | Clanzy làm |
| --- | --- |
| `/ban user:@Scammer reason:Gửi link lừa đảo days:1` | 🔨 Scammer bị cấm và tin nhắn của họ trong 1 ngày gần nhất bị xoá. Dán ID để cấm cả người đã rời server. |

## Trên bảng điều khiển web

Các cài đặt liên quan nằm trong [bảng điều khiển](https://app.clanzy.app/?open=moderation): chọn máy chủ, mục cài đặt sẽ mở sẵn.

## Lỗi có thể gặp

| Clanzy trả lời | Nghĩa là và cách sửa |
| --- | --- |
| Bạn cần quyền **Cấm thành viên** để dùng lệnh này. | Lệnh này cần quyền riêng: Đuổi thành viên cho /kick, Cấm thành viên cho /ban và /unban, Quản lý tin nhắn cho /purge. Nhờ admin cấp cho role của bạn. [Chi tiết](https://clanzy.app/docs/moderation) |
| Clanzy thiếu quyền **Cấm thành viên**. Nhờ admin cấp quyền trên bảng điều khiển (mục Quản lý thành viên). | Clanzy được thêm trước khi có tính năng quản lý nên thiếu quyền. 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. [Chi tiết](https://clanzy.app/docs/troubleshooting/missing-permissions) |
| Không tự xử mình được đâu 😅 | Bạn vừa chọn chính mình. Chọn thành viên cần xử. |
| Không thể xử admin. Clanzy không bao giờ đụng tới người có quyền Quản trị viên. | Clanzy không bao giờ xử người có quyền Quản trị viên hay chủ server. Xử lý trực tiếp trong Discord nếu thật sự cần. [Chi tiết](https://clanzy.app/docs/moderation) |
| @Tuan có role ngang hoặc cao hơn bạn, bạn không xử được. | Role cao nhất của người đó ngang hoặc trên role của bạn. Nhờ người có role cao hơn xử. [Chi tiết](https://clanzy.app/docs/moderation) |
| Role của @Tuan nằm trên role của Clanzy. Kéo role Clanzy lên cao hơn (Cài đặt máy chủ → Vai trò) rồi thử lại. | Role của người đó nằm trên role của Clanzy. Kéo role Clanzy lên cao hơn trong Cài đặt máy chủ → Vai trò. [Chi tiết](https://clanzy.app/docs/getting-started/role-order) |

## Lệnh liên quan

- [`/unban`](https://clanzy.app/docs/commands/unban): Bỏ cấm một người
- [`/kick`](https://clanzy.app/docs/commands/kick): Đuổi một thành viên khỏi server
- [`/cases`](https://clanzy.app/docs/commands/cases): Hồ sơ xử phạt của một thành viên
- Tất cả lệnh: [danh sách lệnh](https://clanzy.app/docs/commands)

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