Novo código da ravena completamente desenvolvido utilizando LLM Claude 3.7 Sonnet e Gemini 2.5 Pro. Esta versão apresenta uma arquitetura modular, suporte a múltiplas instâncias, comandos personalizáveis e integração com plataformas de streaming. Livre para uso, sem garantias. Consulte o arquivo "Prompts" para ver as coisas que eu pedi pro Claude. Leia mais sobre os design patterns aqui.
RavenaBot é um bot para WhatsApp que vem sendo desenvolvido há quase 4 anos (desde 2021), apenas como uma brincadeira/hobby. Começou como um bot da twitch (pra aprender um pouco da API deles com python) e depois foi integrado ao WhatsApp (pra aprender sobre nodejs) - virando um spaghetti code absurdo, aí veio a ideia de refazer todo o código do zero, mas com uma ajudinha especial dos LLM (pra ver o estado atual de criação de código assistido por IA). O foco deste bot é a utilização do mesmo em grupos, onde ele pode notificar status das lives, responder comandos com utilidades (!clima, !gpt, ..,), criar comandos personalizados do grupo (como nightbot, StreamElements, etc.).
Este bot foi implemetado utilizando quatro tecnologias:
- whatsapp-web.js: Manipula o WhatsAppWeb através de um navegador controlado pelo puppeteer, fácil de configurar, mas com muitas mensagens fica com delay, trava e/ou desconecta. Recomendo muito utilizar ele, pela facilidade de configurar - o padrão do bot é usar isso, não se preocupe
- EvoutionAPI - GO: Os bots ficam logados no Evolution que utiliza o Whatsmeow, direto no websocket do whatsapp, mas usando Go. Extremamente robusto e rápido e não dá delays, mais difícil de implementar. Este é como as ravenas oficiais se conectam atualmente. Para ativar, é necessário definir no bots.json
- EvoutionAPI: Os bots ficam logados no Evolution que utiliza o Baileys, direto no websocket do whatsapp. Rápido e não dá muitos delays, mais difícil de implementar. Para ativar, é necessário definir no bots.json
- Telegram Bot: Também possuímos suporte para o Telegram, rodando o bot ravenosabot e o grupo da comunidade.
Obs.: Eu criei o wrapper pra EvolutionAPI me baseando na implementação do wwebjs, então existem muitos fallbacks, não se assuste.
- Básico de Mídia - Stickers, stickers sem fundo, baixa vídeos/música do youtube, baixa gifs, imagens, converte formatos, muda volume e mais!
- Sistema modular de Comandos - Comandos fixos implementados por arquivo que todos podem ajudar a expandir + Interpretador comandos personalizados que podem ser cirados em tempo real dentro dos grupos
- Plataformas de Streaming - Monitoramento de Twitch, Kick e YouTube com notificações customizáveis dentro dos grupos
- Jogos - Roleta russa, pescaria, pokemon, geoguesser... Tudo isso no chat do grupo
- Zoeira - Comandos de zueira pra entreter os memrbos
- Interações no Grupo - Mensagens de boas vindas, despedidas, resumo de conversas, interações inteligentes
- Integração com LLMs - Código pronto pra utilizar APIs OpenRouter, Gemini, ChatGPT e locais com o LMStudio
- StableDiffusion - Gera imagens via sdwebui e envia direto no whats, rodando local sem pagar APIs
- Filtros de Mensagens - Apaga mensagens com palavras específicas, links e também detecta conteúdo 18+
- Sistema de Convites - O bot processa links de convites e possui comandos para que o administrador coloque o bot nos grupos de forma remota
- Painel de Controle Web - Possui um painel de controle web (!g-painel) para configurar as opções do grupo
- Multiplas instâncias - Múltiplos bots rodam com o mesmo código, compartilhando a base de dados
- Gerenciamento de Grupos: Ferramentas para administradores
- Sistema de Convites: Controle quem pode adicionar o bot a grupos
- Interações Automáticas: O bot pode interagir aleatoriamente com mensagens
Se você quer interagir com o bot e testar ele, eu disponibilizo o mesmo gratuitamente em alguns números, você pode conferir o status dos bots aqui neste link
Se você não entende nada de programação ou nunca rodou aplicativos via código fonte, o melhor mesmo é chamar seu amigo da TI pra dar aquele help. O programa foi feito para rodar em Windows e Linux (MacOS deve funcionar sem problemas, é claro). Já rodei muito em Raspberry Pi/OrangePi e similares, mas nunca tentei rodar diretamente num Android.
Sem isso, não vai dar pra rodar o bot.
- Um servidor capaz de rodar o nodejs e todas as dependências
- Um celular com whatsapp ativo (NÃO USE O SEU CHIP PARTICULAR, COMPRE UM SÓ PRA ISSO!)
- Node.js
- Google Chrome: Para poder enviar vídeos é necessário o Chrome (somente para whatsapp-web.js)
- FFmpeg: (para processamento de áudio e vídeo)
Para funções bastante utilizadas do bot
- ImageMagick: Comandos de efeito em imagens
- faster-whisper: Para transcrição de áudios (speech-to-text) - fácil de usar, binaries prontos
- alltalk_tts: Texto pra voz, ferramenta grátis e poderosa (dá até pra copiar voz dos outros!)
- API - Gemini: Na minha opinião, a melhor LLM Free (gemini-2.0-flash-exp)
- API - OWM: API grátis de previsão do tempo
- LM Studio: Caso não queira usar APIs para IA, que podem gerar custos, hospede sua própria. Recomendo utilizar o
google/gemma-3-12bda google - Ollama: Mesmo padrão do LM Studio, use um ou outro, os 2 juntos seria apenas para redundância
- stable-diffusion-webui: Para gerar imagens com IA localmente
- API - Giphy: Para busca de GIFs
- API - OMDB: Para busca de informação de filmes (IMDB Free)
- API - Unsplash: Busca de Imagens
- API - Last.fm: Busca no Last.fm (perfis, infos)
- API - RiotGames: Busca de ELO informações de jogos da Riot
- API - Placas: API paga para busca de placas de carros (não é das melhores, mas é barato!)
- EvolutionAPI: Alternativa ao wwebjs que roda no chrome, use apenas se quiser rodar com MUITOS (200+) grupos
-
Clone o repositório:
git clone https://github.com/moothz/ravena-ai.git cd ravena-ai -
Copie o arquivo
.env.examplepara.env -
Configure o arquivo
.env(veja a seção Configuração) -
Copie o arquivo
service-providers.json.exampleparaservice-providers.json -
Configure os provedores de APIs (LLM, Whisper, etc) no
service-providers.jsonou via painel web/service-providers -
Copie o arquivo
bots.json.exampleparabots.json -
Configure o arquivo
bots.json -
Inicie o bot:
npm start
-
Escaneie o código QR que aparecerá no console usando o WhatsApp no seu celular.
Edite o arquivo bots.json conforme instruções abaixo:
[
{
"enabled": true, // Habilitar ou não essa entrada
"nome": "ravenabot", // Identificador do bot para os logs e EvoAPI
"numero": "559912345678", // Numero do celular do perfil do whatsapp, apenas números
"ignorePV": false, // Ignorar comandos no PV (menos de gerencia)
"ignoreInvites": false, // Não ativar sistema de invites
"customPrefix": "!", // Prefixo padrão dos comandos (os grupos são criados com este prefixo, mas podem alterar depois)
// Atualmente, eu migrei para a EvolutionAPI pois a ravena recebe mensagens demais que travam o Chrome do wweb.js
// Não recomendo configurar nele, é muito trabalho pra ter mais erros
"useEvo": false, // Uso avançado usando a EvolutionAPI. O nome do bot deve ser o mesmo no painel da evo
"webhookPort": 3457, // Apenas para EvolutionAPI, ignore 99% dos casos
"useWebsocket": true, // Apenas para EvolutionAPI, ignore 99% dos casos
// Também é possível ativar no discord (SUPER EM TESTES, NADA GARANTIDO)
"useDiscord": false,
"discordToken": "MTQzN...",
}
]Edite o arquivo .env conforme instruções abaixo:
# Opções Gerais
DEFAULT_PREFIX=! # Prefixo padrão de comandos
SAFE_MODE=false # Apenas simula envio de mensagens e printa no terminal
DEBUG=true # Mostra Mensagens de debug mais detalhadas
HEADLESS_MODE=false # false = mostra o navegador, true = navegador escondido
DL_FOLDER=D:/downloads # Pasta onde serão baixados mídias (youtube, etc)
NOTIFY_UNKNOWN_COMMANDS=false # Responder mensagens de "comando não encontrado"
SUPER_ADMINS=12345@c.us # Número de pessoas que podem dar comandos de SuperAdmin (padrão ID whats)
MAX_BACKUPS=10
CMD_WHITELIST=sa-,anoni # Comandos pra considerar mesmo que o bot esteja com "ignorar PV" habilitado
# API da RavenaBot
# Completamente opcional, ainda mais pra quem vai rodar o bot particular
# Eu uso cloudflare pra domínio externo ravena.moothz.win
BOT_DOMAIN=https://seuhost.com/rv # URL da API
BOT_DOMAIN_LOCAL=http://192.168.1.100 # URL LOCAL da API, pra uso com o Evolution e evitar problemas de HTTPS
API_PORT=5000 # Porta da API
BOTAPI_USER=admin # Usuário para comandos remotos
BOTAPI_PASSWORD=senhaCecreta # Senha para comandos Remotos
MANAGEMENT_TOKEN_DURATION=30 # Tempo em minutos de duração da sessão para !g-painel
# Chaves de API Externas
TWITCH_CLIENT_ID= # https://dev.twitch.tv/docs/api/
TWITCH_CLIENT_SECRET= #
KICK_CLIENT_ID= # https://docs.kick.com/getting-started/kick-apps-setup
KICK_CLIENT_SECRET= #
GOOGLE_API_KEY= # https://ai.google.dev/ + https://console.cloud.google.com/apis/credentials/key
GOOGLE_MAPS_API_KEY= # Habilite as APIs: Generative Language API, Map Static API, Places API, Places API (New), Street View Static API
DEEPSEEK_API_KEY= # https://platform.deepseek.com/apiKeys
OPENAI_API_KEY= # https://openai.com/api/
OPENROUTER_API_KEY= # https://openrouter.ai/docs/api-reference/api-keys/get-api-key
OPENWEATHER_API_KEY= # https://openweathermap.org/api
RIOT_GAMES= # https://developer.riotgames.com/
GIPHY_API_KEY= # https://developers.giphy.com/
OMDB_API_KEY= # https://www.omdbapi.com/apikey.aspx
UNSPLASH_API_KEY= # https://unsplash.com/developers
LASTFM_APIKEY= # https://www.last.fm/pt/api
LASTFM_SECRET= #
API_PLACAS_COMUM= # https://apiplacas.com.br/
API_PLACAS_PREMIUM= # https://apiplacas.com.br/
TIPA_TOKEN= # https://tipa.ai/settings/apps (WEBHOOKS)
#API_PLACAS_USAR_PREMIUM=TRUE # Caso tenha comprad uma chave premium
GRUPOS_PLACA_PREMIUM=grupo1,grupo2 # Nomes de grupos que podem usar a API placa premium
SOUNDCLOUD_CLIENT_ID= # Pegar do network no navegador
SOUNDCLOUD_OAUTH_TOKEN= # Pegar do network no navegador
# Gerenciamento de Serviços
# Agora os URLs de APIs (Whisper, ComfyUI, etc) são configurados no arquivo service-providers.json
# Você pode gerenciar eles pela interface web: https://sua-ravena.win/service-providers
API_TIMEOUT=30000 # Timeout padrão para chamadas de API
# Configuração das doações (provavelmente inútil pra ti que vai rodar o bot particular)
DONATION_LINK=https://tipa.ai/moothz
DONATION_GOAL_AMOUNT=1000
DONATION_GOAL_DESCRIPTION=Pagar o moothz!
# Grupos para Desenvolvimento e debug do bot
# Completamente opcional, ainda mais pra quem vai rodar o bot particular
LINK_GRUPO_INTERACAO=https://chat.whatsapp.com/abc123 # Para !grupao
LINK_GRUPO_AVISOS=https://chat.whatsapp.com/def456 # Para !avisos
GRUPO_LOGS=1234678901234567890@g.us # ID WhatsApp de grupos para debug e monitoramento
GRUPO_ESTABILIDADE=1234678901234567890 # 1. Adicione o bot nos grupos
GRUPO_INVITES=1234678901234567890@g.us # 2. Abra o arquivo data/groups.json
GRUPO_AVISOS=1234678901234567890@g.us # 3. Pegueo o ID de lá! (pra facilitar, use !g-setName)
GRUPO_INTERACAO=1234678901234567890@g.us #
# Grupos de captura de conteúdo
GRUPOS_HOROSCOPOS=
GRUPO_MUNEWS=
# Programas
# Vou deixar aqui os exemplos como seria em uma máquina Windows
WHISPER=C:/Apps/Faster-Whisper-XXL/faster-whisper-xxl.exe
#WHISPER_USE_GPU= # Defina pra rodar na GPU ao invés de CPU, caso suporte
FFMPEG_PATH=C:/Apps/ffmpeg.exe
CHROME_PATH=C:/Program Files/Google/Chrome/Application/chrome.exe
# EvolutionAPI - Apenas uso avançado, ignore
#USE_EVOLUTION= # Usar Evolution ao invés do whatsappweb-js
#EVOLUTION_API_URL= # http://localhost:1234
#EVOLUTION_API_KEY= # abcd12345*&¨%%
#EVOLUTION_BOT_TOKEN= # Não utilizado ainda
#EVO_WEBHOOK_HOST= # Prefiro usar websocket, mas se quiser
#EVO_WEBHOOK_PORT= # Configure webhook aqui
# Outros
# Nem todos emojis são suportados na EvoAPI para 'reagir' às mensagens
LOADING_EMOJI=🌀Para contribuir com o bot e adicionar um novo comando fixo, crie um arquivo .js na pasta src/functions/.
Alguns comandos que outros usuários criaram:
Aqui vai uma boa base pra começar:
const Logger = require('../utils/Logger');
const Command = require('../models/Command');
const ReturnMessage = require('../models/ReturnMessage');
const logger = new Logger('meus-comandos');
const commands = [
new Command({
name: 'exemplo',
description: 'Um comando de exemplo',
reactions: {
before: "🌀", // Emoji mostrado antes da execução
after: "✅" // Emoji mostrado após a execução
},
method: async (bot, message, args, group) => {
const chatId = message.group || message.author;
logger.debug(`Executando comando exemplo`);
// Obtém o primeiro argumento ou usa um valor padrão
const nome = args.length > 0 ? args[0] : "mundo";
// Envia a resposta
return new ReturnMessage({
chatId: chatId,
content: `Olá, ${nome}!`
});
}
})
];
// Exporta os comandos
module.exports = { commands };Se você sabe pedir pras LLMs programarem, aqui vai uma dica de como fazer:
Anexe os seguintes arquivos:
- models/Group.js
- models/Command.js
- models/ReturnMessage.js
- Este código de exemplo acima como exemplo.js
Se estiver fazendo alguma função similar a alguma existente no bot, anexo também o arquivo JS da pasta functions - por exemplo, se for fazer um comando que retorne Stickers, anexe o Stickers.js para a IA saber como tratar ReturnMessage de stickers, etc.
Peça para o LLM:
Respeitando os padrões de implementação apresentados nos modelos e no exemplo.js desenvolva um novo comando conforme instruções a seguir:
- Comando 'soletrar'
- Recebe como argumento várias palavras
- Para cada palavra recebida como argumento, separe as letras com hifen
Exemplo:
- Entrada: !soletrar batata porco
- Saída: B-A-T-A-T-A | P-O-R-C-O
Free, usem como quiserem.