Skill Discord para OpenClaw

Visão Geral do Skill Discord do OpenClaw

O skill Discord conecta o OpenClaw aos seus servidores Discord através da Discord API, transformando seu agente de IA em um poderoso assistente Discord. Uma vez instalado, você pode enviar mensagens, gerenciar threads, fazer enquetes, enviar emojis e até lidar com moderação — tudo através de comandos em linguagem natural.

O Discord é uma das plataformas mais populares para comunidades de desenvolvedores, projetos open-source e comunicação em equipe. O skill Discord do OpenClaw elimina a necessidade de alternar contexto entre seu terminal e o Discord. Seja monitorando canais da comunidade, respondendo perguntas ou gerenciando configurações do servidor, uma simples conversa com o OpenClaw resolve tudo.

Fluxo de trabalho típico:

1. Peça ao OpenClaw para enviar uma mensagem ou verificar a atividade recente em um canal do Discord.
2. O agente chama a Discord API com a ação apropriada (por exemplo, sendMessage, readMessages).
3. Os resultados são retornados em um resumo legível — sem necessidade de troca de contexto.

Pré-requisitos para o Skill Discord

Antes de instalar o skill Discord, certifique-se de que você tem:

• OpenClaw instalado e em execução (v1.0+)
• Uma conta Discord com acesso aos servidores que deseja gerenciar
• Um bot Discord criado no Portal de Desenvolvedores com um token de bot
• O bot convidado para o seu servidor com as permissões necessárias
• clawhub CLI instalado para gerenciamento de skills

Verifique sua configuração:

# Verificar versão do OpenClaw
openclaw --version

# Verificar clawhub CLI
clawhub --version

Criando um Bot Discord

Se você ainda não tem um bot, siga estes passos:

1. Acesse o Portal de Desenvolvedores do Discord e clique em New Application.
2. Navegue até a aba Bot e clique em Add Bot.
3. Copie o token do bot — você precisará dele para a configuração.
4. Em Privileged Gateway Intents, ative o Message Content Intent se precisar que o skill leia o conteúdo das mensagens.
5. Use o OAuth2 URL Generator para criar um link de convite com o escopo bot e as permissões necessárias.

Como Instalar o Skill Discord

Instale o skill Discord com um único comando:

npx clawhub@latest install discord

Para verificar a instalação:

clawhub list

Você deve ver discord na lista de skills instalados. Você também pode visualizar o skill antes de instalar com clawhub inspect discord.

Configuração do Skill Discord

O skill Discord requer um token de bot para autenticação. Crie um bot no Portal de Desenvolvedores do Discord caso ainda não tenha feito.

Configuração do Ambiente

# Definir o token do bot Discord
export DISCORD_BOT_TOKEN=your_bot_token_here

Importante: Nunca insira tokens diretamente em arquivos de configuração. Use variáveis de ambiente ou um gerenciador de segredos como o 1Password.

Gateway Intents

O skill utiliza Discord Gateway Intents para receber eventos. Três intents são privilegiados e devem ser ativados no Portal de Desenvolvedores:

| Intent | Finalidade | Obrigatório? | |--------|-----------|--------------| | MESSAGE_CONTENT | Ler texto de mensagens, embeds e anexos | Sim, para readMessages | | GUILD_MEMBERS | Acessar eventos de entrada/saída de membros e listas de membros | Apenas se usar memberInfo | | GUILD_PRESENCES | Rastrear status online/offline dos usuários | Raramente necessário |

Ative apenas os intents que seu caso de uso requer. Para a maioria das configurações, apenas MESSAGE_CONTENT é suficiente.

Controle de Ações

O skill Discord suporta controle granular de ações. A maioria das ações é habilitada por padrão, mas ações sensíveis são desabilitadas:

| Ação | Padrão | Descrição | |------|--------|-----------| | discord.actions.moderation | false | Timeout, expulsão e banimento de usuários | | discord.actions.roles | false | Adicionar ou remover cargos de membros |

Para habilitar ações de moderação, atualize sua configuração do OpenClaw:

# Habilitar ações de moderação (use com cautela)
openclaw config set discord.actions.moderation true

Exemplos de Uso do Skill Discord

1. Enviar uma Mensagem para um Canal

Você: "Envie uma mensagem para o canal #announcements dizendo 'A versão 2.0 está no ar! Confira as notas de lançamento para mais detalhes.'"

O agente usa a ação sendMessage com o ID do canal de destino. Ele publica a mensagem e confirma a entrega com o link da mensagem.

2. Monitorar Perguntas da Comunidade

Você: "Leia as últimas 10 mensagens em #help-forum e resuma as perguntas não respondidas."

O agente chama readMessages no canal especificado, filtra mensagens sem respostas e retorna um resumo das perguntas não respondidas com links para cada thread.

3. Fazer uma Enquete na Comunidade

Você: "Crie uma enquete em #general perguntando 'Qual recurso devemos construir a seguir?' com as opções: Modo escuro, Aplicativo móvel, Melhorias na API, Documentação melhor. Deixe aberta por 24 horas."

O agente cria uma enquete usando a ação poll com até 10 opções de resposta. Ele define a duração e retorna uma confirmação com o link da enquete.

4. Enviar um Emoji Personalizado

Você: "Envie esta imagem como um emoji personalizado chamado 'ship_it' para nosso servidor."

O agente usa emojiUpload para adicionar a imagem (PNG/JPG/GIF, máximo 256KB) como emoji do servidor. Ele confirma o envio e mostra o código do emoji :ship_it: para uso em mensagens.

Segurança e Boas Práticas

O skill Discord pode realizar operações de escrita em seus servidores, incluindo envio de mensagens e — se habilitado — ações de moderação. Siga estas diretrizes para se manter seguro:

• Use o privilégio mínimo. Conceda ao bot apenas as permissões que ele realmente precisa. Evite conceder a permissão Administrator a menos que seja absolutamente necessário.
• Mantenha a moderação desabilitada por padrão. O skill desabilita as ações de moderation e roles por padrão. Habilite-as apenas se tiver uma necessidade específica e entender as implicações.
• Ative apenas os intents necessários. Intents privilegiados como MESSAGE_CONTENT e GUILD_MEMBERS devem ser ativados apenas quando seu fluxo de trabalho depender deles.
• Renove seu token de bot regularmente. Se suspeitar que um token foi comprometido, regenere-o imediatamente no Portal de Desenvolvedores.
• Revise antes de confirmar. O OpenClaw solicita confirmação para ações destrutivas. Sempre leia o resumo da ação antes de aprovar, especialmente para moderação e operações em massa.
• Audite a atividade do bot. Use o Registro de Auditoria do Discord para rastrear ações realizadas pelo seu bot e verificar se correspondem às suas expectativas.

Solução de Erros Comuns

"401: Unauthorized"

Seu token de bot está ausente, inválido ou foi regenerado.

1. Verifique se DISCORD_BOT_TOKEN está definido no seu ambiente.
2. Confirme que o token corresponde ao que está nas configurações do bot no Portal de Desenvolvedores.
3. Se o token foi regenerado recentemente, atualize sua variável de ambiente.

# Verificar se o token está definido
echo $DISCORD_BOT_TOKEN

"50001: Missing Access"

O bot não tem permissão para acessar o canal ou servidor de destino.

1. Confirme que o bot foi convidado para o servidor com as permissões corretas.
2. Verifique substituições de permissão no nível do canal que possam bloquear o bot.
3. Use a ação permissions para verificar as permissões efetivas do bot para um canal.

"MESSAGE_CONTENT intent is required"

Você está tentando ler o conteúdo de mensagens, mas o intent privilegiado MESSAGE_CONTENT não está ativado.

1. Acesse o Portal de Desenvolvedores → seu aplicativo → aba Bot.
2. Em Privileged Gateway Intents, ative o Message Content Intent.
3. Para bots verificados (75+ servidores), você deve solicitar este intent através do portal.