OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Hosting

DigitalOcean

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

A DigitalOcean é uma opção simples de VPS pago. Para opções mais baratas ou gratuitas:

  • Hetzner -- mais núcleos/RAM por dólar.
  • Oracle Cloud -- nível ARM Always Free (até 4 OCPUs e 24 GB de RAM), mas o cadastro pode ser trabalhoso e está disponível apenas para 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. Acesse a DigitalOcean.
    2. Clique em Create > Droplets.
    3. Escolha:
      • Region: a mais próxima de você
      • Image: Ubuntu 24.04 LTS
      • Size: Basic, Regular, 1 vCPU / 1 GB RAM / 25 GB SSD
      • Authentication: chave SSH (recomendado) ou senha
    4. Clique em Create Droplet e anote o endereço IP.

  • Conectar e instalar

    bash
    ssh root@YOUR_DROPLET_IP apt update && apt upgrade -y # Instalar o Node.js 24curl -fsSL https://deb.nodesource.com/setup_24.x | bash -apt install -y nodejs # Instalar o OpenClawcurl -fsSL https://openclaw.ai/install.sh | bash # Criar o usuário não root que será proprietário do estado e dos serviços do OpenClaw.adduser openclawusermod -aG sudo openclawloginctl enable-linger openclaw su - openclawopenclaw --version

    Use o shell de root apenas para a configuração inicial do sistema. Execute os comandos do OpenClaw como o usuário não root openclaw, para que o estado fique em /home/openclaw/.openclaw/ e o Gateway seja instalado como serviço --user do systemd desse usuário.

  • Executar a configuração inicial

    bash
    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 (serviço de usuário do systemd).

  • Adicionar swap (recomendado para Droplets de 1 GB)

    bash
    fallocate -l 2G /swapfilechmod 600 /swapfilemkswap /swapfileswapon /swapfileecho '/swapfile none swap sw 0 0' >> /etc/fstab

  • Verificar o Gateway

    bash
    openclaw statussystemctl --user status openclaw-gateway.servicejournalctl --user -u openclaw-gateway.service -f

  • Acessar a interface de controle

    Por padrão, o Gateway escuta no local loopback. Escolha uma destas opções.

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

    bash
    # Na sua máquina localssh -L 18789:localhost:18789 root@YOUR_DROPLET_IP

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

    Opção B: Tailscale Serve

    bash
    curl -fsSL https://tailscale.com/install.sh | sudo shsudo tailscale upopenclaw config set gateway.tailscale.mode serveopenclaw gateway restart

    Em seguida, abra https://<magicdns>/ em qualquer dispositivo da sua tailnet.

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

    Opção C: vinculação à tailnet (sem Serve)

    bash
    openclaw config set gateway.bind tailnetopenclaw 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, credenciais de canais/provedores, auth-profiles.json de cada agente e dados de sessão.
    • ~/.openclaw/workspace/ -- o espaço de trabalho do agente (SOUL.md, memória e artefatos).

    Esses dados persistem após reinicializações do Droplet. Para criar um snapshot portátil:

    bash
    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 o funcionamento estável:

    • Certifique-se de que a etapa de swap acima esteja registrada em /etc/fstab, para que persista após 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 ocorrerem erros de falta de memória em prompts grandes.
    • Monitore com free -h e htop.

    Solução de problemas

    O 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.

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

    Próximas etapas

    Relacionados

    Was this useful?
    On this page

    On this page