Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Execute um Gateway persistente do OpenClaw em um Droplet da DigitalOcean (~US$6/mês para o plano Basic de 1 GB). A DigitalOcean é o caminho mais simples de VPS paga. Se você preferir opções mais baratas ou gratuitas:
  • Hetzner — €3,79/mês, mais núcleos/RAM por dólar.
  • Oracle Cloud — ARM Sempre Gratuito (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

1

Create a Droplet

Use uma imagem base limpa (Ubuntu 24.04 LTS). Evite imagens de terceiros com instalação em 1 clique do Marketplace, a menos que você tenha revisado os scripts de inicialização e os padrões de firewall.
  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 de RAM / 25 GB SSD
    • Autenticação: Chave SSH (recomendado) ou senha
  4. Clique em Create Droplet e anote o endereço IP.
2

Connect and install

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

# Create the non-root user that will own OpenClaw state and services.
adduser openclaw
usermod -aG sudo openclaw
loginctl enable-linger openclaw

su - openclaw
openclaw --version
Use o shell root somente para o bootstrap do sistema. Execute 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 o serviço systemd desse usuário.
3

Run onboarding

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

Add swap (recommended for 1 GB Droplets)

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

Verify the gateway

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

Access the Control UI

O Gateway faz bind em 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 | sudo sh
sudo tailscale up
openclaw config set gateway.tailscale.mode serve
openclaw gateway restart
Em seguida, abra https://<magicdns>/ a partir de qualquer dispositivo na sua tailnet.O Tailscale Serve autentica o tráfego da UI 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 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: bind de 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 canal/provedor 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 do Droplet inteiro; 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:
  • Certifique-se de 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 de LLM local não cabe em 1 GB.
  • Defina agents.defaults.model.primary para um modelo menor se você encontrar OOMs em prompts grandes.
  • Monitore com free -h e htop.

​
Solução de problemas

O Gateway não inicia — Execute openclaw doctor --non-interactive e confira 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, pare-o. Sem memória — Verifique se o swap está ativo 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

​
Relacionado