---
title: "Instalar OpenClaw no Linux: Ubuntu, Debian, Arch (Guia 2026)"
url: "https://openclaw.ia.br/instalacao/linux.md"
markdown_url: "https://openclaw.ia.br/instalacao/linux.md"
description: "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: 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

<div class="badges">
⏱ <strong>5 minutos</strong> ·  <strong>Iniciante</strong> ·  <strong>Ubuntu, Debian, Fedora, Arch</strong>
</div>

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](#configuração-para-produção-systemd) para rodar 24/7.

---

## Escolha sua Distro

- [Ubuntu / Debian](#ubuntu--debian)
- [Fedora / RHEL](#fedora--rhel)
- [Arch Linux](#arch-linux)
- [Outras Distros](#outras-distros)

---

## Ubuntu / Debian

A maneira mais simples é usar o NodeSource:

```bash
# 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

```bash
# 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

```bash
# 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

```bash
# Instalar Node.js
sudo pacman -S nodejs npm

# Verificar
node --version
npm --version

# Instalar OpenClaw
npm install -g openclaw@latest
```

### Com yay (AUR)

```bash
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):

```bash
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:

```bash
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

```bash
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

```bash
# 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"

```bash
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"

```bash
# 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:

```bash
# 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):

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

Se usar firewalld (Fedora):

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

---

## Dicas de Performance

### Memória Swap

Para servidores com pouca RAM:

```bash
# 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

```bash
# 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](/tutoriais/primeiro-bot/)** - Crie um assistente básico
2. **[Personalize a personalidade](/tutoriais/personalizar-soul/)** - Edite o SOUL.md
3. **[Deploy na Oracle Cloud (Grátis)](/blog/instalar-openclaw-gratis-oracle-cloud/)** - Rode 24/7
4. **[Explore as Skills](/skills/)** - Adicione funcionalidades prontas

---

## Artigos Relacionados

- [Instalação no Windows (WSL2)](/instalacao/windows/)
- [Instalação no macOS](/instalacao/macos/)
- [Instalação com Docker](/instalacao/docker/)
- [Troubleshooting Geral](/troubleshooting/)