⚠️ Antes de instalar, lê obrigatoriamente a página de Segurança. O Open Claw requer configuração cuidadosa.

Antes de Começar

💻 Sistema Operativo

✅ macOS (Recomendado)
✅ Linux (Ubuntu, Debian, Fedora...)
⚠️ Windows (via WSL2 apenas)

🛠️ Software Necessário

Node.js 22 (obrigatório)
npm (incluído com Node.js)
Docker (recomendado)

🔑 API Keys

Claude API (Anthropic) OU
OpenAI API (GPT-4)
Contas separadas de mensagens

💾 Hardware

RAM: 4GB+ (mínimo 2GB)
Disco: 10GB+ (mínimo 5GB)
Rede: Conexão estável

Guia para Iniciantes (Passo-a-Passo)

Instalação no macOS

Instalar Homebrew (se ainda não tiveres)

Abre o Terminal e executa:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Instalar Node.js 22

brew install node@22

Verifica a instalação:

node --version  # Deve mostrar v22.x.x

Instalar Docker (Opcional mas Recomendado)

Descarrega e instala: Docker Desktop for Mac

Instalar o Open Claw

npm install -g openclaw@latest

Executar o Setup Inicial

openclaw onboard --install-daemon

Segue as instruções no ecrã para:

Inserir API key (Claude ou OpenAI)
Configurar plataformas (WhatsApp, Telegram...)
Definir permissões

Testar o Bot

Envia uma mensagem para o teu bot na plataforma configurada:

Olá! Estás a funcionar?

Instalação no Linux

Instalar Node.js 22

Ubuntu/Debian:

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

Fedora/RHEL:

curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo dnf install -y nodejs

Instalar Docker

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER

Reinicia a sessão para aplicar permissões.

Instalar e Configurar o Open Claw

npm install -g openclaw@latest
openclaw onboard --install-daemon

Instalação no Windows (via WSL2)

⚠️ Windows requer WSL2. Instalação nativa do Windows NÃO é suportada.

Instalar WSL2

Abre PowerShell como Administrador:

wsl --install

Reinicia o computador.

Configurar Ubuntu no WSL

Abre "Ubuntu" no Menu Iniciar e cria um utilizador.

Instalar Node.js e Open Claw

Dentro do terminal Ubuntu:

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
npm install -g openclaw@latest
openclaw onboard --install-daemon

🎉 Parabéns!

O teu Open Claw está instalado e a funcionar! Envia-lhe uma mensagem para testares.

Configuração Avançada

Variáveis de Ambiente

Configuração via ficheiro .env ou variáveis de sistema:

# API Keys
ANTHROPIC_API_KEY=sk-ant-xxx
OPENAI_API_KEY=sk-xxx

# Sandboxing
OPENCLAW_USE_DOCKER=true
OPENCLAW_DOCKER_IMAGE=openclaw/sandbox:latest

# Logging
OPENCLAW_LOG_LEVEL=info
OPENCLAW_LOG_FILE=/var/log/openclaw.log

# Networking
OPENCLAW_HOST=127.0.0.1
OPENCLAW_PORT=3000

Docker Sandboxing Avançado

# Criar rede isolada
docker network create openclaw-isolated

# Executar com restrições
docker run --name openclaw-sandbox \
  --network openclaw-isolated \
  --cpus="2" \
  --memory="2g" \
  --read-only \
  --security-opt=no-new-privileges \
  openclaw/sandbox:latest

Configuração de Permissões Granulares

Edita ~/.config/openclaw/permissions.json:

{
  "filesystem": {
    "read": ["~/Documents", "~/Downloads"],
    "write": ["~/OpenClawData"],
    "deny": ["~/.ssh", "~/.config/openclaw"]
  },
  "network": {
    "allowDomains": ["api.anthropic.com", "api.openai.com"],
    "blockDomains": ["*"]
  },
  "commands": {
    "allow": ["ls", "cat", "grep"],
    "deny": ["rm", "dd", "chmod"]
  }
}

Instalação de Skills Personalizadas

# Instalar skill do ClawdHub
openclaw skill install nome-da-skill

# Instalar skill local
openclaw skill install ./minha-skill

# Listar skills instaladas
openclaw skill list

# Remover skill
openclaw skill remove nome-da-skill

⚠️ Sempre audita o código de uma skill antes de instalar!

Daemon e Serviços de Sistema

macOS (launchd):

openclaw daemon install
openclaw daemon start
openclaw daemon status

Linux (systemd):

sudo systemctl enable openclaw
sudo systemctl start openclaw
sudo systemctl status openclaw

Troubleshooting Avançado

Verificar logs:

openclaw logs --tail 100
openclaw logs --follow

Debug mode:

OPENCLAW_LOG_LEVEL=debug openclaw start

Reset completo:

openclaw reset --all
# ATENÇÃO: Apaga TODAS as configurações e dados!

Próximos Passos

🔒

Configurar Segurança

Essencial para usar com segurança

📚

Explorar Recursos

Skills, comunidade e documentação

❓

FAQ

Dúvidas comuns e soluções