Quais sao os requisitos minimos de servidor para o OpenClaw?

Voce precisa de pelo menos 2 vCPU, 4 GB de RAM e 20 GB de armazenamento SSD. Ubuntu 22.04+, Debian 12+ ou qualquer distribuicao Linux com suporte Docker funciona. macOS e Windows (via WSL2) sao bons para desenvolvimento local, mas nao recomendados para producao.

Qual metodo de instalacao e melhor para iniciantes?

O instalador one-liner (curl -fsSL https://openclaw.sh | bash) e a opcao mais rapida e simples. Deteta automaticamente o seu SO, instala dependencias e guia-o pela configuracao. O processo completo leva cerca de 5 minutos num VPS novo.

Posso executar o OpenClaw com Docker?

Sim. O OpenClaw publica uma imagem Docker oficial. Use o template docker-compose.yml do Metodo 3 acima. O Docker e ideal para ambientes isolados, rollbacks faceis e implantacoes consistentes. Monte sempre o diretorio data/ como volume para nao perder a memoria e o historico de conversas.

Preciso de um nome de dominio para executar o OpenClaw?

Nao. O OpenClaw e executado por defeito no endereco IP do seu servidor. No entanto, um nome de dominio e recomendado se quiser certificados SSL via Let's Encrypt e URLs de webhook mais limpas para canais de mensagens como WhatsApp e Telegram.

Como atualizo o OpenClaw apos a instalacao?

Para instalacoes one-liner e npm, execute openclaw update. Para Docker, execute docker compose pull && docker compose up -d. Para instalacoes a partir do codigo-fonte, execute git pull && pnpm install && pnpm build. Faca sempre backup do seu ficheiro .env e do diretorio data/ antes de atualizar.

Como Instalar o OpenClaw em 2026, Passo a Passo | VPS, Docker, Mac

Prefere que os especialistas cuidem disso?

Esqueca o terminal. A nossa equipa instala, protege e configura o OpenClaw para si. Planos a partir de $169.

Ver Planos

Pre-requisitos

Antes de instalar o OpenClaw, certifique-se de que o seu servidor atende a estes requisitos minimos. Rodar abaixo dessas especificacoes leva a respostas lentas, processos travados e utilizadores frustrados.

CPU

Minimo 2 vCPU. Recomendado 4 vCPU para configuracoes multicanal.

RAM

4 GB minimo. 8 GB recomendado se for executar LLMs locais via Ollama.

Armazenamento

Minimo 20 GB SSD. Bases de dados de memoria e logs crescem ao longo do tempo. Planeie 50 GB a longo prazo.

Ubuntu 22.04+, Debian 12+ ou qualquer Linux com suporte Docker. macOS e Windows (WSL2) tambem funcionam.

Voce tambem precisara

Acesso SSH ao seu servidor. Se conseguir rodar ssh root@your-server-ip, esta tudo bem.
Uma chave de API de modelo de IA da Anthropic, OpenAI, Google ou um modelo local via Ollama. Obtenha uma antes de comecar.
Um nome de dominio (opcional). Nao e obrigatorio, mas recomendado para SSL e URLs de webhook limpos.

Precisa de um VPS? Recomendamos a Hetzner (CX22 por ~$4,50/mes) ou a DigitalOcean (Basic Droplet por $6/mes). Ambos excedem os requisitos minimos.

1.One-Liner (Recomendado)

A forma mais rapida de instalar o OpenClaw. Um comando trata de tudo: verificacoes de dependencias, downloads, assistente de configuracao e configuracao do servico. Funciona em Ubuntu, Debian, CentOS, Fedora, Arch e macOS.

curl -fsSL https://openclaw.sh | bash

O que o instalador faz

Deteta o seu sistema operativo e gestor de pacotes

Instala o Node.js 20 LTS se nao estiver presente

Instala o pnpm globalmente para resolucao de dependencias mais rapida

Baixa a versao estavel mais recente do OpenClaw

Executa o assistente de configuracao interativo

Cria um servico systemd (Linux) ou um agente launchd (macOS)

Inicia o OpenClaw e confirma que esta a ser executado

Saida esperada

[info] Detecting OS... Ubuntu 22.04 (x86_64)
[info] Node.js v20.18.1 found
[info] Installing pnpm...
[info] Downloading OpenClaw v2026.3.8...
[info] Running configuration wizard...
   → AI Provider: anthropic
   → Model: claude-sonnet-4-5
   → Port: 3100
[ok]   OpenClaw is running at http://localhost:3100
       Dashboard: http://localhost:3100/dashboard

O instalador nunca e executado com privilegios elevados alem do estritamente necessario. Reveja o codigo-fonte do script antes de o executar. Recomendamos isso para todos os scripts executados via pipe.

Flags personalizadas

Passe flags para personalizar a instalacao sem o assistente interativo.

# Skip the wizard with pre-set values
curl -fsSL https://openclaw.sh | bash -s -- \
  --provider anthropic \
  --model claude-sonnet-4-5 \
  --port 3100 \
  --no-systemd

2.npm / pnpm

Ideal para desenvolvedores que querem controle total sobre o processo. Este metodo da-lhe visibilidade explicita sobre cada passo.

Passo 1 — Instale o Node.js 20+

O OpenClaw requer Node.js 20 ou posterior. Verifique primeiro a sua versao.

node --version
# If below v20, install via nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20

Passo 2 — Instale o pnpm

npm install -g pnpm

Passo 3 — Instale o OpenClaw globalmente

pnpm install -g openclaw
# Or with npm:
npm install -g openclaw

Passo 4 — Inicialize a configuracao

O comando init cria um ficheiro .env e um diretorio data/ na sua pasta atual.

mkdir ~/openclaw && cd ~/openclaw
openclaw init

Passo 5 — Edite o seu ficheiro .env

.envenv

# ~/openclaw/.env
OPENCLAW_PORT=3100
AI_PROVIDER=anthropic
AI_MODEL=claude-sonnet-4-5
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx
# Or for OpenAI:
# AI_PROVIDER=openai
# AI_MODEL=gpt-5
# OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx

Passo 6 — Inicie o OpenClaw

openclaw start
# Or run in background:
openclaw start --daemon

Use openclaw logs para ver a saida em tempo real. Adicione --follow para transmitir novas entradas.

3.Docker

O Docker isola o OpenClaw do seu sistema hospedeiro. Atualizacoes sao simples: baixe a nova imagem e reinicie. Este metodo e ideal para servidores de producao e equipas.

Passo 1 — Instale o Docker

# Ubuntu / Debian
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# Log out and back in for group changes to take effect

Passo 2 — Crie o docker-compose.yml

docker-compose.ymlyaml

version: "3.8"

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "3100:3100"
    volumes:
      - ./data:/app/data        # Persistent memory & databases
      - ./config:/app/config    # Configuration files
      - ./.env:/app/.env        # Environment variables
    environment:
      - NODE_ENV=production
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3100/health"]
      interval: 30s
      timeout: 10s
      retries: 3

Passo 3 — Crie o seu ficheiro .env

.envenv

OPENCLAW_PORT=3100
AI_PROVIDER=anthropic
AI_MODEL=claude-sonnet-4-5
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx

# Optional: Enable persistent memory
MEMORY_ENABLED=true
MEMORY_PROVIDER=sqlite

# Optional: WhatsApp channel
WHATSAPP_ENABLED=false
WHATSAPP_PHONE_ID=
WHATSAPP_TOKEN=

Passo 4 — Inicie o contentor

docker compose up -d

# Check the logs
docker compose logs -f openclaw

Atualizar com Docker

docker compose pull
docker compose up -d

Monte sempre o diretorio data/ com bind-mount. Sem um volume, voce perde toda a memoria e historico de conversas quando o contentor reinicia.

4.A partir do codigo-fonte

Compile a partir do codigo-fonte quando quiser modificar o comportamento central, contribuir para o projeto ou executar uma branch pre-release. Este caminho requer experiencia de desenvolvedor.

Passo 1 — Clone o repositorio

git clone https://github.com/openclaw/openclaw.git
cd openclaw

Passo 2 — Instale as dependencias

# Requires Node.js 20+ and pnpm
pnpm install

Passo 3 — Copie e edite o ficheiro de ambiente

cp .env.example .env
nano .env
# Set your AI_PROVIDER, API keys, and port

Passo 4 — Compile e inicie

pnpm build
pnpm start

# For development with hot reload:
pnpm dev

Atualizar a partir do codigo-fonte

git pull origin main
pnpm install
pnpm build
# Restart your OpenClaw process or service

Compilar a partir do codigo-fonte compila TypeScript para JavaScript. O passo de build leva de 30 a 90 segundos dependendo do seu hardware. Builds subsequentes sao mais rapidos gracas ao cache.

Pos-Instalacao

O OpenClaw esta a ser executado. Agora configure o seu modelo de IA, conecte um canal de mensagens e verifique se tudo funciona.

Configure o Seu Modelo de IA

O OpenClaw suporta varios fornecedores de IA. Defina o seu modelo preferido no ficheiro .env ou atraves do painel.

Fornecedor	Modelos	Custo / msg
Anthropic	Claude Opus 4.6, Sonnet 4.5, Haiku 4.5	$0.001 – $0.05
OpenAI	GPT-5, GPT-5 mini	$0.002 – $0.03
Google	Gemini 3 Pro, Gemini 3 Flash	$0.001 – $0.02
DeepSeek	DeepSeek V3	~$0.005
Mistral	Mistral Large	~$0.01
Ollama (local)	Llama 4, Qwen 3, Mistral, and any GGUF model	Free

.envenv

# Example: Switch to Claude Opus 4.6
AI_PROVIDER=anthropic
AI_MODEL=claude-opus-4-6
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx

# Example: Use a local model via Ollama
AI_PROVIDER=ollama
AI_MODEL=llama4:8b
OLLAMA_HOST=http://localhost:11434

Comece com um modelo mais barato como Haiku 4.5 ou Gemini 3 Flash enquanto testa. Mude para um modelo mais potente assim que os seus canais e memoria estiverem configurados.

Configure o Seu Primeiro Canal (Exemplo WhatsApp)

O OpenClaw suporta 191+ integracoes. O WhatsApp e o ponto de partida mais popular. Aqui esta como o conectar.

Crie uma App Meta Business

Va a developers.facebook.com. Crie uma nova app Business. Ative o produto WhatsApp.

Obtenha o seu Phone Number ID e token

Nas configuracoes da API do WhatsApp, copie o seu Phone Number ID e gere um token de acesso permanente.

Adicione as credenciais ao .env

.envenv

WHATSAPP_ENABLED=true
WHATSAPP_PHONE_ID=123456789012345
WHATSAPP_TOKEN=EAAxxxxxxxxxxxxxxxx
WHATSAPP_VERIFY_TOKEN=your-random-verify-string

Defina a URL do webhook

No painel da Meta, defina a URL do seu webhook para https://your-domain.com/api/webhook/whatsapp e use o verify token do passo 3.

Reinicie o OpenClaw e envie uma mensagem de teste

openclaw restart
# Or with Docker:
docker compose restart openclaw

Envie a Sua Primeira Mensagem

Abra o WhatsApp e envie "Ola" para o numero conectado. Devera receber uma resposta em 2 a 5 segundos. Se nao tem o WhatsApp configurado, teste atraves do painel.

# Quick test via CLI
curl -X POST http://localhost:3100/api/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello, what can you do?"}'

Uma resposta bem-sucedida retorna JSON com a resposta da IA. Se obtiver um erro, consulte a secao de resolucao de problemas abaixo.

Erros Comuns e Solucoes

A maioria dos problemas de instalacao enquadra-se em cinco categorias. Aqui esta como corrigir cada um deles.

Error: Porta 3100 ja em uso

Outro processo ocupa a porta padrao do OpenClaw.

# Find what is using port 3100
sudo lsof -i :3100

# Option A: Kill the process
sudo kill -9 <PID>

# Option B: Change OpenClaw's port
# In .env, set:
OPENCLAW_PORT=3200

Error: Versao do Node incompativel

O OpenClaw requer Node.js 20 ou posterior. Versoes mais antigas causam erros de sintaxe no arranque.

# Check your current version
node --version

# If below v20, upgrade with nvm:
nvm install 20
nvm alias default 20
nvm use 20

# Verify
node --version  # Should show v20.x.x or higher

Error: Permissao do Docker negada

Voce ve "permission denied while trying to connect to the Docker daemon socket".

# Add your user to the docker group
sudo usermod -aG docker $USER

# Log out and back in, then verify:
docker ps
# If you still get errors, restart the Docker service:
sudo systemctl restart docker

Error: Problemas de certificado SSL

Fornecedores de webhook como a Meta rejeitam endpoints HTTP. Voce precisa de HTTPS.

# Install Certbot and get a free Let's Encrypt certificate
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d your-domain.com

# Auto-renewal is configured automatically
# Test renewal:
sudo certbot renew --dry-run

Se estiver por tras do Cloudflare, defina o modo SSL para "Full (Strict)" e use os certificados de origem do Cloudflare em vez do Let's Encrypt.

Error: Sem memoria / processo terminado

O OOM killer do Linux termina o OpenClaw quando o servidor fica sem RAM.

# Check available memory
free -h

# Option A: Add swap space (quick fix)
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

# Option B: Upgrade your VPS to 4+ GB RAM

# Option C: Use a lighter AI model
# In .env, switch from Opus to Haiku:
AI_MODEL=claude-haiku-4-5

O proprio modelo de IA e executado remotamente via API. Problemas de memoria vem da base de dados de memoria do OpenClaw e do processo Node.js, nao do modelo. 4 GB de RAM e o minimo pratico.

Seguranca Pos-Instalacao

Uma instancia OpenClaw em execucao sem seguranca e um risco. Pesquisas mostram que 93,4% das instancias publicas nao tem autenticacao basica, e 42.665 estao expostas na internet aberta. Nao se torne uma estatistica.

Checklist de seguranca (versao rapida)

Ative a autenticacao em .env: defina AUTH_ENABLED=true e AUTH_SECRET como uma string aleatoria de 32 caracteres
Configure o firewall UFW: permita apenas as portas 22 (SSH), 80 (HTTP) e 443 (HTTPS)
Configure SSL/TLS com Let's Encrypt ou certificados de origem do Cloudflare
Desative o painel em producao ou proteja-o por tras de autenticacao
Mantenha o OpenClaw atualizado: execute openclaw update ou docker compose pull semanalmente
Use um reverse proxy (Nginx ou Caddy) a frente do OpenClaw
Nunca exponha a porta 3100 diretamente a internet

# Quick firewall setup (Ubuntu/Debian)
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp    # SSH
sudo ufw allow 80/tcp    # HTTP
sudo ufw allow 443/tcp   # HTTPS
sudo ufw enable

# Verify
sudo ufw status

Esta e a versao abreviada. Para a auditoria de seguranca completa de 12 pontos que aplicamos a cada instalacao de cliente, leia o nosso Guia de Seguranca & Checklist de Seguranca.

FAQ

Precisa de uma ajuda?

A nossa equipa instala, protege e configura o OpenClaw no seu servidor. Memoria persistente, configuracao multicanal e auditoria de seguranca de 12 pontos incluidos.

Ver Planos Fazer uma Pergunta