Pular para o conteúdo principal

​
Requisitos do sistema

  • Node 24 (recomendado) ou Node 22.19+ - o script de instalação cuida disso automaticamente
  • macOS, Linux ou Windows - usuários do Windows podem começar com o app Windows Hub nativo, o instalador CLI do PowerShell ou um Gateway WSL2. Consulte Windows.
  • pnpm só é necessário se você compilar a partir do código-fonte

​
Recomendado: script de instalação

A forma mais rápida de instalar. Ele detecta seu sistema operacional, instala o Node se necessário, instala o OpenClaw e inicia a integração inicial.
Usuários de desktop Windows também podem instalar o app complementar nativo Windows Hub, que inclui configuração, status na bandeja, chat, modo Node e modo MCP local.
curl -fsSL https://openclaw.ai/install.sh | bash
Para instalar sem executar a integração inicial: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Para todas as flags e opções de CI/automação, consulte Internos do instalador.

​
Métodos alternativos de instalação

​
Instalador de prefixo local (install-cli.sh)

Use isto quando quiser manter o OpenClaw e o Node em um prefixo local, como ~/.openclaw, sem depender de uma instalação de Node em todo o sistema: 
curl -fsSL https://openclaw.ai/install-cli.sh | bash
Ele oferece suporte a instalações npm por padrão, além de instalações por checkout do git no mesmo fluxo de prefixo. Referência completa: Internos do instalador. Já instalado? Alterne entre instalações por pacote e por git com openclaw update --channel dev e openclaw update --channel stable. Consulte Atualização.

​
npm, pnpm ou bun

Se você já gerencia o Node por conta própria: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
O instalador hospedado limpa filtros de atualização do npm, como min-release-age, para a instalação do pacote OpenClaw. Se você instalar manualmente com npm, sua própria política do npm ainda se aplica.

​
A partir do código-fonte

Para contribuidores ou qualquer pessoa que queira executar a partir de um checkout local: 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
Ou pule o link e use pnpm openclaw ... de dentro do repositório. Consulte Configuração para fluxos de trabalho de desenvolvimento completos.

​
Instalar a partir do checkout main do GitHub

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

​
Contêineres e gerenciadores de pacotes

Docker

Implantações em contêiner ou sem interface gráfica.

Podman

Alternativa sem root ao Docker para contêineres.

Nix

Instalação declarativa via flake do Nix.

Ansible

Provisionamento automatizado de frota.

Bun

Uso somente da CLI via runtime Bun.

​
Verificar a instalação

openclaw --version      # confirme que a CLI está disponível
openclaw doctor         # verifique problemas de configuração
openclaw gateway status # verifique se o Gateway está em execução
Se você quiser inicialização gerenciada após a instalação:
  • macOS: LaunchAgent via openclaw onboard --install-daemon ou openclaw gateway install
  • Linux/WSL2: serviço de usuário systemd via os mesmos comandos
  • Windows nativo: Scheduled Task primeiro, com fallback para item de login na pasta Startup por usuário se a criação da tarefa for negada

​
Hospedagem e implantação

Implante o OpenClaw em um servidor na nuvem ou VPS:

VPS

Qualquer VPS Linux.

VM Docker

Etapas compartilhadas do Docker.

Kubernetes

Implantação K8s.

Fly.io

Implante na Fly.io.

Hetzner

Implantação na Hetzner.

GCP

Implantação no Google Cloud.

Azure

Implantação no Azure.

Railway

Implantação na Railway.

Render

Implantação na Render.

Northflank

Implantação na Northflank.

​
Atualizar, migrar ou desinstalar

Atualização

Mantenha o OpenClaw atualizado.

Migração

Migre para uma nova máquina.

Desinstalar

Remova o OpenClaw completamente.

​
Solução de problemas: openclaw não encontrado

Se a instalação foi concluída, mas openclaw não é encontrado no seu terminal: 
node -v           # Node instalado?
npm prefix -g     # Onde estão os pacotes globais?
echo "$PATH"      # O diretório bin global está no PATH?
Se $(npm prefix -g)/bin não estiver no seu $PATH, adicione-o ao arquivo de inicialização do seu shell (~/.zshrc ou ~/.bashrc): 
export PATH="$(npm prefix -g)/bin:$PATH"
Depois, abra um novo terminal. Consulte Configuração do Node para mais detalhes.