> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Node.js

OpenClaw требует **Node 22.19 или новее**. **Node 24 — среда выполнения по умолчанию и рекомендуемая среда** для установок, CI и рабочих процессов выпуска. Node 22 остается поддерживаемым через активную ветку LTS. [Скрипт установки](/ru/install#alternative-install-methods) автоматически обнаружит и установит Node — эта страница предназначена для случаев, когда вы хотите настроить Node самостоятельно и убедиться, что все подключено правильно (версии, PATH, глобальные установки).

## Проверьте свою версию

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
node -v
```

Если команда выводит `v24.x.x` или выше, вы используете рекомендуемую версию по умолчанию. Если она выводит `v22.19.x` или выше, вы используете поддерживаемый путь Node 22 LTS, но мы все равно рекомендуем перейти на Node 24, когда это будет удобно. Если Node не установлен или версия слишком старая, выберите способ установки ниже.

## Установите Node

<Tabs>
  <Tab title="macOS">
    **Homebrew** (рекомендуется):

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    brew install node
    ```

    Или скачайте установщик для macOS с [nodejs.org](https://nodejs.org/).
  </Tab>

  <Tab title="Linux">
    **Ubuntu / Debian:**

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
    sudo apt-get install -y nodejs
    ```

    **Fedora / RHEL:**

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    sudo dnf install nodejs
    ```

    Или используйте менеджер версий (см. ниже).
  </Tab>

  <Tab title="Windows">
    **winget** (рекомендуется):

    ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
    winget install OpenJS.NodeJS.LTS
    ```

    **Chocolatey:**

    ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
    choco install nodejs-lts
    ```

    Или скачайте установщик для Windows с [nodejs.org](https://nodejs.org/).
  </Tab>
</Tabs>

<Accordion title="Using a version manager (nvm, fnm, mise, asdf)">
  Менеджеры версий позволяют легко переключаться между версиями Node. Популярные варианты:

  * [**fnm**](https://github.com/Schniz/fnm) — быстрый, кроссплатформенный
  * [**nvm**](https://github.com/nvm-sh/nvm) — широко используется в macOS/Linux
  * [**mise**](https://mise.jdx.dev/) — многоязычный (Node, Python, Ruby и т. д.)

  Пример с fnm:

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  fnm install 24
  fnm use 24
  ```

  <Warning>
    Убедитесь, что ваш менеджер версий инициализируется в файле запуска оболочки (`~/.zshrc` или `~/.bashrc`). Если это не так, `openclaw` может не находиться в новых сеансах терминала, потому что PATH не будет включать каталог bin Node.
  </Warning>
</Accordion>

## Устранение неполадок

### `openclaw: command not found`

Это почти всегда означает, что глобальный каталог bin npm не находится в вашем PATH.

<Steps>
  <Step title="Find your global npm prefix">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    npm prefix -g
    ```
  </Step>

  <Step title="Check if it's on your PATH">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    echo "$PATH"
    ```

    Найдите в выводе `<npm-prefix>/bin` (macOS/Linux) или `<npm-prefix>` (Windows).
  </Step>

  <Step title="Add it to your shell startup file">
    <Tabs>
      <Tab title="macOS / Linux">
        Добавьте в `~/.zshrc` или `~/.bashrc`:

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        export PATH="$(npm prefix -g)/bin:$PATH"
        ```

        Затем откройте новый терминал (или выполните `rehash` в zsh / `hash -r` в bash).
      </Tab>

      <Tab title="Windows">
        Добавьте вывод `npm prefix -g` в системный PATH через Settings → System → Environment Variables.
      </Tab>
    </Tabs>
  </Step>
</Steps>

### Ошибки разрешений при `npm install -g` (Linux)

Если вы видите ошибки `EACCES`, переключите глобальный префикс npm на каталог, доступный пользователю для записи:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"
```

Добавьте строку `export PATH=...` в `~/.bashrc` или `~/.zshrc`, чтобы сделать изменение постоянным.

## Связанные материалы

* [Обзор установки](/ru/install) — все способы установки
* [Обновление](/ru/install/updating) — поддержание OpenClaw в актуальном состоянии
* [Начало работы](/ru/start/getting-started) — первые шаги после установки