O que é o OpenClaw

O OpenClaw é um agente de IA local (tipo um “Jarvis”) que roda no seu computador, com interface web, automações e integração com APIs de modelos (OpenAI, Anthropic, etc.).

1. Sistemas Linux compatíveis

O OpenClaw não depende de uma distro específica, mas sim de um ambiente moderno com suporte a Node.js recente. Com base na documentação e requisitos técnicos, estas são as versões recomendadas e compatíveis:

Distribuições oficialmente suportadas (na prática)

Ubuntu (recomendado)

• Ubuntu 22.04 LTS

• Ubuntu 24.04 LTS

Motivo: maior compatibilidade com Node.js, bibliotecas e scripts de instalação.

Debian

• Debian 11 (Bullseye)

• Debian 12 (Bookworm)

Fedora

• Fedora 38+

• Fedora 39+

• Fedora 40+

Arch Linux

• Rolling release (sempre atualizado)

Outras opções compatíveis

• Linux Mint 21+ (base Ubuntu 22.04)

• Pop!_OS 22.04+

• WSL2 (com Ubuntu 22.04+)

Arquiteturas suportadas

• x86_64 (Intel/AMD)

• ARM64 (Raspberry Pi, servidores ARM)

2. Requisitos obrigatórios

Antes de instalar, verifique:

Node.js

• Versão mínima: Node.js 22 ou superior

Verificar:

node -v

Se não tiver ou estiver desatualizado, instale:

Ubuntu / Debian

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

Fedora

sudo dnf install nodejs

Arch Linux

sudo pacman -S nodejs npm

Outras dependências

• curl

• git

• npm (já vem com Node)

Instalar (Ubuntu/Debian):

sudo apt install -y curl git

3. Método recomendado (instalação automática)

Este é o método mais simples e recomendado.

Passo 1: executar instalador

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

O script faz automaticamente:

• instala dependências se necessário

• baixa o OpenClaw

• configura ambiente inicial

• prepara execução

Passo 2: iniciar configuração (onboarding)

openclaw onboard --install-daemon

Esse comando:

• configura o serviço local

• prepara o gateway

• inicia o sistema como daemon (rodando em segundo plano)

Passo 3: verificar status

openclaw gateway status

Se estiver correto, você verá que o serviço está ativo.

Passo 4: acessar interface

openclaw dashboard

Ou manualmente no navegador:

http://127.0.0.1:18789

4. Método manual (controle total)

Use este método se quiser personalizar a instalação.

Passo 1: clonar repositório

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

Passo 2: instalar dependências

npm install

Passo 3: compilar

npm run build

Passo 4: rodar configuração

npx openclaw onboard

5. Método via npm global

Alternativa simples:

npm install -g openclaw
openclaw onboard

6. Estrutura de diretórios

Por padrão:

~/.openclaw/

Contém:

• config.yaml (configuração principal)

• logs

• cache

• dados internos

Alterar diretório

export OPENCLAW_HOME=/opt/openclaw

7. Comandos importantes

Verificar instalação

openclaw doctor

Ver status geral

openclaw status

Rodar manualmente

openclaw gateway --port 18789

8. Problemas comuns e soluções

Node.js incompatível

Erro:

Unsupported Node version

Solução:
Instalar Node 22+

Permissão npm (EACCES)

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH="$HOME/.npm-global/bin:$PATH"

Porta em uso

Editar config.yaml:

server:
  port: 3001

Ou via variável:

export OPENCLAW_PORT=3001

Falha por memória insuficiente

export NODE_OPTIONS="--max-old-space-size=4096"

9. Segurança e boas práticas

• O OpenClaw pode executar automações locais

• Evite rodar como root

• Prefira:

  • usuário isolado

  • máquina virtual

  • container Docker

10. Recomendação final de ambiente

Para evitar problemas:

• Sistema: Ubuntu 22.04 ou 24.04

• Node.js: versão 22+

• RAM: mínimo 4GB (ideal 8GB)

11. Resumo do processo

1. Instalar Node.js 22+

2. Rodar script:

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

3. Executar:

   openclaw onboard --install-daemon
   

4. Acessar:

   http://localhost:18789