Install overview
Instalar
Requisitos do sistema
- Node 24 (recomendado) ou Node 22.16+ - o script do instalador cuida disso automaticamente
- macOS, Linux ou Windows - tanto o Windows nativo quanto o WSL2 são compatíveis; o WSL2 é mais estável. Consulte Windows.
pnpmsó é necessário se você compilar a partir do código-fonte
Recomendado: script do instalador
A forma mais rápida de instalar. Ele detecta seu SO, instala o Node se necessário, instala o OpenClaw e inicia a integração.
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bashWindows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iexPara instalar sem executar a integração:
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboardWindows (PowerShell)
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardPara todas as flags e opções de CI/automação, consulte detalhes internos do instalador.
Métodos alternativos de instalação
Instalador com 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 do Node em todo o sistema:
curl -fsSL https://openclaw.ai/install-cli.sh | bashEle 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: detalhes internos do instalador.
Já instalado? Alterne entre instalações por pacote e 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
npm install -g openclaw@latestopenclaw onboard --install-daemonpnpm
pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemonbun
bun add -g openclaw@latestopenclaw onboard --install-daemonSolução de problemas: erros de build do sharp (npm)
Se sharp falhar devido a uma libvips instalada globalmente:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latestA partir do código-fonte
Para colaboradores ou qualquer pessoa que queira executar a partir de um checkout local:
git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemonOu pule o link e use pnpm openclaw ... dentro do repositório. Consulte Configuração para ver fluxos de desenvolvimento completos.
Instalar a partir da main do GitHub
npm install -g github:openclaw/openclaw#mainContêineres e gerenciadores de pacotes
Implantações conteinerizadas ou sem interface gráfica.
Alternativa de contêiner sem root ao Docker.
Instalação declarativa via Nix flake.
Provisionamento automatizado de frotas.
Uso somente da CLI via runtime Bun.
Verificar a instalação
openclaw --version # confirm the CLI is availableopenclaw doctor # check for config issuesopenclaw gateway status # verify the Gateway is runningSe você quiser inicialização gerenciada após a instalação:
- macOS: LaunchAgent via
openclaw onboard --install-daemonouopenclaw gateway install - Linux/WSL2: serviço de usuário systemd via os mesmos comandos
- Windows nativo: primeiro Tarefa Agendada, com fallback para item de login na pasta Inicializar por usuário se a criação da tarefa for negada
Hospedagem e implantação
Implante o OpenClaw em um servidor em nuvem ou VPS:
Atualizar, migrar ou desinstalar
Mantenha o OpenClaw atualizado.
Mude para uma nova máquina.
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 installed?npm prefix -g # Where are global packages?echo "$PATH" # Is the global bin dir in PATH?Se $(npm prefix -g)/bin não estiver no seu $PATH, adicione-o ao arquivo de inicialização do shell (~/.zshrc ou ~/.bashrc):
export PATH="$(npm prefix -g)/bin:$PATH"Em seguida, abra um novo terminal. Consulte configuração do Node para mais detalhes.