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.

OpenClaw requer Node 22.16 ou mais recente. Node 24 é o runtime padrão e recomendado para instalações, CI e fluxos de lançamento. Node 22 continua com suporte pela linha LTS ativa. O script de instalação detectará e instalará o Node automaticamente - esta página é para quando você quiser configurar o Node por conta própria e garantir que tudo esteja conectado corretamente (versões, PATH, instalações globais).

​
Verifique sua versão

node -v
Se isso imprimir v24.x.x ou superior, você está no padrão recomendado. Se imprimir v22.16.x ou superior, você está no caminho compatível do Node 22 LTS, mas ainda recomendamos atualizar para o Node 24 quando for conveniente. Se o Node não estiver instalado ou a versão for antiga demais, escolha um método de instalação abaixo.

​
Instale o Node

Homebrew (recomendado):
brew install node
Ou baixe o instalador para macOS em nodejs.org.
Gerenciadores de versões permitem alternar entre versões do Node facilmente. Opções populares:
  • fnm - rápido, multiplataforma
  • nvm - amplamente usado no macOS/Linux
  • mise - poliglota (Node, Python, Ruby etc.)
Exemplo com fnm:
fnm install 24
fnm use 24
Verifique se o gerenciador de versões está inicializado no arquivo de inicialização do seu shell (~/.zshrc ou ~/.bashrc). Se não estiver, openclaw pode 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.
1

Find your global npm prefix

npm prefix -g
2

Check if it's on your PATH

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

Add it to your shell startup file

Adicione a ~/.zshrc ou ~/.bashrc:
export PATH="$(npm prefix -g)/bin:$PATH"
Depois abra um novo terminal (ou execute rehash no zsh / hash -r no bash).

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

Se você vir erros EACCES, altere o prefixo global do npm para um diretório gravável pelo usuário: 
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 torná-la permanente.

​
Relacionado