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

  1. No Discord Developer Portal, crie uma aplicação e, na aba Bot, gere o token.
  2. Na mesma aba, ligue Message Content Intent se o bot precisa ler mensagens.
  3. Em OAuth2, gere o link de convite com o escopo bot e 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

  1. No painel, Novo app, tipo Robô ou automação, 256 MB de RAM. Escolha o .zip da pasta (sem node_modules nem .venv) ou o repositório do GitHub.
  2. Na aba Variáveis, crie as variáveis do passo anterior e reinicie o app.
  3. 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

  • TokenInvalid ou LoginFailure: 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.

Veja também como hospedar um bot de WhatsApp ou um bot de Telegram, e os erros comuns.