Pular para o conteúdo principal

​
Instalar

​
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 o onboarding. 
curl -fsSL https://openclaw.ai/install.sh | bash
Para instalar sem executar o onboarding: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Para ver todas as flags e opções de CI/automação, consulte Internos do instalador.

​
Requisitos do sistema

  • Node 24 (recomendado) ou Node 22.14+ — o script de instalação cuida disso automaticamente
  • macOS, Linux ou Windows — tanto Windows nativo quanto WSL2 são compatíveis; WSL2 é mais estável. Consulte Windows.
  • pnpm é necessário apenas se você compilar a partir do código-fonte

​
Métodos alternativos de instalação

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

Use este método quando quiser manter o OpenClaw e o Node sob 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 via npm por padrão, além de instalações a partir de checkout git no mesmo fluxo de prefixo. Referência completa: Internos do instalador.

​
npm, pnpm ou bun

Se você já gerencia o Node por conta própria: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
Se sharp falhar devido a um libvips instalado globalmente:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

​
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 ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon
Ou ignore o link e use pnpm openclaw ... de dentro do repositório. Consulte Setup para ver fluxos completos de desenvolvimento.

​
Instalar do GitHub main

npm install -g github:openclaw/openclaw#main

​
Contêineres e gerenciadores de pacotes

Docker

Implantações conteinerizadas ou headless.

Podman

Alternativa de contêiner rootless ao Docker.

Nix

Instalação declarativa via flake do Nix.

Ansible

Provisionamento automatizado de frota.

Bun

Uso somente da CLI via runtime Bun.

​
Verifique a instalação

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw gateway status # verify the Gateway is running
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 pelos mesmos comandos
  • Windows nativo: Scheduled Task primeiro, com fallback para um item de login por usuário na pasta Startup se a criação da tarefa for negada

​
Hospedagem e implantação

Implante o OpenClaw em um servidor de nuvem ou VPS:

VPS

Qualquer VPS Linux

Docker VM

Etapas compartilhadas do Docker

Kubernetes

K8s

Fly.io

Fly.io

Hetzner

Hetzner

GCP

Google Cloud

Azure

Azure

Railway

Railway

Render

Render

Northflank

Northflank

​
Atualizar, migrar ou desinstalar

Atualização

Mantenha o OpenClaw atualizado.

Migração

Mude para uma nova máquina.

Desinstalar

Remova o OpenClaw completamente.

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

Se a instalação foi bem-sucedida, mas openclaw não é encontrado no 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"
Depois abra um novo terminal. Consulte Configuração do Node para mais detalhes.