Instalar OpenClaw no Linux: Ubuntu, Debian, Arch (Guia 2026)

Comandos de instalação do OpenClaw para Ubuntu, Debian, Fedora, Arch Linux e outras distros. Inclui systemd e configuração de produção.

Instalar OpenClaw no Linux

⏱️ 5 minutos · 🎯 Iniciante · 💻 Ubuntu, Debian, Fedora, Arch

O Linux é a plataforma nativa do OpenClaw. Este guia cobre as principais distribuições com comandos específicos para cada uma.

💡 Servidor de produção? Pule direto para a configuração com systemd para rodar 24/7.

Escolha sua Distro

Ubuntu / Debian

A maneira mais simples é usar o NodeSource:

# Adicionar repositório NodeSource (Node.js 20.x LTS)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -

# Instalar Node.js
sudo apt install -y nodejs

# Verificar instalação
node --version
npm --version

# Instalar OpenClaw
npm install -g openclaw@latest

Alternativa: Usando nvm

# Instalar nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc

# Instalar Node.js LTS
nvm install --lts

# Instalar OpenClaw
npm install -g openclaw@latest

Fedora / RHEL

# Habilitar módulo Node.js
sudo dnf module enable nodejs:20

# Instalar Node.js
sudo dnf install -y nodejs npm

# Verificar
node --version
npm --version

# Instalar OpenClaw
npm install -g openclaw@latest

Arch Linux

# Instalar Node.js
sudo pacman -S nodejs npm

# Verificar
node --version
npm --version

# Instalar OpenClaw
npm install -g openclaw@latest

Com yay (AUR)

yay -S nodejs-lts-iron
npm install -g openclaw@latest

Outras Distros

Para qualquer distribuição Linux:

  1. Instale Node.js 20+ usando o gerenciador de pacotes da sua distro
  2. Ou use nvm (funciona em qualquer distro):
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install --lts
npm install -g openclaw@latest

Configuração Inicial

Após instalar, execute o wizard:

openclaw onboard --install-daemon

O wizard vai guiar você para:

  1. Escolher seu provedor de IA (OpenAI, Anthropic, etc.)
  2. Configurar suas chaves de API
  3. Conectar um canal (WhatsApp, Telegram, Discord)

Configuração para Produção (systemd)

Para servidores que precisam rodar 24/7:

Criar o serviço

sudo tee /etc/systemd/system/openclaw.service << 'EOF'
[Unit]
Description=OpenClaw AI Assistant
After=network.target

[Service]
Type=simple
User=seu_usuario
WorkingDirectory=/home/seu_usuario/clawd
ExecStart=/usr/bin/openclaw gateway start --foreground
Restart=always
RestartSec=10
Environment=NODE_ENV=production

[Install]
WantedBy=multi-user.target
EOF

Importante: Substitua seu_usuario pelo seu nome de usuário real.

Ativar e iniciar

# Recarregar systemd
sudo systemctl daemon-reload

# Habilitar no boot
sudo systemctl enable openclaw

# Iniciar agora
sudo systemctl start openclaw

# Ver status
sudo systemctl status openclaw

# Ver logs
journalctl -u openclaw -f

Troubleshooting Linux

Erro: “EACCES permission denied”

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g openclaw@latest

Erro: “node: command not found”

# Verificar PATH
echo $PATH

# Se instalou via nvm, ativar:
source ~/.nvm/nvm.sh
nvm use --lts

Erro de dependências nativas

Algumas distros precisam de ferramentas de compilação:

# Ubuntu/Debian
sudo apt install build-essential

# Fedora
sudo dnf groupinstall "Development Tools"

# Arch
sudo pacman -S base-devel

Firewall bloqueando conexões

Se usar ufw (Ubuntu):

sudo ufw allow 3000/tcp  # Porta padrão do OpenClaw

Se usar firewalld (Fedora):

sudo firewall-cmd --add-port=3000/tcp --permanent
sudo firewall-cmd --reload

Dicas de Performance

Memória Swap

Para servidores com pouca RAM:

# Criar 2GB de swap
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

Limitar uso de memória do Node.js

# No arquivo de serviço ou antes de executar
export NODE_OPTIONS="--max-old-space-size=1024"

Próximos Passos

Agora que o OpenClaw está instalado:

  1. Configure seu primeiro bot - Crie um assistente básico
  2. Personalize a personalidade - Edite o SOUL.md
  3. Deploy na Oracle Cloud (Grátis) - Rode 24/7
  4. Explore as Skills - Adicione funcionalidades prontas

Artigos Relacionados