Como Rodar OpenClaw no Linux: Guia Completo

O que é o OpenClaw?

O OpenClaw (anteriormente conhecido como Clawdbot/Moltbot) é um assistente de IA pessoal de código aberto que você executa em seus próprios dispositivos. Diferente de assistentes baseados em nuvem, o OpenClaw é totalmente local, permitindo que você controle seus dados, fluxos de trabalho e comportamento do agente .

Principais Características:

• Assistente orientado a ações: Além de conversar, o OpenClaw pode executar tarefas reais, acessar arquivos locais, chamar APIs externas e automatizar processos
• Integração com múltiplos canais: Funciona via WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Google Chat, Matrix, Microsoft Teams e muitos outros
• Memória persistente: Mantém contexto entre sessões, diferente de chats pontuais
• Extensível via Skills: Adicione funcionalidades através de plugins específicos
• Interface Web e TUI: Acesse via navegador ou terminal

Requisitos do Sistema

Antes de começar, verifique se seu sistema possui:

• Node.js 24 (recomendado) ou Node.js 22.16+
• npm (incluído com Node.js) ou pnpm
• Sistema operacional Linux atualizado
• Conexão com a internet para download de dependências

Verifique sua versão do Node:

node -v

Instalação no Debian/Ubuntu

Passo 1: Instalar Dependências

Atualize o sistema e instale os pré-requisitos:

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git build-essential

Passo 2: Instalar Node.js 24

Opção A – Via NodeSource:

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

Opção B – Via nvm (recomendado para gerenciamento de versões):

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

Passo 3: Instalar OpenClaw

Execute o script oficial de instalação:

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

Ou via npm:

npm install -g openclaw@latest

Passo 4: Configuração Inicial

Execute o assistente de configuração:

openclaw onboard --install-daemon

Siga as instruções interativas para:

1. Aceitar os termos de segurança
2. Escolher o modo QuickStart
3. Configurar seu provedor de IA (OpenAI, Anthropic, Gemini, etc.)
4. Adicionar canais de comunicação (opcional)
5. Instalar skills adicionais (opcional)

Solução de Problemas

Se o comando openclaw não for encontrado:

export PATH="$(npm prefix -g)/bin:$PATH"
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc

Instalação no Fedora

Passo 1: Preparar o Sistema

sudo dnf update -y
sudo dnf install -y curl git gcc-c++ make

Passo 2: Instalar Node.js 24

Via repositório oficial Node.js:

sudo dnf install -y nodejs npm

Ou versão mais recente via nvm:

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

Passo 3: Instalar OpenClaw

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

Ou:

npm install -g openclaw@latest

Passo 4: Configurar Firewall (opcional mas recomendado)

Se for acessar a interface web remotamente:

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

Iniciar o OpenClaw

openclaw onboard --install-daemon

Instalação no openSUSE

Passo 1: Instalar Dependências

sudo zypper refresh
sudo zypper install -y curl git nodejs npm gcc-c++ make

Passo 2: Verificar/Atualizar Node.js

Verifique a versão instalada:

node -v

Se necessário, instale a versão 24 via nvm:

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

Passo 3: Instalar OpenClaw

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

Ou via npm:

npm install -g openclaw@latest

Passo 4: Configuração

openclaw onboard --install-daemon

Gerenciamento do Serviço (systemd)

O parâmetro --install-daemon já configura o serviço automaticamente. Para verificar:

systemctl --user status openclaw
systemctl --user start openclaw
systemctl --user stop openclaw

Instalação no Arch Linux e Manjaro

Arch Linux (via Pacman/AUR)

Passo 1: Instalar Node.js

sudo pacman -Syu
sudo pacman -S nodejs npm curl git base-devel

Passo 2: Instalar OpenClaw

Via script oficial:

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

Ou via npm:

npm install -g openclaw@latest

Manjaro (via Pamac ou Extensão AUR)

O Manjaro oferece duas formas convenientes de instalar o OpenClaw através do Pamac:

Opção 1: Via Linha de Comando (Pamac CLI)

# Atualizar o sistema
sudo pamac update

# Instalar dependências
sudo pamac install nodejs npm curl git base-devel

# Instalar OpenClaw via npm (método recomendado)
npm install -g openclaw@latest

Opção 2: Via Interface Gráfica (Pamac GUI)

1. Abra o Adicionar/Remover Software (Pamac)
2. Procure por nodejs e npm e instale-os
3. Abra um terminal e execute:

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

Opção 3: Via AUR (yay/paru)

Se você usa um helper AUR como yay ou paru:

# Instalar yay se não tiver
sudo pacman -S --needed git base-devel
git clone https://aur.archlinux.org/yay.git
cd yay
makepkg -si

# Instalar Node.js LTS via AUR (opcional)
yay -S nvm
source /usr/share/nvm/init-nvm.sh
nvm install 24
nvm use 24

# Instalar OpenClaw
npm install -g openclaw@latest

Configuração no Arch/Manjaro

openclaw onboard --install-daemon

Verifique a instalação:

openclaw doctor
openclaw status
openclaw dashboard

Instalação no NixOS

O NixOS requer uma abordagem declarativa. Felizmente, o OpenClaw pode ser instalado através do Nix com algumas configurações especiais.

Método 1: Via nix-shell (Temporário)

nix-shell -p nodejs_24 curl git
curl -fsSL https://openclaw.ai/install.sh | bash

Método 2: Via configuration.nix (Recomendado)

Adicione ao seu /etc/nixos/configuration.nix:

{ config, pkgs, ... }:

{
  # Instalar Node.js 24
  environment.systemPackages = with pkgs; [
    nodejs_24
    git
    curl
  ];

  # Criar um systemd user service para OpenClaw (opcional)
  systemd.user.services.openclaw = {
    description = "OpenClaw AI Assistant";
    wantedBy = [ "default.target" ];
    serviceConfig = {
      Type = "simple";
      ExecStart = "${pkgs.nodejs_24}/bin/npm exec -g openclaw gateway --port 18789";
      Restart = "on-failure";
      Environment = "PATH=${pkgs.nodejs_24}/bin:${pkgs.git}/bin:/run/current-system/sw/bin";
    };
  };
}

Depois aplique as mudanças:

sudo nixos-rebuild switch

Método 3: Via Home Manager

Se você usa Home Manager, adicione ao seu home.nix:

{ config, pkgs, ... }:

{
  home.packages = with pkgs; [
    nodejs_24
    git
    curl
  ];

  # Configurar npm global path
  home.sessionPath = [ 
    "$HOME/.npm-global/bin" 
  ];

  home.activation.installOpenClaw = config.lib.dag.entryAfter ["writeBoundary"] ''
    export PATH="${pkgs.nodejs_24}/bin:$PATH"
    mkdir -p $HOME/.npm-global
    npm config set prefix '~/.npm-global'
    npm install -g openclaw@latest
  '';
}

Configuração no NixOS

Após a instalação:

# Configurar npm global path se ainda não estiver configurado
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

# Executar onboarding
openclaw onboard

Nota: No NixOS, o caminho dos binários npm globais pode ser diferente. Ajuste o PATH conforme necessário ou use nix-shell para ambientes temporários.

Comandos Úteis Pós-Instalação

Após instalar em qualquer distribuição, estes comandos são essenciais:

Comando	Descrição
openclaw doctor	Verifica problemas de configuração
openclaw status	Mostra status do gateway
openclaw dashboard	Abre a interface web no navegador
openclaw onboard	Reexecuta o assistente de configuração
openclaw update	Atualiza para a versão mais recente
openclaw channels add	Adiciona novos canais de comunicação
openclaw agent --message "comando"	Envia comando direto ao agente

Dicas de Segurança Importantes

1. Nunca execute como root: Crie um usuário dedicado para o OpenClaw
2. Isole a instalação: Use VMs, containers ou dispositivos dedicados
3. Restrinja o gateway: Altere openclaw.json de 0.0.0.0 para 127.0.0.1
4. Habilite aprovação de execução: Ative exec_approval para ferramentas críticas
5. Cuidado com skills de terceiros: Verifique a procedência antes de instalar
6. Use firewall: Limite portas expostas e implemente regras de acesso

Conclusão

O OpenClaw representa uma evolução significativa nos assistentes de IA pessoais, oferecendo controle total sobre seus dados e a capacidade real de executar tarefas no seu sistema. A instalação no Linux é relativamente simples graças ao script oficial, funcionando de forma semelhante nas principais distribuições.

Para Debian/Ubuntu e Fedora, o processo é direto via script ou npm. O openSUSE segue o mesmo padrão com pequenas variações no gerenciamento de pacotes. No Arch Linux e Manjaro, você tem a flexibilidade adicional do AUR e do Pamac, tornando a instalação ainda mais conveniente. Já o NixOS requer uma abordagem declarativa, mas integra-se perfeitamente ao paradigma do sistema.

Independentemente da distribuição escolhida, lembre-se sempre de priorizar a segurança: execute em ambientes isolados, mantenha backups e revise cuidadosamente as permissões concedidas ao agente. Com as devidas precauções, o OpenClaw pode se tornar um poderoso assistente pessoal que realmente “faz coisas” no seu dia a dia.

ara mais informações, consulte a documentação oficial e o repositório GitHub.