Como hospedar um bot de Discord
Do token ao bot online 24 horas, com discord.js (Node) ou discord.py (Python). O código abaixo é o mesmo que testamos na plataforma.
1. Crie o bot no Discord
- No Discord Developer Portal, crie uma aplicação e, na aba Bot, gere o token.
- Na mesma aba, ligue Message Content Intent se o bot precisa ler mensagens.
- Em OAuth2, gere o link de convite com o escopo
bote adicione o bot ao seu servidor.
2. O projeto com discord.js (Node)
package.json
{
"name": "meu-bot-discord",
"type": "module",
"scripts": {
"start": "node index.js"
},
"dependencies": {
"discord.js": "14.28.1"
},
"engines": {
"node": ">=20"
}
}
index.js
import { Client, Events, GatewayIntentBits } from 'discord.js'
const client = new Client({
intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages, GatewayIntentBits.MessageContent],
})
client.once(Events.ClientReady, (c) => console.log(`Online como ${c.user.tag}`))
client.on(Events.MessageCreate, async (msg) => {
if (msg.author.bot) return
if (msg.content === '!ping') await msg.reply('pong')
})
client.login(process.env.DISCORD_TOKEN)
lumahost.json
{
"tipo": "worker"
}
O lumahost.json diz que é um worker: bot não recebe visita, então não tem endereço nem porta. É isso que evita o erro de "porta não encontrada".
Ou com discord.py (Python)
requirements.txt
discord.py==2.7.1
main.py
import os
import discord
intents = discord.Intents.default()
intents.message_content = True
client = discord.Client(intents=intents)
@client.event
async def on_ready():
print(f"Online como {client.user}", flush=True)
@client.event
async def on_message(message):
if message.author.bot:
return
if message.content == "!ping":
await message.reply("pong")
client.run(os.environ["DISCORD_TOKEN"])
lumahost.json
{
"tipo": "worker",
"start": "python main.py"
}
3. O token
Crie a variável DISCORD_TOKEN com o token do bot. Nunca coloque o token no código nem no repositório: quem tiver o token controla o bot.
Subir o bot
- No painel, Novo app, tipo Robô ou automação, 256 MB de RAM. Escolha o .zip da pasta (sem
node_modulesnem.venv) ou o repositório do GitHub. - Na aba Variáveis, crie as variáveis do passo anterior e reinicie o app.
- Na aba Logs, confira a mensagem de que o bot está no ar.
Pelo Claude Code ou pelo Cursor, com o MCP da LumaHost, basta pedir:
Sobe essa pasta na LumaHost como worker, nome meu-bot-discord, e cria a variável DISCORD_TOKEN com o valor que eu vou te passar.Se der errado
TokenInvalidouLoginFailure: Improper token: o token está errado ou foi regenerado. Atualize a variável e reinicie.Used disallowed intents: o intent pedido no código não está ligado no Developer Portal.- O app aparece como "reiniciando em ciclo": o processo está terminando. Veja o motivo na aba Logs.
Perguntas frequentes
Quanto de RAM um bot de Discord precisa?
Um bot pequeno roda com 256 MB. Bot em centenas de servidores, com música ou com cache grande, pede 512 MB ou mais: acompanhe o gráfico de RAM na aba Métricas.
O bot fica online quando eu desligo o computador?
Fica. Ele roda no servidor da LumaHost como worker, 24 horas, e volta sozinho se o processo cair.
Por que o bot não lê as mensagens?
Falta o intent de conteúdo de mensagem. Ligue Message Content Intent no Developer Portal do Discord (aba Bot) e peça o intent no código, como no exemplo.
Onde registro os comandos de barra (slash commands)?
O script que registra os comandos roda uma vez e termina: use Executar uma vez no painel, não um app separado.