Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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.
  • pnpm só é 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. 
curl -fsSL https://openclaw.ai/install.sh | bash
Para instalar sem executar a integração: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Para 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 | 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: 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 install -g openclaw@latest
openclaw onboard --install-daemon
Se sharp falhar devido a uma libvips instalada globalmente:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

​
A 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.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 ... 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#main

​
Contêineres e gerenciadores de pacotes

Docker

Implantações conteinerizadas ou sem interface gráfica.

Podman

Alternativa de contêiner sem root ao Docker.

Nix

Instalação declarativa via Nix flake.

Ansible

Provisionamento automatizado de frotas.

Bun

Uso somente da CLI via runtime Bun.

​
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 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:

VPS

Qualquer VPS Linux

VM Docker

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 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.