Como instalar o OpenClaw: guia de instalação passo a passo completo 2026

Introdução

A instalação do OpenClaw é simples, com vários métodos para atender a diferentes preferências e níveis de conforto técnico. Se você deseja uma instalação rápida de uma linha, prefere npm ou deseja compilar a partir do código-fonte, este guia cobre todas as opções.

Este guia cobre a instalação em macOS, Windows e Linux. Para obter detalhes específicos da plataforma, consulte nossos guias dedicados:

• Guia de configuração do macOS
• Guia de configuração do Windows
• Guia de configuração do Linux

Pré-requisitos

Antes de instalar o OpenClaw, certifique-se de ter:

• Node.js 18+ — Necessário para executar o OpenClaw (o instalador de uma linha lida com isso automaticamente)
• Acesso ao Terminal — Interface de linha de comando em seu sistema
• Conexão com a Internet — Para baixar pacotes e dependências
• **2 GB + RAM ** — Recomendado para operação suave

O instalador de uma linha instalará automaticamente o Node.js se ainda não estiver presente, portanto, você poderá prosseguir mesmo se não tiver o Node.js instalado.

Métodos de instalação

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

A maneira mais rápida de executar o OpenClaw é o instalador one-liner. Ele lida com a instalação do Node.js e todas as dependências automaticamente.

macOS/Linux

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

Este script irá:

1. Verifique se há Node.js (instale se estiver faltando)
2. Instale o OpenClaw globalmente via npm
3. Configure as permissões necessárias
4. Verifique a instalação

Após a conclusão da instalação, você verá:

✓ OpenClaw installed successfully!
  Run 'openclaw onboard' to get started.

Windows (PowerShell)

irm https://openclaw.ai/install.ps1 | iex

Ou usando o método npm (veja abaixo) que funciona de forma idêntica no Windows.

Método 2: instalação npm

Se você já possui o Node.js instalado, você pode instalar o OpenClaw diretamente via npm:

npm i -g openclaw

Isso instala o OpenClaw globalmente, disponibilizando o comando openclaw em todo o sistema.

Usando pnpm:

pnpm add -g openclaw

Usando fio:

yarn global add openclaw

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

Para desenvolvedores que desejam modificar o código-fonte ou contribuir, você pode construir o OpenClaw a partir do código-fonte:

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

Em seguida, execute o OpenClaw usando:

pnpm run openclaw onboard

Ou vincule-o globalmente:

pnpm link --global

Este método oferece controle total sobre a base de código e facilita a personalização do OpenClaw de acordo com suas necessidades.

Método 4: Aplicativo macOS Companion (Beta)

Para usuários do macOS, há um aplicativo de barra de menu complementar que fornece uma interface GUI junto com a CLI:

1. Baixe em Versões do GitHub
2. Abra o arquivo .dmg
3. Arraste OpenClaw para Aplicativos
4. Inicie a partir de aplicativos ou Spotlight

O aplicativo complementar funciona junto com a instalação da CLI e fornece:

• Acesso à barra de menu
• Indicadores visuais de status
• Acesso rápido às configurações
• Visualizador de registros

Requisitos:

• macOS 14+ (Sonoma ou posterior)
• Universal Binary (funciona em Apple Silicon e Intel)

Requisitos do sistema

macOS

• macOS 13 Ventura ou posterior
• Node.js 18+ (instalado automaticamente por one-liner)
• 2 GB + RAM recomendado
• Processador Apple Silicon (M1/M2/M3) ou Intel

Windows

• Windows 10 ou Windows 11
• Node.js 18+
• PowerShell 5.1+ ou Terminal Windows
• WSL2 recomendado para melhor experiência

Linux

• Ubuntu 20.04+, Debian 11+, Fedora 34+ ou similar
• Node.js 18+
• 2 GB + RAM
• Arquitetura ARM64 ou x86_64
• Compatível com Raspberry Pi 4+

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

Após a instalação, você precisa configurar o OpenClaw antes de usá-lo. Execute o comando de integração:

openclaw onboard

Esta configuração interativa irá guiá-lo através de:

1. Seleção de modelo de IAEscolha seu provedor de IA:

• ** Claude Anthropic ** - Claude 3.5 Sonnet, Claude 3 Opus, Claude 4
• OpenAI GPT — GPT-4o, GPT-4 Turbo, GPT-4.1
• Modelos locais — Ollama, LM Studio, MiniMax

Você precisará de chaves de API para modelos de nuvem. Para Claude, obtenha sua chave em console.anthropic.com. Para OpenAI, obtenha sua chave em platform.openai.com.

2. Configuração da Persona

Configure a personalidade da sua IA:

• Nome (padrão: “Lagosta”)
• Tom e estilo
• Capacidades e limitações
• Preferências de resposta

3. Configuração de memória

Configure a memória persistente:

• Local de armazenamento
• Políticas de retenção de memória
• Tamanho da janela de contexto

4. Habilidades Iniciais

Selecione habilidades padrão para ativar:

• Gerenciamento de e-mail
• Integração de calendário
• Controle do navegador
• Acesso ao sistema de arquivos

Verificando a instalação

Após a instalação, verifique se tudo funciona:

openclaw --version

Você deverá ver o número da versão (por exemplo, v1.0.0).

Teste a instalação:

openclaw test

Isso executa um diagnóstico rápido para garantir que todos os componentes estejam funcionando corretamente.

Conectando aplicativos de bate-papo

Depois que o OpenClaw estiver instalado e configurado, conecte seus aplicativos de bate-papo:

openclaw integrations

Isso abre um menu interativo para configurar:

• WhatsApp
• Telegrama
• Discórdia
• Folga
• iMessage
• Outras plataformas

Para guias de configuração detalhados, consulte:

• Configuração do WhatsApp
• Configuração do telegrama
• Configuração do Discord
• Configuração do Slack
• Configuração do iMessage

Iniciando o OpenClaw

Para iniciar o servidor OpenClaw:

openclaw

Isso inicia o servidor local e conecta todas as integrações configuradas. Você verá mensagens de status indicando quais aplicativos de bate-papo estão conectados.

Para executar em segundo plano:

openclaw start --daemon

Ou use um gerenciador de processos como pm2:

npm i -g pm2
pm2 start openclaw
pm2 save
pm2 startup

Solução de problemas

Falha na instalação

Se o instalador de uma linha falhar:

1. Verifique a versão do Node.js:

   node --version

   Deve ser v18 ou superior.

2. Tente npm install diretamente:

   npm i -g openclaw

3. Verifique as permissões:

   sudo npm i -g openclaw

   (somente macOS/Linux)

Comando não encontrado

Se o comando openclaw não for encontrado:

1. Verifique o caminho global do npm:

   npm config get prefix

2. Adicione ao PATH (se necessário):

   export PATH="$PATH:$(npm config get prefix)/bin"

3. Reinicie o terminal após a instalação

Porta já em uso

Se você vir erros de “porta já em uso”:

openclaw --port 3001

Ou encontre e elimine o processo usando a porta:

lsof -ti:3000 | xargs kill

Erros de permissão

No macOS/Linux, pode ser necessário conceder permissões:

• Acesso ao terminal
• Acesso ao sistema de arquivos
• Acesso à rede

Verifique Preferências do Sistema → Segurança e Privacidade.

Atualizando o OpenClaw

Para atualizar para a versão mais recente:

npm update -g openclaw

Ou execute novamente o instalador one-liner (ele será atualizado se já estiver instalado).

Verifique se há atualizações:

npm outdated -g openclaw

Desinstalando o OpenClaw

Para remover o OpenClaw:

npm uninstall -g openclaw

Isso remove a instalação global, mas mantém sua configuração e seus dados. Para remover tudo:

rm -rf ~/.openclaw

Próximas etapas

Agora que o OpenClaw está instalado:

1. Explorar habilidades — Confira as habilidades disponíveis em /skills
2. Configurar integrações — Conecte seus aplicativos de bate-papo (consulte a página de integrações)
3. Leia as perguntas frequentes — Perguntas comuns respondidas em /faq
4. Participe da comunidade — Discord, discussões no GitHub e muito mais

ConclusãoInstalar o OpenClaw é rápido e simples. O instalador one-line lida com a maior parte da complexidade, tornando-o acessível a usuários de todos os níveis técnicos. Depois de instalado, o comando openclaw onboard orienta você durante a configuração.

Para dicas específicas da plataforma e opções de configuração avançada, consulte nossos guias detalhados:

• Configuração do macOS
• Configuração do Windows
• Configuração do Linux

Pronto para começar a usar seu assistente pessoal de IA? Execute openclaw onboard e inicie o processo de configuração!