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

# /warn

Lệnh Clanzy /warn: Cảnh cáo thành viên. Cú pháp, ai dùng được, quyền bot cần, ví dụ và các lỗi thường gặp.

Cảnh cáo một thành viên. 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

```
/warn user:<user> reason:<reason>
```

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ảnh cáo |
| `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ự) |

## Ai dùng được

- **Người dùng:** Mod có quyền Hạn chế thành viên (timeout). Discord ẩn lệnh này với người không có quyền đó.
- **Clanzy cần quyền:** Hạn chế 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 |
| --- | --- |
| `/warn user:@Minh reason:Spam tag cả kênh` | ⚠️ Đã cảnh cáo Minh (hồ sơ #12). Đang có 2 cảnh cáo. Minh nhận DM kèm lý do. Đủ 3 cảnh cáo thì Clanzy tự timeout theo luật của 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 |
| --- | --- |
| Lệnh này dành cho mod: bạn cần quyền **Hạn chế thành viên** (timeout). | Lệnh dành cho mod. Nhờ admin cấp cho role của bạn quyền Hạn chế thành viên (timeout). [Chi tiết](https://clanzy.app/docs/voice-history) |
| Server này yêu cầu ghi lý do. Thêm `reason:` rồi gửi lại nhé. | Admin đã bật Bắt buộc ghi lý do. Thêm ô reason rồi gửi lại. [Chi tiết](https://clanzy.app/docs/moderation) |
| 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

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

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