Deploy OpenClaw no Railway em 5 Minutos — O Jeito Mais Fácil
Railway é a forma mais simples de colocar seu OpenClaw online. Deploy com um clique, $5/mês, sem configurar servidor. Tutorial completo para quem quer praticidade.
Se você quer seu OpenClaw rodando 24/7 sem configurar servidor, Railway é a opção mais prática. Em 5 minutos e por apenas $5/mês, você tem deploy automático, banco de dados incluído e zero manutenção.
⏱️ Tempo: 5-10 minutos · 🎯 Nível: Iniciante · 💰 Custo: $5/mês (trial grátis de 30 dias)
Quer grátis para sempre? Veja nosso tutorial Oracle Cloud — é permanentemente gratuito, mas leva 30 minutos para configurar.
| Aspecto | Railway | Oracle Cloud | VPS Tradicional |
|---|---|---|---|
| Setup | 5 minutos | 30 minutos | 45+ minutos |
| Custo | $5/mês | $0 | $5-10/mês |
| Manutenção | Zero | Média | Alta |
| Deploy | Git push | Manual | Manual |
| Banco de dados | Incluído | Configurar | Configurar |
| SSL | Automático | Configurar | Configurar |
Railway é para você se:
- Valoriza tempo mais que dinheiro
- Quer zero configuração de servidor
- Precisa de deploy automático a cada commit
- Não quer se preocupar com atualizações de sistema
Railway cobra por uso (CPU, RAM, storage):
- Trial: 30 dias grátis com $5 de créditos
- Hobby: $5/mês (créditos inclusos — se usar pouco, não paga extra)
- Estimativa OpenClaw: ~$3-5/mês para uso leve
Para referência, o OpenClaw idle usa:
- ~100MB RAM
- ~0.1 vCPU
- ~200MB storage
Isso fica bem abaixo do limite do plano Hobby.
- Acesse railway.app
- Clique em Start a New Project
- Faça login com GitHub (recomendado) ou email
- Autorize o Railway a acessar seus repositórios
Você tem duas opções:
- No dashboard, clique em New Project
- Selecione Deploy a Template
- Busque por “Node.js” ou “Empty Project”
- Clique em Deploy
Se você já tem um fork do OpenClaw:
- Clique em New Project
- Selecione Deploy from GitHub repo
- Escolha seu repositório do OpenClaw
- Railway detecta automaticamente que é Node.js
O OpenClaw precisa de algumas configurações. No painel do Railway:
- Clique no serviço criado
- Vá em Variables
- Adicione as seguintes variáveis:
# Obrigatório: API Key da Anthropic ou OpenAI
ANTHROPIC_API_KEY=sk-ant-api03-xxxxx
# Ou, se preferir OpenAI:
# OPENAI_API_KEY=sk-xxxxx
# Configurações do Gateway
GATEWAY_PORT=3434
NODE_ENV=production
# Timezone (opcional)
TZ=America/Sao_Paulo
Anthropic (Claude):
- Acesse console.anthropic.com
- Crie uma conta e adicione créditos
- Gere uma API key em API Keys
OpenAI (GPT-4):
- Acesse platform.openai.com
- Crie uma conta e adicione créditos
- Gere uma API key em API Keys
O OpenClaw precisa de storage persistente para memória e configurações:
- No projeto, clique em + New
- Selecione Volume
- Configure:
- Name:
openclaw-data - Mount Path:
/app/data
- Name:
- Clique em Create Volume
Agora adicione mais uma variável de ambiente:
OPENCLAW_DATA_DIR=/app/data
Railway fornece um domínio gratuito:
- Vá em Settings do serviço
- Na seção Networking, clique em Generate Domain
- Você receberá algo como:
seu-projeto.up.railway.app
Para domínio personalizado (opcional):
- Na mesma seção, clique em Custom Domain
- Adicione seu domínio (ex:
openclaw.seusite.com) - Configure o CNAME no seu DNS apontando para o Railway
Se você conectou um repositório Git:
git push origin main
Railway automaticamente:
- Detecta o push
- Builda a aplicação
- Faz o deploy
- Reinicia com as novas mudanças
Você pode acompanhar em tempo real nos logs do Railway.
Acesse seu domínio Railway no navegador:
https://seu-projeto.up.railway.app
Se tudo estiver certo, você verá a mensagem do Gateway OpenClaw.
Para conectar o WhatsApp ao seu OpenClaw no Railway:
- Acesse os logs do serviço no Railway
- Procure pelo QR code no terminal
- Escaneie com seu celular
Alternativa: Use o Railway CLI:
# Instalar Railway CLI
npm install -g @railway/cli
# Login
railway login
# Ver logs em tempo real
railway logs
Railway oferece monitoramento integrado:
- CPU/RAM em tempo real
- Uso de disco
- Requests por segundo
- 7 dias de histórico (Hobby)
- Filtros e busca
- Streaming em tempo real
Configure alertas para:
- Uso de CPU alto
- Memória baixa
- Erros de aplicação
Para manter os custos baixos no Railway:
- Desative quando não usar: Railway cobra por segundo — se você não usar por horas, pause o serviço
- Limite recursos: Configure limites de CPU/RAM nas settings
- Monitore uso: Acompanhe o dashboard de billing semanalmente
- Região próxima: Escolha
us-eastou a região mais próxima do Brasil - Health checks: Configure endpoints de health para reinício automático
- Replicas: Para alta disponibilidade, considere múltiplas replicas (Pro plan)
Railway se integra nativamente com GitHub:
# railway.toml (opcional, na raiz do projeto)
[build]
builder = "nixpacks"
[deploy]
startCommand = "npm start"
healthcheckPath = "/health"
healthcheckTimeout = 100
restartPolicyType = "on_failure"
restartPolicyMaxRetries = 3
Isso permite configurar builds personalizados e políticas de restart.
Verifique se o package.json tem o script start:
{
"scripts": {
"start": "openclaw gateway start"
}
}
O OpenClaw pode precisar de mais RAM. No Railway:
- Vá em Settings
- Em Resources, aumente o limite de RAM
Certifique-se que a variável NODE_ENV=production está configurada e que você está vendo os logs em tempo real.
| Quando usar | Railway | Oracle Cloud | DigitalOcean |
|---|---|---|---|
| Setup rápido | ✅ Melhor | ⚠️ Complexo | ⚠️ Médio |
| Custo zero | ⚠️ $5/mês | ✅ Grátis | ❌ $5+/mês |
| Zero manutenção | ✅ Melhor | ❌ Você gerencia | ❌ Você gerencia |
| Controle total | ⚠️ Limitado | ✅ Total | ✅ Total |
Nossa recomendação:
- Iniciantes: Railway (simplicidade)
- Orçamento zero: Oracle Cloud (grátis permanente)
- Produção séria: VPS dedicado (controle)
Railway é a opção mais rápida para colocar seu OpenClaw online. Em 5 minutos você tem:
- ✅ Deploy automático
- ✅ SSL gratuito
- ✅ Domínio incluso
- ✅ Logs e métricas
- ✅ Zero manutenção
Tudo por $5/mês — menos que um café na Starbucks.
Dúvidas? Comunidade Discord responde em minutos!