--- title: "Deploy OpenClaw no Railway em 5 Minutos — O Jeito Mais Fácil" url: "https://openclaw.ia.br/blog/deploy-openclaw-railway-5-minutos/" markdown_url: "https://openclaw.ia.br/blog/deploy-openclaw-railway-5-minutos.MD" description: "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." date: "2026-02-02" author: "Equipe OpenClaw Brasil" --- # 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](/blog/instalar-openclaw-gratis-oracle-cloud/) — é permanentemente gratuito, mas leva 30 minutos para configurar. ## Por Que Railway? | 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** ## Quanto Custa de Verdade 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. ## Passo 1: Criar Conta no Railway 1. Acesse [railway.app](https://railway.app) 2. Clique em **Start a New Project** 3. Faça login com GitHub (recomendado) ou email 4. Autorize o Railway a acessar seus repositórios ## Passo 2: Criar Novo Projeto Você tem duas opções: ### Opção A: Deploy do Template (Mais Fácil) 1. No dashboard, clique em **New Project** 2. Selecione **Deploy a Template** 3. Busque por "Node.js" ou "Empty Project" 4. Clique em **Deploy** ### Opção B: Conectar Repositório Git Se você já tem um fork do OpenClaw: 1. Clique em **New Project** 2. Selecione **Deploy from GitHub repo** 3. Escolha seu repositório do OpenClaw 4. Railway detecta automaticamente que é Node.js ## Passo 3: Configurar Variáveis de Ambiente O OpenClaw precisa de algumas configurações. No painel do Railway: 1. Clique no serviço criado 2. Vá em **Variables** 3. Adicione as seguintes variáveis: ```env # 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 ``` ### Como Obter a API Key **Anthropic (Claude):** 1. Acesse [console.anthropic.com](https://console.anthropic.com) 2. Crie uma conta e adicione créditos 3. Gere uma API key em **API Keys** **OpenAI (GPT-4):** 1. Acesse [platform.openai.com](https://platform.openai.com) 2. Crie uma conta e adicione créditos 3. Gere uma API key em **API Keys** ## Passo 4: Adicionar Volume para Persistência O OpenClaw precisa de storage persistente para memória e configurações: 1. No projeto, clique em **+ New** 2. Selecione **Volume** 3. Configure: - **Name:** `openclaw-data` - **Mount Path:** `/app/data` 4. Clique em **Create Volume** Agora adicione mais uma variável de ambiente: ```env OPENCLAW_DATA_DIR=/app/data ``` ## Passo 5: Configurar Domínio Railway fornece um domínio gratuito: 1. Vá em **Settings** do serviço 2. Na seção **Networking**, clique em **Generate Domain** 3. Você receberá algo como: `seu-projeto.up.railway.app` Para domínio personalizado (opcional): 1. Na mesma seção, clique em **Custom Domain** 2. Adicione seu domínio (ex: `openclaw.seusite.com`) 3. Configure o CNAME no seu DNS apontando para o Railway ## Passo 6: Deploy! Se você conectou um repositório Git: ```bash git push origin main ``` Railway automaticamente: 1. Detecta o push 2. Builda a aplicação 3. Faz o deploy 4. Reinicia com as novas mudanças Você pode acompanhar em tempo real nos logs do Railway. ## Verificando se Funcionou Acesse seu domínio Railway no navegador: ``` https://seu-projeto.up.railway.app ``` Se tudo estiver certo, você verá a mensagem do Gateway OpenClaw. ## Conectando WhatsApp Para conectar o WhatsApp ao seu OpenClaw no Railway: 1. Acesse os logs do serviço no Railway 2. Procure pelo QR code no terminal 3. Escaneie com seu celular **Alternativa:** Use o Railway CLI: ```bash # Instalar Railway CLI npm install -g @railway/cli # Login railway login # Ver logs em tempo real railway logs ``` ## Monitoramento Railway oferece monitoramento integrado: ### Métricas - CPU/RAM em tempo real - Uso de disco - Requests por segundo ### Logs - 7 dias de histórico (Hobby) - Filtros e busca - Streaming em tempo real ### Alertas Configure alertas para: - Uso de CPU alto - Memória baixa - Erros de aplicação ## Dicas de Otimização ### Reduzir Custos Para manter os custos baixos no Railway: 1. **Desative quando não usar:** Railway cobra por segundo — se você não usar por horas, pause o serviço 2. **Limite recursos:** Configure limites de CPU/RAM nas settings 3. **Monitore uso:** Acompanhe o dashboard de billing semanalmente ### Melhorar Performance 1. **Região próxima:** Escolha `us-east` ou a região mais próxima do Brasil 2. **Health checks:** Configure endpoints de health para reinício automático 3. **Replicas:** Para alta disponibilidade, considere múltiplas replicas (Pro plan) ### Integração com CI/CD Railway se integra nativamente com GitHub: ```yaml # 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. ## Troubleshooting ### Erro: "Build failed" Verifique se o `package.json` tem o script `start`: ```json { "scripts": { "start": "openclaw gateway start" } } ``` ### Erro: "Out of memory" O OpenClaw pode precisar de mais RAM. No Railway: 1. Vá em **Settings** 2. Em **Resources**, aumente o limite de RAM ### QR Code não aparece nos logs Certifique-se que a variável `NODE_ENV=production` está configurada e que você está vendo os logs em tempo real. ## Railway vs Alternativas | 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) ## Conclusão 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. --- ## Próximos Passos - [ Guia pós-instalação](/blog/depois-instalar-openclaw-primeiros-passos/) - [ Conectar WhatsApp](/tutoriais/whatsapp/) - [ Seu primeiro bot](/tutoriais/primeiro-bot/) - [☁ Alternativa: Oracle Cloud grátis](/blog/instalar-openclaw-gratis-oracle-cloud/) --- *Dúvidas? [Comunidade Discord](https://discord.gg/clawd) responde em minutos!*