Node.js¶

O OpenClaw requer Node 22 ou mais recente. O script de instalação detectará e instalará o Node automaticamente — esta página é para quando você quer configurar o Node por conta própria e garantir que tudo esteja corretamente conectado (versões, PATH, instalações globais).

Verifique sua versão¶

node -v

Se isso imprimir v22.x.x ou superior, está tudo certo. Se o Node não estiver instalado ou a versão for muito antiga, escolha um método de instalação abaixo.

Instalar Node¶

Homebrew (recomendado):

````
```bash
brew install node
```

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

Ubuntu / Debian:

````
```bash
curl -fsSL https://deb.nodesource.com/setup_22.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 do Windows em [nodejs.org](https://nodejs.org/).
````

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

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

Exemplo com fnm:

fnm install 22
fnm use 22

Certifique-se de que seu gerenciador de versões esteja 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.

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"
        ```

        Em seguida, 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 via Configurações → Sistema → Variáveis de Ambiente.
      </Tab>
    </Tabs>
    ```

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.