docs/docs/pt-BR/install/node.md

read_when	summary	title	x-i18n
Você precisa instalar o Node.js antes de instalar o OpenClaw Você instalou o OpenClaw, mas `openclaw` é comando não encontrado npm install -g falha com problemas de permissões ou PATH	Instalar e configurar Node.js para OpenClaw — requisitos de versão, opções de instalação e solução de problemas de PATH	Node.js	generated_at model provider source_hash source_path workflow 2026-04-24T05:58:37Z gpt-5.4 openai 99c72b917fa8beba136ee6010799c0183cff8b2420b5a1bd256d9155e50f065a install/node.md 15

O OpenClaw exige Node 22.14 ou mais recente. Node 24 é o runtime padrão e recomendado para instalações, CI e fluxos de release. O Node 22 continua compatível por meio da 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.14.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 muito antiga, escolha um método de instalação abaixo.

Instalar o Node

**Homebrew** (recomendado):

```bash
brew install node
```

Ou baixe o instalador para macOS em [nodejs.org](https://nodejs.org/).

**Ubuntu / Debian:**

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

**Fedora / RHEL:**

```bash
sudo dnf install nodejs
```

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

**winget** (recomendado):

```powershell
winget install OpenJS.NodeJS.LTS
```

**Chocolatey:**

```powershell
choco install nodejs-lts
```

Ou baixe o instalador para Windows em [nodejs.org](https://nodejs.org/).

Gerenciadores de versão permitem alternar entre versões do Node com facilidade. Opções populares:

• fnm — rápido, multiplataforma
• nvm — amplamente usado em macOS/Linux
• mise — poliglota (Node, Python, Ruby etc.)

Exemplo com fnm:

fnm install 24
fnm use 24

Certifique-se de que seu gerenciador de versões esteja inicializado no arquivo de inicialização do shell (`~/.zshrc` ou `~/.bashrc`). Caso contrário, `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 global bin do npm não está no seu PATH.

```bash npm prefix -g ``` ```bash echo "$PATH" ```

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

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

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

    Depois abra um novo terminal (ou execute `rehash` no zsh / `hash -r` no bash).
  </Tab>
  <Tab title="Windows">
    Adicione a saída de `npm prefix -g` ao PATH do sistema em Configurações → Sistema → Variáveis de Ambiente.
  </Tab>
</Tabs>

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

Se você vir erros EACCES, mude 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

• Visão geral da instalação — todos os métodos de instalação
• Atualizando — manter o OpenClaw atualizado
• Primeiros passos — primeiros passos após a instalação