Установка¶

Уже прошли Начало работы? Тогда всё готово — эта страница посвящена альтернативным способам установки, инструкциям для конкретных платформ и обслуживанию.

Системные требования¶

• Node 22+ (скрипт-установщик из раздела способы установки установит его при отсутствии)
• macOS, Linux или Windows
• pnpm — только при сборке из исходников

В Windows настоятельно рекомендуется запускать OpenClaw под WSL2.

Способы установки¶

Скрипт-установщик — рекомендуемый способ установки OpenClaw. Он выполняет обнаружение Node, установку и первичную настройку за один шаг.

Загружает CLI, устанавливает его глобально через npm и запускает мастер первичной настройки.

```
<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
  </Tab>
  <Tab title="Windows (PowerShell)">
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```
  </Tab>
</Tabs>

Готово — скрипт выполняет обнаружение Node, установку и первичную настройку.

Чтобы пропустить первичную настройку и просто установить бинарный файл:

<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
    ```
  </Tab>
  <Tab title="Windows (PowerShell)">
    ```powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
    ```
  </Tab>
</Tabs>

Все флаги, переменные окружения и варианты для CI/автоматизации см. в разделе [Внутреннее устройство установщика](/install/installer).
```

Если у вас уже есть Node 22+ и вы предпочитаете управлять установкой самостоятельно:

```
<Tabs>
  <Tab title="npm">
    ```bash
    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <Accordion title="Ошибки сборки sharp?">
      Если у вас глобально установлен libvips (часто на macOS через Homebrew) и `sharp` завершается с ошибкой, принудительно используйте предварительно собранные бинарные файлы:

      ```bash
      SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
      ```

      Если вы видите `sharp: Please add node-gyp to your dependencies`, установите инструменты сборки (macOS: Xcode CLT + `npm install -g node-gyp`) или используйте указанную выше переменную окружения.
    </Accordion>
  </Tab>
  <Tab title="pnpm">
    ```bash
    pnpm add -g openclaw@latest
    pnpm approve-builds -g        # approve openclaw, node-llama-cpp, sharp, etc.
    openclaw onboard --install-daemon
    ```

    <Note>
    pnpm требует явного подтверждения для пакетов со скриптами сборки. После того как первая установка покажет предупреждение «Ignored build scripts», выполните `pnpm approve-builds -g` и выберите перечисленные пакеты.
    </Note>
  </Tab>
</Tabs>
```

Для контрибьюторов или тех, кто хочет запускать из локального репозитория.

```
<Steps>
  <Step title="Клонировать и собрать">
    Клонируйте [репозиторий OpenClaw](https://github.com/openclaw/openclaw) и выполните сборку:

    ```bash
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    pnpm install
    pnpm ui:build
    pnpm build
    ```
  </Step>
  <Step title="Подключить CLI">
    Сделайте команду `openclaw` доступной глобально:

    ```bash
    pnpm link --global
    ```

    Либо пропустите связывание и запускайте команды через `pnpm openclaw ...` изнутри репозитория.
  </Step>
  <Step title="Запустить первичную настройку">
    ```bash
    openclaw onboard --install-daemon
    ```
  </Step>
</Steps>

Для более глубоких рабочих процессов разработки см. раздел [Настройка](/start/setup).
```

Другие способы установки¶

Контейнеризованные или headless-развёртывания. Декларативная установка через Nix. Автоматизированное развёртывание парка. Использование только CLI через рантайм Bun.

После установки¶

Проверьте, что всё работает:

openclaw doctor         # check for config issues
openclaw status         # gateway status
openclaw dashboard      # open the browser UI

If you need custom runtime paths, use:

• OPENCLAW_HOME for home-directory based internal paths
• OPENCLAW_STATE_DIR for mutable state location
• OPENCLAW_CONFIG_PATH for config file location

See Environment vars for precedence and full details.

Устранение неполадок: openclaw не найден¶

Быстрая диагностика:

node -v
npm -v
npm prefix -g
echo "$PATH"

Если $(npm prefix -g)/bin (macOS/Linux) или $(npm prefix -g) (Windows) отсутствует в вашем $PATH, оболочка не может найти глобальные бинарные файлы npm (включая openclaw).

Исправление — добавьте его в файл инициализации вашей оболочки (~/.zshrc или ~/.bashrc):

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

В Windows добавьте вывод команды npm prefix -g в PATH.

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

Обновление / удаление¶

Поддерживайте OpenClaw в актуальном состоянии. Перенос на новую машину. Полностью удалить OpenClaw.