Node.js

O OpenClaw requer Node 22.22.3+, Node 24.15+ ou Node 25.9+. O Node 24 é o runtime padrão e recomendado para instalações, CI e fluxos de trabalho de lançamento; o Node 22 continua sendo compatível por meio da linha LTS ativa. O Node 23 não é compatível. O script de instalação detecta e instala o Node automaticamente — use esta página quando quiser configurar o Node por conta própria (versões, PATH, instalações globais).

Verifique sua versão

node -v

v24.15.0 ou uma versão 24.x mais recente é o padrão recomendado. v22.22.3 ou uma versão 22.x mais recente é o caminho compatível do Node 22 LTS; o Node v25.9.0+ também é compatível. O Node 23 não é compatível. Se o Node estiver ausente ou fora do intervalo compatível, escolha um método de instalação abaixo.

Instale o Node

macOS
Linux
Windows

Homebrew (recomendado):

brew install node

Ou baixe o instalador para macOS em nodejs.org.

Ubuntu / Debian:

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

Fedora / RHEL:

sudo dnf install nodejs

Ou use um gerenciador de versões (veja abaixo).

winget (recomendado):

winget install OpenJS.NodeJS.LTS

Chocolatey:

choco install nodejs-lts

Ou baixe o instalador para Windows em nodejs.org.

Como usar um gerenciador de versões (nvm, fnm, mise, asdf)

Os gerenciadores de versões permitem alternar facilmente entre versões do Node. Opções populares:

fnm - rápido e multiplataforma
nvm - amplamente usado no macOS/Linux
mise - poliglota (Node, Python, Ruby etc.)

Exemplo com fnm:

fnm install 24
fnm use 24

Inicialize seu gerenciador de versões no arquivo de inicialização do shell (~/.zshrc ou ~/.bashrc). Se você ignorar esta etapa, openclaw poderá não ser encontrado em novas sessões do terminal porque o PATH não incluirá o diretório bin do Node.

Solução de problemas

`openclaw: command not found`

Isso quase sempre significa que o diretório bin global do npm não está no seu PATH.

Encontre o prefixo global do npm

npm prefix -g

Verifique se ele está no seu PATH

echo "$PATH"

Procure por <npm-prefix>/bin (macOS/Linux) ou <npm-prefix> (Windows) na saída.

Adicione-o ao arquivo de inicialização do shell

macOS / Linux
Windows

Adicione a ~/.zshrc ou ~/.bashrc:

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

Em seguida, abra um novo terminal (ou execute rehash no zsh / hash -r no bash).

Adicione a saída de npm prefix -g ao PATH do sistema em Settings → System → Environment Variables.

Erros de permissão em `npm install -g` (Linux)

Se você encontrar erros EACCES, altere o prefixo global do npm para um diretório no qual o usuário possa gravar:

mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"

Adicione a linha export PATH=... ao seu ~/.bashrc ou ~/.zshrc para tornar a alteração permanente.

Conteúdo relacionado

Visão geral da instalação - todos os métodos de instalação
Atualização - como manter o OpenClaw atualizado
Primeiros passos - primeiras etapas após a instalação

Install overview

Maintenance

Containers

Hosting

Advanced setup

Verifique sua versão

Instale o Node

Solução de problemas

`openclaw: command not found`

Erros de permissão em `npm install -g` (Linux)

Conteúdo relacionado

​Verifique sua versão

​Instale o Node

​Solução de problemas

​openclaw: command not found

​Erros de permissão em npm install -g (Linux)

​Conteúdo relacionado

Verifique sua versão

Instale o Node

Solução de problemas

`openclaw: command not found`

Erros de permissão em `npm install -g` (Linux)

Conteúdo relacionado