> 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/moderation

# Quản lý thành viên: warn, timeout, kick, ban

Cảnh cáo, timeout, đuổi, cấm, dọn tin bằng lệnh tiếng Việt. Hồ sơ từng thành viên, tự xử khi đủ cảnh cáo, DM lý do. Miễn phí cho mọi server.

Clanzy có sẵn bộ lệnh quản lý cho mod, **miễn phí** cho mọi server: cảnh cáo, timeout, đuổi, cấm, dọn tin, và **hồ sơ** của từng thành viên. Thành viên bị xử nhận **DM bằng tiếng Việt** kèm lý do, nên không ai phải hỏi "sao em bị mute".

## Các lệnh

| Lệnh | Làm gì | Ai dùng được |
| --- | --- | --- |
| [`/warn`](https://clanzy.app/docs/commands/warn) `user:@Minh reason:...` | Cảnh cáo, tính vào luật tự xử | Mod có quyền **Hạn chế thành viên** |
| [`/timeout`](https://clanzy.app/docs/commands/timeout) `user:@Minh duration:1h` | Cấm chat và nói trong voice một thời gian | Mod có quyền **Hạn chế thành viên** |
| [`/untimeout`](https://clanzy.app/docs/commands/untimeout) | Gỡ timeout sớm | Mod có quyền **Hạn chế thành viên** |
| [`/kick`](https://clanzy.app/docs/commands/kick) | Đuổi khỏi server (vào lại được bằng link mời) | Mod có quyền **Đuổi thành viên** |
| [`/ban`](https://clanzy.app/docs/commands/ban) `days:1` | Cấm, có thể xoá tin của họ trong vài ngày gần nhất | Mod có quyền **Cấm thành viên** |
| [`/unban`](https://clanzy.app/docs/commands/unban) | Bỏ cấm (dán ID của người đó) | Mod có quyền **Cấm thành viên** |
| [`/purge`](https://clanzy.app/docs/commands/purge) `count:50` | Xoá nhanh tối đa 100 tin gần nhất trong kênh, có thể lọc theo người | Mod có quyền **Quản lý tin nhắn** |
| [`/cases`](https://clanzy.app/docs/commands/cases) `user:@Minh` | Xem hồ sơ: cảnh cáo còn hiệu lực, các lần bị xử, ai xử, lý do | Mod có quyền **Hạn chế thành viên** |

Thời gian timeout viết kiểu `10m`, `2h`, `1d`, `1w` hoặc số phút; viết tắt tiếng Việt `10p`, `2g`, `1n` cũng được. Discord cho timeout tối đa 28 ngày. Discord ẩn mỗi lệnh với người không có quyền tương ứng.

## Luật tự xử khi đủ cảnh cáo

Mỗi lần `/warn`, Clanzy đếm số cảnh cáo **còn hiệu lực** của người đó và áp luật của server. Mặc định:

- Đủ **3 cảnh cáo**: timeout 1 giờ.
- Đủ **5 cảnh cáo**: đuổi khỏi server.
- Quá mức cao nhất: áp lại luật cao nhất mỗi lần bị cảnh cáo thêm.

Bạn thêm, sửa, xoá luật ở [mục Quản lý thành viên](https://app.clanzy.app/?open=moderation): chọn số cảnh cáo, hành động (timeout, đuổi hoặc cấm) và thời gian timeout. Gói Miễn phí có 3 luật cảnh cáo, Pro có 10. Cảnh cáo cũ hơn **30 ngày** (mặc định, chỉnh được) không còn tính vào luật, nhưng vẫn nằm trong hồ sơ. Gỡ một cảnh cáo nhầm ngay trên bảng điều khiển.

## Clanzy không bao giờ xử nhầm người

- Không xử **chủ server** và người có quyền **Quản trị viên**.
- Chỉ xử người có role cao nhất **thấp hơn role của bạn** (chủ server thì không cần) và **thấp hơn role của Clanzy**. Role Clanzy thấp quá thì kéo lên trong **Cài đặt máy chủ → Vai trò**, xem [Xếp role cho Clanzy](https://clanzy.app/docs/getting-started/role-order).
- Không tự xử mình, không xử bot Clanzy.

## DM lý do bằng tiếng Việt

Thành viên nhận tin nhắn riêng: bị gì, ở server nào, lý do mod ghi. Với kick và ban, DM được gửi **trước** khi họ bị đuổi để họ còn đọc được. Ai tắt tin nhắn riêng thì mod được báo là không gửi được. Tắt DM, hoặc bắt buộc mod ghi lý do, ở [mục Quản lý thành viên](https://app.clanzy.app/?open=moderation).

## Hồ sơ và nhật ký

Mỗi lần xử là một **hồ sơ** có số (#1, #2...): thành viên, mod, hành động, lý do, thời điểm. Bảng điều khiển liệt kê mọi hồ sơ, lọc theo thành viên. Bật [nhật ký server](https://clanzy.app/docs/logs) thì mọi lần xử, kể cả `/purge`, được đăng vào kênh log cho cả team mod thấy. Hồ sơ được giữ 365 ngày rồi tự xoá.

## Server thêm Clanzy trước ngày 20/11/2026

Từ 20/11/2026 Clanzy xin thêm các quyền **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** và **Xem nhật ký kiểm tra** khi được thêm vào server. Server thêm bot trước đó sẽ thấy cảnh báo thiếu quyền ở [mục Quản lý thành viên](https://app.clanzy.app/?open=moderation), bấm **Cấp lại quyền** là xong, không mất cài đặt nào. Xem [Bot báo thiếu quyền](https://clanzy.app/docs/troubleshooting/missing-permissions).

Muốn chặn spam tự động thay vì xử tay: [Chống spam và raid](https://clanzy.app/docs/automod).

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

### Mod có xử được admin không?

Không. Clanzy không bao giờ đụng tới chủ server hay người có quyền Quản trị viên, và chỉ xử người có role thấp hơn cả bạn lẫn Clanzy.

### Cảnh cáo có hết hạn không?

Có. Mặc định cảnh cáo cũ hơn 30 ngày không còn tính vào luật tự xử. Bạn đổi số ngày (hoặc để không bao giờ hết hạn) trên bảng điều khiển. Hồ sơ vẫn giữ để mod xem lại.

### Đã có bot quản lý khác thì sao?

Clanzy làm đủ việc quản lý cơ bản miễn phí, nên bạn có thể gỡ bot cũ. Hồ sơ cũ ở bot kia không chuyển sang được, Clanzy bắt đầu hồ sơ mới từ lúc bạn dùng.

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