--- title: "Como Instalar o OpenClaw em Qualquer VPS — Guia Universal" url: "https://openclaw.ia.br/blog/instalar-openclaw-qualquer-vps/" markdown_url: "https://openclaw.ia.br/blog/instalar-openclaw-qualquer-vps.MD" description: "Guia genérico para instalar OpenClaw em qualquer VPS Linux. Funciona com Hostinger, Contabo, Vultr, Linode, Hetzner e outros." date: "2026-01-31" author: "" --- # Como Instalar o OpenClaw em Qualquer VPS — Guia Universal Guia genérico para instalar OpenClaw em qualquer VPS Linux. Funciona com Hostinger, Contabo, Vultr, Linode, Hetzner e outros. Este guia funciona com **qualquer VPS Linux**. Não importa se é Hostinger, Contabo, Vultr, Linode, Hetzner, ou até um servidor caseiro — os passos são os mesmos. ## Requisitos Mínimos | Recurso | Mínimo | Recomendado | |---------|--------|-------------| | CPU | 1 vCPU | 2 vCPU | | RAM | 1GB | 2GB | | Disco | 10GB | 20GB | | Sistema | Ubuntu 22.04+ | Ubuntu 24.04 | **Outros sistemas suportados:** Debian 11+, Fedora, Arch. Este guia usa Ubuntu. ## VPS Populares (Preços) | Provedor | Preço | RAM | Região Brasil | |----------|-------|-----|---------------| | Hostinger | R$17/mês | 1GB | Sim | | Contabo | €5/mês | 4GB | Não | | Vultr | $6/mês | 1GB | Não | | Linode | $5/mês | 1GB | Não | | Hetzner | €4/mês | 2GB | Não | ## Passo 1: Conectar ao Servidor Você deve ter recebido: - IP do servidor - Usuário (geralmente `root`) - Senha ou chave SSH ```bash ssh root@SEU_IP # Ou com chave ssh -i ~/.ssh/sua-chave root@SEU_IP ``` Se pedir confirmação de fingerprint, digite `yes`. ## Passo 2: Atualizar Sistema ```bash apt update && apt upgrade -y ``` Isso pode demorar alguns minutos. ## Passo 3: Criar Usuário Dedicado Nunca rode aplicações como root: ```bash # Criar usuário adduser openclaw # Responda às perguntas (senha, nome, etc) # Ou use --disabled-password para login apenas por SSH # Dar permissão de sudo usermod -aG sudo openclaw # Configurar SSH para o novo usuário mkdir -p /home/openclaw/.ssh cp ~/.ssh/authorized_keys /home/openclaw/.ssh/ 2>/dev/null || true chown -R openclaw:openclaw /home/openclaw/.ssh chmod 700 /home/openclaw/.ssh chmod 600 /home/openclaw/.ssh/authorized_keys 2>/dev/null || true ``` ## Passo 4: Configurar Firewall ```bash # Instalar ufw se não tiver apt install ufw -y # Permitir SSH ufw allow OpenSSH # Ativar firewall ufw enable # Verificar ufw status ``` ## Passo 5: Instalar Node.js ```bash # Mudar para usuário openclaw su - openclaw # Instalar Node.js 22 curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs # Verificar versão node --version # Deve ser v22.x npm --version ``` ## Passo 6: Instalar OpenClaw ```bash # Ainda como usuário openclaw npm install -g openclaw@latest # Se der erro de permissão, configure npm mkdir -p ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc source ~/.bashrc # Tentar novamente npm install -g openclaw@latest ``` ## Passo 7: Configurar OpenClaw ```bash openclaw onboard ``` O wizard pergunta: 1. **API Key**: Cole sua chave da Anthropic ou OpenAI 2. **Modelo**: Escolha (Sonnet é bom equilíbrio) 3. **Canal**: Telegram é mais fácil para servidor 4. **Workspace**: Aceite o padrão ~/clawd ## Passo 8: Configurar Telegram Crie um bot no Telegram: 1. Abra [@BotFather](https://t.me/BotFather) 2. Envie `/newbot` 3. Siga as instruções e copie o token Edite a configuração: ```bash nano ~/clawd/config.yaml ``` ```yaml channels: telegram: token: "123456789:ABCdef..." allowList: - "seu_telegram_id" ``` Para descobrir seu ID, use [@userinfobot](https://t.me/userinfobot). ## Passo 9: Criar Serviço Systemd Para rodar 24/7 automaticamente: ```bash sudo nano /etc/systemd/system/openclaw.service ``` Cole (ajuste os caminhos se necessário): ```ini [Unit] Description=OpenClaw AI Assistant After=network.target [Service] Type=simple User=openclaw WorkingDirectory=/home/openclaw/clawd ExecStart=/home/openclaw/.npm-global/bin/openclaw gateway start --foreground Restart=always RestartSec=10 Environment=PATH=/home/openclaw/.npm-global/bin:/usr/bin:/bin StandardOutput=journal StandardError=journal [Install] WantedBy=multi-user.target ``` Ativar: ```bash sudo systemctl daemon-reload sudo systemctl enable openclaw sudo systemctl start openclaw ``` ## Passo 10: Verificar ```bash # Status sudo systemctl status openclaw # Logs em tempo real sudo journalctl -u openclaw -f ``` Envie uma mensagem para seu bot no Telegram. Se responder, sucesso! ## Configurações Extras ### Adicionar Swap (se RAM < 2GB) ```bash sudo fallocate -l 2G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab ``` ### Segurança Extra ```bash # Instalar fail2ban sudo apt install fail2ban -y sudo systemctl enable fail2ban # Desabilitar login root por SSH sudo nano /etc/ssh/sshd_config # Mude: PermitRootLogin no sudo systemctl restart sshd ``` ### Atualizações Automáticas ```bash sudo apt install unattended-upgrades sudo dpkg-reconfigure -plow unattended-upgrades ``` ## Comandos do Dia a Dia ```bash # Ver status sudo systemctl status openclaw # Parar sudo systemctl stop openclaw # Reiniciar sudo systemctl restart openclaw # Ver logs sudo journalctl -u openclaw -f # Ver últimas 50 linhas de log sudo journalctl -u openclaw -n 50 # Atualizar OpenClaw sudo systemctl stop openclaw su - openclaw -c "npm update -g openclaw" sudo systemctl start openclaw ``` ## Troubleshooting ### "openclaw: command not found" O PATH não está configurado. Solução: ```bash # Como usuário openclaw echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc source ~/.bashrc # No systemd, use o caminho completo which openclaw # Para descobrir o caminho ``` ### Serviço não inicia ```bash # Ver erro detalhado sudo journalctl -u openclaw -n 50 --no-pager # Testar manualmente sudo su - openclaw openclaw gateway start ``` ### Memória insuficiente ```bash # Verificar uso free -h # Adicionar swap (veja acima) # Ou upgrade o plano da VPS ``` ### Bot não responde 1. Verifique se o serviço está rodando: `sudo systemctl status openclaw` 2. Verifique os logs: `sudo journalctl -u openclaw -f` 3. Confirme o token do Telegram 4. Confirme que seu ID está na allowList ## Backup ### Manual ```bash # Criar backup tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz ~/clawd/ # Restaurar tar -xzf openclaw-backup-*.tar.gz -C ~ ``` ### Automático (cron) ```bash crontab -e # Adicionar: 0 3 * * * tar -czf /home/openclaw/backups/clawd-$(date +\%Y\%m\%d).tar.gz /home/openclaw/clawd ``` --- **Esse guia funciona para qualquer VPS Linux.** Os comandos são padrão Ubuntu/Debian. Para outras distros, ajuste o gerenciador de pacotes (yum, dnf, pacman). **Guias específicos:** - [AWS Free Tier](/blog/instalar-openclaw-gratis-aws-free-tier/) - [Oracle Cloud (grátis sempre)](/blog/instalar-openclaw-gratis-oracle-cloud/) - [Google Cloud](/blog/instalar-openclaw-gratis-gcp/) - [DigitalOcean](/blog/instalar-openclaw-digitalocean/)