清除消息
使用 /clear 批量删除最近的消息,可按用户、机器人、嵌入消息、链接或图片进行筛选。
用法
/clear amount:25 会删除当前频道中的最后 25 条消息。添加筛选条件后,可只删除其中一部分:机器人会查看最后 N 条消息,并删除符合条件的消息。
- amount
- 必填,范围为 1 到 100。表示要查看的最近消息数量。
- user
- 仅限该成员发送的消息。
- bots
- 仅限机器人发送的消息。
- embeds
- 仅限包含嵌入消息的消息。
- link
- 仅限包含链接的消息。
- images
- 仅限带有图片附件的消息。
14 天限制
Discord 的批量删除 API 会拒绝删除 14 天前的消息。机器人会静默地过滤掉这些消息,而不是让整个命令失败,因此“未找到符合筛选条件的消息”可能只是因为匹配的消息太旧了。较旧的消息必须在 Discord 中逐条删除。
权限
该命令在机器人端仅限管理员使用,而机器人本身需要在频道中拥有“管理消息”权限。如果某个频道的覆盖设置拒绝了机器人身份组的该权限,即使是管理员, /clear 也会失败。
被删除的消息无法恢复。请使用用户筛选,以免在清理垃圾消息时误删工作人员的回复。