Instalar

# Requisitos do sistema

• Node 24 (recomendado) ou Node 22.14+ - o script instalador cuida disso automaticamente
• macOS, Linux ou Windows - tanto o Windows nativo quanto o WSL2 têm suporte; o WSL2 é mais estável. Consulte Windows.
• pnpm só é necessário se você compilar a partir do código-fonte

# Recomendado: script instalador

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.

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

iwr -useb https://openclaw.ai/install.ps1 | iex

Para instalar sem executar a integração inicial:

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

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Para todas as flags e opções de CI/automação, consulte Detalhes internos do instalador.

# Métodos alternativos de instalação

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

Use isso 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 via 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 de 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 install -g openclaw@latest
openclaw onboard --install-daemon

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

bun add -g openclaw@latest
openclaw onboard --install-daemon

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 build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon

Ou ignore o link e use pnpm openclaw ... de dentro do repositório. Consulte Configuração para fluxos de trabalho completos de desenvolvimento.

# Instalar a partir da main do GitHub

npm install -g github:openclaw/openclaw#main

# Contêineres e gerenciadores de pacotes

# Verificar 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 em nuvem ou VPS:

node -v           # Node installed?
npm prefix -g     # Where are global packages?
echo "$PATH"      # Is the global bin dir in PATH?

export PATH="$(npm prefix -g)/bin:$PATH"