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.
📅 31 de January de 2026
⏱️ 4 min de leitura
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.
| 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.
| 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 |
Você deve ter recebido:
- IP do servidor
- Usuário (geralmente
root) - Senha ou chave SSH
ssh root@SEU_IP
# Ou com chave
ssh -i ~/.ssh/sua-chave root@SEU_IP
Se pedir confirmação de fingerprint, digite yes.
apt update && apt upgrade -y
Isso pode demorar alguns minutos.
Nunca rode aplicações como root:
# 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
# Instalar ufw se não tiver
apt install ufw -y
# Permitir SSH
ufw allow OpenSSH
# Ativar firewall
ufw enable
# Verificar
ufw status
# 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
# 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
openclaw onboard
O wizard pergunta:
- API Key: Cole sua chave da Anthropic ou OpenAI
- Modelo: Escolha (Sonnet é bom equilíbrio)
- Canal: Telegram é mais fácil para servidor
- Workspace: Aceite o padrão ~/clawd
Crie um bot no Telegram:
- Abra @BotFather
- Envie
/newbot - Siga as instruções e copie o token
Edite a configuração:
nano ~/clawd/config.yaml
channels:
telegram:
token: "123456789:ABCdef..."
allowList:
- "seu_telegram_id"
Para descobrir seu ID, use @userinfobot.
Para rodar 24/7 automaticamente:
sudo nano /etc/systemd/system/openclaw.service
Cole (ajuste os caminhos se necessário):
[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:
sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw
# 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!
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
# 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
sudo apt install unattended-upgrades
sudo dpkg-reconfigure -plow unattended-upgrades
# 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
O PATH não está configurado. Solução:
# 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
# Ver erro detalhado
sudo journalctl -u openclaw -n 50 --no-pager
# Testar manualmente
sudo su - openclaw
openclaw gateway start
# Verificar uso
free -h
# Adicionar swap (veja acima)
# Ou upgrade o plano da VPS
- Verifique se o serviço está rodando:
sudo systemctl status openclaw - Verifique os logs:
sudo journalctl -u openclaw -f - Confirme o token do Telegram
- Confirme que seu ID está na allowList
# Criar backup
tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz ~/clawd/
# Restaurar
tar -xzf openclaw-backup-*.tar.gz -C ~
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: