English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Hosting

DigitalOcean

Execute um OpenClaw Gateway persistente em um Droplet da DigitalOcean (~US$ 6/mês pelo plano Basic de 1 GB).

A DigitalOcean é o caminho de VPS pago mais simples. Se você preferir opções mais baratas ou gratuitas:

  • Hetzner — €3,79/mês, mais núcleos/RAM por dólar.
  • Oracle Cloud — ARM Always Free (até 4 OCPU, 24 GB de RAM), mas o cadastro pode ser instável e é somente ARM.

Pré-requisitos

  • Conta da DigitalOcean (cadastro)
  • Par de chaves SSH (ou disposição para usar autenticação por senha)
  • Cerca de 20 minutos

Configuração

  • Criar um Droplet

    1. Entre na DigitalOcean.
    2. Clique em Create > Droplets.
    3. Escolha:
      • Região: A mais próxima de você
      • Imagem: Ubuntu 24.04 LTS
      • Tamanho: Basic, Regular, 1 vCPU / 1 GB RAM / 25 GB SSD
      • Autenticação: Chave SSH (recomendado) ou senha
    4. Clique em Create Droplet e anote o endereço IP.

  • Conectar e instalar

    ssh root@YOUR_DROPLET_IP

apt update && apt upgrade -y

# Install Node.js 24
curl -fsSL https://deb.nodesource.com/setup_24.x | bash -
apt install -y nodejs

# Install OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw --version

  • Executar o onboarding

    openclaw onboard --install-daemon

    O assistente orienta você pela autenticação do modelo, configuração de canais, geração do token do Gateway e instalação do daemon (systemd).

  • Adicionar swap (recomendado para Droplets de 1 GB)

    fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab

  • Verificar o Gateway

    openclaw status
systemctl --user status openclaw-gateway.service
journalctl --user -u openclaw-gateway.service -f

  • Acessar a Interface de Controle

    O Gateway se vincula ao loopback por padrão. Escolha uma destas opções.

    Opção A: túnel SSH (mais simples)

    # From your local machine
ssh -L 18789:localhost:18789 root@YOUR_DROPLET_IP

    Em seguida, abra http://localhost:18789.

    Opção B: Tailscale Serve

    curl -fsSL https://tailscale.com/install.sh | sh
tailscale up
openclaw config set gateway.tailscale.mode serve
openclaw gateway restart

    Em seguida, abra https://<magicdns>/ de qualquer dispositivo na sua tailnet.

    O Tailscale Serve autentica o tráfego da Interface de Controle e WebSocket por meio de cabeçalhos de identidade da tailnet, o que pressupõe que o próprio host do Gateway é confiável. Os endpoints da API HTTP seguem o modo normal de autenticação do Gateway (token/senha), independentemente disso. Para exigir credenciais explícitas de segredo compartilhado pelo Serve, defina gateway.auth.allowTailscale: false e use gateway.auth.mode: "token" ou "password".

    Opção C: vínculo com a tailnet (sem Serve)

    openclaw config set gateway.bind tailnet
openclaw gateway restart

    Em seguida, abra http://<tailscale-ip>:18789 (token obrigatório).

    • Persistência e backups

    O estado do OpenClaw fica em:

    • ~/.openclaw/ — openclaw.json, auth-profiles.json por agente, estado de canais/provedores e dados de sessão.
    • ~/.openclaw/workspace/ — o workspace do agente (SOUL.md, memória, artefatos).

    Eles sobrevivem a reinicializações do Droplet. Para criar um snapshot portátil:

    openclaw backup create

    Os snapshots da DigitalOcean fazem backup de todo o Droplet; openclaw backup create é portátil entre hosts.

    Dicas para 1 GB de RAM

    O Droplet de US$ 6 tem apenas 1 GB de RAM. Para manter tudo fluido:

    • Garanta que a etapa de swap acima esteja em /etc/fstab para que ela sobreviva a reinicializações.
    • Prefira modelos baseados em API (Claude, GPT) em vez de modelos locais — a inferência local de LLM não cabe em 1 GB.
    • Defina agents.defaults.model.primary como um modelo menor se você encontrar erros de OOM em prompts grandes.
    • Monitore com free -h e htop.

    Solução de problemas

    Gateway não inicia -- Execute openclaw doctor --non-interactive e verifique os logs com journalctl --user -u openclaw-gateway.service -n 50.

    Porta já em uso -- Execute lsof -i :18789 para encontrar o processo e, em seguida, interrompa-o.

    Sem memória -- Verifique se a swap está ativa com free -h. Se ainda houver OOM, use modelos baseados em API (Claude, GPT) em vez de modelos locais, ou faça upgrade para um Droplet de 2 GB.

    Próximos passos

    Relacionados