Guia de configuração do OpenClaw Linux: instale no Ubuntu, Debian, Fedora e Raspberry Pi

Introdução

Linux é uma excelente plataforma para executar OpenClaw, especialmente para servidores sempre ativos e implantações de Raspberry Pi. Este guia cobre a instalação em distribuições Linux populares, incluindo Ubuntu, Debian, Fedora e Raspberry Pi OS, além de suporte ARM64 e configuração de serviço systemd.

Para obter instruções gerais de instalação, consulte nosso guia completo de instalação.

Requisitos do sistema

Distribuições Suportadas

Ubuntu 20.04+ (LTS recomendado)
Debian 11+ (Bullseye ou posterior)
Fedora 34+
SO Raspberry Pi (baseado em Debian)
Arch Linux (via AUR ou instalação manual)
Outras distribuições baseadas em Debian/Ubuntu

Requisitos de hardware

RAM — 2 GB+ recomendado (mínimo de 1 GB para Raspberry Pi)
Armazenamento — 500 MB+ para instalação, espaço adicional para memória/dados
CPU — arquitetura x86_64 ou ARM64
Rede — Conexão com a Internet para chamadas e atualizações de API

Pré-requisitos de software

Node.js 18+ — Pode ser instalado automaticamente pelo instalador one-liner
curl — Geralmente pré-instalado
git — Opcional, para instalação hackeável a partir do código-fonte
systemd — Para gerenciamento de serviços (distribuições mais modernas)

Métodos de instalação

Método 1: instalação One-Liner (recomendado)

A maneira mais fácil de instalar o OpenClaw no Linux:

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

Este script automaticamente:

Detecta sua distribuição Linux
Instala o Node.js se estiver faltando (via NodeSource ou gerenciador de pacotes de distribuição)
Instala OpenClaw globalmente via npm
Configura as permissões necessárias
Verifica a instalação

Observação: Sua senha (sudo) pode ser solicitada para instalar o Node.js ou pacotes do sistema.

Método 2: instalação npm

Se você já possui o Node.js instalado:

npm i -g openclaw

Verifique primeiro a versão do Node.js:

node --version

Deve ser v18.0.0 ou superior.

Método 3: Pacotes Específicos de Distribuição

Ubuntu/Debian (através do apt)

Algumas distribuições podem ter pacotes OpenClaw disponíveis:

# Add repository (if available)
curl -fsSL https://openclaw.ai/repo/deb/pubkey.gpg | sudo gpg --dearmor -o /usr/share/keyrings/openclaw.gpg
echo "deb [signed-by=/usr/share/keyrings/openclaw.gpg] https://openclaw.ai/repo/deb stable main" | sudo tee /etc/apt/sources.list.d/openclaw.list

# Install
sudo apt update
sudo apt install openclaw

Observação: Pacotes oficiais podem não estar disponíveis ainda. Verifique docs.openclaw.ai para obter os métodos de instalação mais recentes.

Fedora (via dnf)

# Add repository (if available)
sudo dnf install openclaw

Arch Linux (via AUR)

yay -S openclaw
# or
paru -S openclaw

Método 4: instalação hackeável (da fonte)

Para desenvolvedores que desejam modificar a fonte:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm run build

Então execute:

npm run openclaw onboard

Ou vincule globalmente:

sudo npm link --global

Instalando o Node.js

Ubuntu/Debian

Opção 1: Repositório NodeSource (recomendado)

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

Opção 2: Pacotes de Distribuição

sudo apt update
sudo apt install nodejs npm

Observação: Os pacotes de distribuição podem estar desatualizados. NodeSource fornece versões mais recentes.

Opção 3: nvm (Gerenciador de versão do nó)

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

Fedora

sudo dnf install nodejs npm

Ou use NodeSource:

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

Framboesa Pi (ARM64/ARMv7)

Raspberry Pi OS (baseado em Debian)

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

Para ARMv7 (32 bits), o NodeSource pode não ter pacotes. Use pacotes de distribuição ou crie a partir do código-fonte.

Alternativa: Instalar via nvm

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

Configuração pós-instalação

Após a instalação, configure o OpenClaw:

openclaw onboard

Esta configuração interativa abrange:

1. Configuração do modelo de IA

Escolha seu provedor de IA:

Claude Anthropic:

Soneto Claude 3.5 (recomendado)
Claude 3 Opus
Cláudio 4

Obtenha sua chave de API em console.anthropic.com.

OpenAI GPT:

GPT-4o
GPT-4 Turbo
GPT-4.1

Obtenha sua chave de API em platform.openai.com.

Modelos locais:

Ollama (executado localmente, sem necessidade de chave de API)
Estúdio LM
MiniMax

2. Permissões do Linux

OpenClaw pode precisar de permissões:- Sistema de arquivos — Acesso de leitura/gravação a ~/.openclaw

Rede — Para chamadas de API e pontes de chat
Comandos do sistema — Se estiver usando recursos de controle do sistema

3. Configuração do Firewall

Permitir OpenClaw através do firewall:

UFW (Ubuntu/Debian):

sudo ufw allow 3000/tcp

firewalld (Fedora/RHEL):

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

Executando o OpenClaw

Inicie o servidor

openclaw

Isso inicia o servidor local e conecta todas as integrações configuradas.

Executar em segundo plano

Utilize nohup:

nohup openclaw > ~/.openclaw/logs/output.log 2>&1 &

Ou use screen:

screen -S openclaw
openclaw
# Press Ctrl+A then D to detach

Ou use tmux:

tmux new -s openclaw
openclaw
# Press Ctrl+B then D to detach

Executar como serviço systemd (sempre ativo)

Crie um serviço systemd para inicialização automática:

Criar arquivo de serviço:

sudo nano /etc/systemd/system/openclaw.service

Adicionar configuração:

[Unit]
Description=OpenClaw Personal AI Assistant
After=network.target

[Service]
Type=simple
User=your-username
WorkingDirectory=/home/your-username
ExecStart=/usr/bin/openclaw
Restart=always
RestartSec=10
Environment="NODE_ENV=production"

[Install]
WantedBy=multi-user.target

Substitua your-username pelo seu nome de usuário real.

Recarregue o sistema:
```
sudo systemctl daemon-reload
```
Ativar serviço:
```
sudo systemctl enable openclaw
```
Iniciar serviço:
```
sudo systemctl start openclaw
```
Verificar status:
```
sudo systemctl status openclaw
```
Ver registros:
```
sudo journalctl -u openclaw -f
```

Usando pm2 (Gerenciador de Processos)

Instale pm2:

npm i -g pm2

Inicie o OpenClaw:

pm2 start openclaw
pm2 save
pm2 startup

O comando pm2 startup irá gerar um serviço systemd automaticamente.

Configuração específica do Raspberry Pi

Otimização de desempenho

Raspberry Pi tem recursos limitados. Otimizar:

Use modelos de IA mais leves:
- Modelos locais (Ollama) são mais eficientes
- Ou use modelos de nuvem menores
Limitar operações simultâneas:
- Configure o OpenClaw para lidar com menos solicitações simultâneas
Monitore recursos:
```
htop
```

Configuração sempre ativa

Para Raspberry Pi rodando 24 horas por dia, 7 dias por semana:

Use o serviço systemd (veja acima)
Ative o login automático (se necessário)

Configurar o gerenciamento de energia:

sudo raspi-config
# Navigate to Advanced Options → Wait for Network at Boot

Túnel Cloudflare (acesso externo)

Exponha o OpenClaw à Internet com segurança:

Instale o cloudflared:

curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-arm64 -o cloudflared
chmod +x cloudflared
sudo mv cloudflared /usr/local/bin/

Autenticar:
```
cloudflared tunnel login
```
Criar túnel:
```
cloudflared tunnel create openclaw
```

Configurar: Crie ~/.cloudflared/config.yml:

tunnel: <tunnel-id>
credentials-file: /home/pi/.cloudflared/<tunnel-id>.json

ingress:
  - hostname: openclaw.yourdomain.com
    service: http://localhost:3000
  - service: http_status:404

Executar túnel:
```
cloudflared tunnel run openclaw
```
Adicionar ao systemd (para inicialização automática):
```
sudo cloudflared service install
```

Suporte ARM64

OpenClaw funciona na arquitetura ARM64:

Macs Apple Silicon (via Linux VM)
Raspberry Pi 4+ (64 bits)
Instâncias AWS Graviton
Outros servidores ARM64

A instalação é idêntica ao x86_64. O instalador one-liner detecta a arquitetura automaticamente.

Para ARMv7 (Raspberry Pi de 32 bits), alguns pacotes podem não estar disponíveis. Use pacotes de distribuição ou crie a partir do código-fonte.

Solução de problemas

Erros de permissão negada

Se você vir erros de permissão:

sudo npm i -g openclaw

Ou corrija as permissões npm:

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

Comando não encontrado

Se openclaw não for encontrado:

Verifique o caminho global do npm:
```
npm config get prefix
```

Adicionar ao PATH:

echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Reinicie o terminal

Porta já em uso

Altere a porta:

openclaw --port 3001

Ou encontre e elimine o processo:

lsof -ti:3000 | xargs kill
# or
sudo netstat -tlnp | grep :3000
sudo kill <PID>

Problemas de serviço do systemd

Se o serviço não iniciar:

Verifique os registros:
```
sudo journalctl -u openclaw -n 50
```
Verificar usuário: Certifique-se de que o serviço seja executado como o usuário correto
Verifique as permissões:
```
ls -la ~/.openclaw
```
Teste manualmente:
```
openclaw
```

Problemas específicos do Raspberry Pi

Pouca memória:

# Increase swap
sudo dphys-swapfile swapoff
sudo nano /etc/dphys-swapfile
# Set CONF_SWAPSIZE=2048
sudo dphys-swapfile setup
sudo dphys-swapfile swapon

Desempenho lento:

Use modelos de IA mais leves
Limitar sessões do navegador
Reduza o uso de memória

Dicas de desempenho

Monitoramento de recursos

Monitore CPU e memória:

htop
# or
top

Monitore o uso do disco:

df -h
du -sh ~/.openclaw
```### Otimização

- **Use modelos locais** para melhor desempenho em hardware de baixo custo
- **Limite as sessões do navegador** para reduzir o uso de memória
- **Configurar a rotação do log** para evitar o preenchimento do disco
- **Use SSD** em vez de cartão SD (Raspberry Pi)

## Atualizando o OpenClaw

Atualize para a versão mais recente:

```bash
npm update -g openclaw

Ou execute novamente o instalador:

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

Desinstalando

Remover OpenClaw:

npm uninstall -g openclaw

Remover configuração:

rm -rf ~/.openclaw

Pare e remova o serviço systemd:

sudo systemctl stop openclaw
sudo systemctl disable openclaw
sudo rm /etc/systemd/system/openclaw.service
sudo systemctl daemon-reload

Próximas etapas

Agora que o OpenClaw está instalado no Linux:

Configurar Always-On — Configure o serviço systemd
Conectar aplicativos de bate-papo — WhatsApp, Telegram, Discord
Explorar habilidades — Biblioteca de habilidades
Leia as perguntas frequentes — Perguntas comuns

Conclusão

Linux é uma excelente plataforma para OpenClaw, especialmente para implantações sempre ativas e projetos Raspberry Pi. O instalador one-line lida com a maior complexidade e a integração do systemd facilita a execução como um serviço.

Para obter mais ajuda, consulte nosso guia geral de instalação ou página de perguntas frequentes. Boa automação no Linux!

Protocolo de cookies iniciado

Quick Answer