Exclusão em Massa de Mensagens no Discord: O Comando /clear e Seus Limites

Módulo, permissões em ambos os lados e canal de log

• O módulo de Moderação deve estar ativado. Se o botão Moderação e Punição na tela de Visão Geral do painel estiver desativado, o /clear não funcionará. O bot responderá: "O comando /clear está vinculado ao módulo de Moderação e Punição e este módulo está desativado no seu servidor."
• Você deve ter a permissão Gerenciar Mensagens. Por padrão, o Discord exibe o comando apenas para membros que possuem essa permissão. Se você não tiver a permissão, a resposta será: "Você precisa ter a permissão Gerenciar Mensagens para usar este comando."
• O bot também precisa ter permissão. O VeyroBot precisa conseguir ver aquele canal, ler o histórico de mensagens e ter a permissão Gerenciar Mensagens no canal. Uma negação em nível de canal substitui a permissão do cargo.
• Um canal de log deve estar selecionado. Para que a limpeza seja enviada ao canal de log de moderação, o módulo deve estar ativado na aba Registros de Auditoria e um Canal de Log de Moderação deve estar selecionado. Se nenhum canal estiver selecionado, o caso ainda será registrado, mas a mensagem de log não será enviada.

Este tema no VeyroBot:Bot de moderação para Discord →

Passo 1: Excluir mensagens recentes

Digite /clear amount:30. O argumento amount é obrigatório e deve estar entre 1 e 100; o Discord não aceita números fora dessa faixa. O comando pega as últimas 30 mensagens do canal onde você digitou e as exclui. Não importa quem as escreveu; as mensagens do bot também estão incluídas.

A resposta é visível apenas para você: "Com sucesso, foram excluídas 30 mensagens." O número aqui é a quantidade de mensagens realmente excluídas. Se for menor do que você queria, o motivo geralmente é a regra de 14 dias explicada abaixo. Para excluir mais de 100 mensagens, execute o comando novamente; cada execução abre um caso separado.

Passo 2: Excluir mensagens de um único usuário

/clear amount:50 target:@usuario exclui apenas as mensagens daquele usuário. Detalhe importante: o bot primeiro pega as últimas 50 mensagens do canal e, em seguida, exclui aquelas que pertencem a esse usuário dentre elas. Ou seja, o que é excluído não são as últimas 50 mensagens do usuário, mas sim as mensagens dele dentro das últimas 50 mensagens do canal. Se o usuário escreveu pouco recentemente, o número excluído será pequeno; se necessário, aumente o valor de amount para 100.

Você também pode selecionar um bot na opção target; nesse caso, apenas as mensagens daquele bot serão excluídas.

O /clear funciona apenas no canal onde você digitou o comando e não há opção para escolher outro canal. Para limpar as mensagens de uma conta que está spamando em vários canais, use a opção delete_messages do comando /ban ao banir a conta: as mensagens da pessoa na última 1 hora, nas últimas 24 horas ou nos últimos 7 dias também serão excluídas. A escolha entre ban e timeout é explicada no guia de ban temporário e timeout.

Regra de 14 dias: por que algumas mensagens não são excluídas?

O Discord não permite a exclusão em massa de mensagens com mais de 14 dias. Em vez de tentar excluir essas mensagens e dar erro, o VeyroBot as filtra antecipadamente. Por exemplo, se 20 das últimas 50 mensagens tiverem mais de 14 dias, apenas 30 serão excluídas e a resposta dirá 30. Se todas as mensagens tiverem mais de 14 dias, a resposta será "Com sucesso, foram excluídas 0 mensagens."

Essas mensagens só podem ser excluídas uma a uma; não há um comando para isso no VeyroBot.

Onde a limpeza é registrada?

Como a organização dos canais de log e o sistema de avisos funcionam em conjunto é explicado no guia de canal de log e sistema de avisos.

Se as mensagens não foram excluídas ou se mais do que o esperado foi excluído

• Achar que o parêntese na mensagem de erro é o motivo. Se a exclusão falhar, a resposta será no formato: "Não foi possível excluir as mensagens (mensagens com mais de 14 dias não podem ser excluídas em massa pelo Discord): …" A nota entre parênteses aparece em todos os erros. Como as mensagens antigas já foram filtradas previamente, o verdadeiro motivo é o texto de erro do Discord que vem depois dos dois pontos. Se você vir Missing Permissions ali, o bot não tem a permissão necessária naquele canal.
• Achar que as mensagens fixadas estão seguras. O /clear não separa as mensagens fixadas; se estiverem entre as mensagens recentes, elas também serão excluídas. Comece com um número menor em canais onde as mensagens fixadas são importantes.
• Considerar a resposta "0 mensagens excluídas" como uma falha. Há três motivos possíveis: todas as mensagens selecionadas têm mais de 14 dias, o usuário que você definiu em target não tem nenhuma mensagem entre as mensagens recentes, ou o bot não tem permissão para ler o histórico de mensagens no canal.
• Executar no canal errado. O comando sempre limpa o canal em que você o digitou. Vá para o canal que deseja limpar e digite o comando lá.

É adequado para esvaziar um canal do início ao fim?

Adequado: staff que precisa organizar rapidamente um canal após spam, flood ou uma discussão prolongada; equipes que desejam manter registros de quem excluiu quantas mensagens.

Não adequado: quem deseja esvaziar um canal do início ao fim ou excluir histórico de semanas atrás. O limite de 100 mensagens por comando e o limite de 14 dias não são adequados para essa finalidade. Para evitar que o spam se repita, configure os filtros do AutoMod após a limpeza.

Perguntas frequentes

Posso excluir mais de 100 mensagens de uma vez?

Não. O limite de amount é 100. Para mais do que isso, execute o comando novamente; cada execução é registrada como um caso separado.

Os membros do canal veem a limpeza?

A resposta do comando é visível apenas para você e nenhuma mensagem de bot cai no canal. A limpeza é registrada apenas nos canais de log selecionados.

Posso recuperar as mensagens excluídas?

Não. As mensagens excluídas não podem ser recuperadas. O registro de exclusão em massa no canal de log de mensagens também contém apenas o canal e a quantidade, não o conteúdo.

Um caso é aberto mesmo quando nenhuma mensagem é excluída?

Sim. Se o comando for concluído sem erros, um caso será aberto mesmo que o número de mensagens excluídas seja 0, e 0 será escrito como o motivo.

Para uma introdução geral às ferramentas de moderação, confira a página de bot de moderação do Discord; para todas as configurações, os documentos de moderação e registros de auditoria; e para detalhes dos comandos, consulte os cards de clear, ban e vaka-gecmisi.

Última atualização: 26 de setembro de 2026. Os limites, comportamento de 14 dias, permissões e registros de log neste artigo foram verificados com o comando /clear, registro de casos e remetente de log na versão atual do VeyroBot.